SimpleerTube

Active Known Instances:

• https://simpleertube.metalune.xyz

If you want to add your instance to this list, message us on IRC (#simple-web on irc.libera.chat).

For the rest of the documentation, https://simpleertube.metalune.xyz will be used as an example instance.

If you want to visit any page from your PeerTube instance of choice in SimpleerTube, just prepend https://simpleertube.metalune.xyz to the URL. So, https://videos.lukesmith.xyz/accounts/luke becomes https://simpleertube.metalune.xyz/videos.lukesmith.xyz/accounts/luke.

If you visit the main page, you can search globally (it uses Sepia Search in the backend).

Setup

You need to setup a few dependencies first, usually using pip (sudo apt install python3-pip on Debian):

$ sudo pip3 install quart bs4 html2text lxml

Note: If there are other dependencies that are not packaged with your system, please report them to us so they can be added to this README.

Now you can run a development environment like so:

$ python3 main.py # Starts on localhost:5000
$ python3 main.py 192.168.42.2 # Starts on 192.168.42.2:5000
$ python3 main.py 7171 # Starts on localhost:7171
$ python3 main.py 192.168.42.2 7171 # Starts on 192.168.42.2:7171
$ python3 main.py ::1 7171 # Also works with IPv6 addresses

It is strongly disrecommended to run the production using this command. Instead, please refer to the Quart deployment docs.

TODO

• Federation errors (eg. name not resolving) are not handled properly, producing bloaty tracebacks server side and unfriendly errors client side
• Expects to run in the webroot, not in a subdirectory
• Relies on search.joinpeertube.org API, while we should be able to configure a different SepiaSearch instance

License

This software is distributed under the AGPLv3 license. You can find a copy in the LICENSE file.