blob: 1d4dabf5cdda33a5b7adfb506d3936954cbf73e5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
# -*- mode: org; org-html-head-include-default-style: nil; org-html-postamble: nil; after-save-hook: org-md-export-to-markdown; -*-
#+OPTIONS: toc:nil num:nil
* Tubo
Tubo is a streaming front-end focused on bringing the [[https://github.com/TeamNewPipe/NewPipe][NewPipe]] experience to the web. It currently supports the same platforms as NewPipe, including YouTube, SoundCloud, and more.
To retrieve the data, it wraps the excellent [[https://github.com/TeamNewPipe/NewPipeExtractor][NewPipe Extractor]] library and exposes the extracted data over a REST API that is consumed by a local re-frame SPA.
** Try It Out
You can try a live demo at [[https://tubo.migalmoreno.com]]. If you consider self-hosting Tubo let me know about your instance via the [[*Contributing][contribution methods]]. See [[*Installation][installation]] for ways to set up Tubo in your server.
** Installation
*** Packaging
**** Uberjar
To bundle the whole project into a self-contained uber-jar you need to follow these build steps:
#+begin_src sh
npm i
npm run build
clojure -T:frontend:build uberjar
#+end_src
After the last command is completed, you'll get a path to the uber-jar, which you can run like this:
#+begin_src sh
java -jar target/tubo-<VERSION>.jar
#+end_src
**** Docker
Alternatively, you can use Docker to set up Tubo. Simply invoke this:
#+begin_src sh
docker-compose up -d
#+end_src
**** Manual
You can also set up Tubo manually via the [[https://guix.gnu.org/][GNU Guix]] package manager. First, download the necessary tooling:
#+begin_src sh
cd /path/to/tubo
guix shell
#+end_src
Then, compile the downloader ahead-of-time:
#+begin_src sh
clojure -M -e "(compile 'tubo.downloader-impl)"
#+end_src
Fetch the front-end dependencies and build the front-end assets.
#+begin_src sh
npm i
npm run build
#+end_src
Finally, compile the front-end.
#+begin_src sh
clojure -M:frontend release tubo
#+end_src
You can now start a local server that listens on port 3000 by running this:
#+begin_src sh
clojure -M:run
#+end_src
Access the front-end in your browser at =http://localhost:3000=.
*** Reverse Proxy
If you want to self-host Tubo and make it publicly accessible you'll need to set up a reverse proxy.
**** Nginx
#+begin_src nginx
server {
listen 443 ssl http2;
server_name tubo.<YOUR_DOMAIN>;
ssl_certificate /etc/letsencrypt/live/tubo.<YOUR_DOMAIN>/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/tubo.<YOUR_DOMAIN>/privkey.pem;
location / {
proxy_pass http://localhost:3000;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header HOST $http_host;
}
}
#+end_src
** Road-map
- [X] Basic audio player
- [ ] Track queuing system
- [ ] Playlists
- [ ] User settings
** Screenshots
[[https://files.migalmoreno.com/tubo_kiosk.jpg]]
[[https://files.migalmoreno.com/tubo_channel.jpg]]
[[https://files.migalmoreno.com/tubo_stream.jpg]]
** Contributing
Feel free to open an issue with bug reports or feature requests. PRs are more than welcome too.
|
