diff options
author | Miguel Ángel Moreno <mail@migalmoreno.com> | 2023-04-27 14:27:31 +0200 |
---|---|---|
committer | Miguel Ángel Moreno <mail@migalmoreno.com> | 2023-04-27 14:27:31 +0200 |
commit | 2736bd1d72ec942e2c4e14b239ce63eea3533333 (patch) | |
tree | fdfb7fd699569dd80b690e623dfe4f8494d888c8 | |
parent | 65eb28f1043e0f76feaadbfa55688816c84c3e98 (diff) |
doc: Add Markdown version of README
-rw-r--r-- | README.md | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..b0eee65 --- /dev/null +++ b/README.md @@ -0,0 +1,63 @@ + + +# Tubo + +Tubo is an alternative web front-end to various streaming sites. It aims to free users from the world of ad-ridden streaming sites by providing a distraction-free interface to consume content from. It currently supports the following platforms: + +- YouTube +- SoundCloud +- media.ccc.de +- PeerTube +- Bandcamp + +To retrieve the data, it leverages the excellent [NewPipe Extractor](https://github.com/TeamNewPipe/NewPipeExtractor) library that powers the popular [NewPipe](https://github.com/TeamNewPipe/NewPipe) Android app. Tubo exposes the extracted data over a REST API that is consumed by a local re-frame SPA. + +The ultimate goal behind Tubo is to replicate the Newpipe experience on the web, so that it's accessible to those that don't use an Android device. + + +## Installation + +The easiest way to set up Tubo's dependencies is via the [GNU Guix](https://guix.gnu.org/) package manager. Simply invoke what follows: + + cd /path/to/tubo + guix shell + +To run the application, first compile the downloader ahead-of-time. + + clojure -M -e "(compile 'tubo.downloader-impl)" + +Fetch the front-end dependencies and build the front-end assets. + + npm i + npm run build + +Then, compile the front-end. + + clojure -M:frontend compile tubo + +You can now start a local server that listens on port 3000 by running the following: + + clojure -M:run + +Access the front-end in your browser at `http://localhost:3000`. + + +## Road-map + +- [X] Basic audio player +- [ ] Track queuing system +- [ ] Playlists +- [ ] User settings + + +## Screenshots + +![img](https://files.mianmoreno.com/tubo_kiosk.jpg) +![img](https://files.mianmoreno.com/tubo_channel.jpg) +![img](https://files.mianmoreno.com/tubo_stream.jpg) + + +## Contributing + +You can use the project's [mailing list](https://lists.sr.ht/~mmoreno/tubo) to send feedback, patches or open discussions. Bugs should be reported on the project's [bug-tracker](https://todo.sr.ht/~mmoreno/tubo). + |