Recipe for livestreaming over Tor
The canonical location of this repo is https://git.076.ne.jp/ninya9k/anonstream.
These mirrors also exist:
You must have Python 3.10 at a minimum. You can check your version of
Clone the repo:
git clone https://git.076.ne.jp/ninya9k/anonstream.git cd anonstream
Install dependencies in a virtual environment:
python -m venv venv source venv/bin/activate python -m pip install -r requirements.txt
This is all the setup needed to run the application, but before you do you may want to edit the config. Most of the defaults are probably okay, but here are some that you might want to know what they do:
secret_key: used for cryptography, make it any long random string (e.g.
$ dd if=/dev/urandom bs=16 count=1 | base64), definitely set this yourself before running in "production"
segments/directory: directory containing stream segments, the default is
stream/in the cloned repository
title/file: location of the stream title, the default is
title.txtin the cloned repository
captcha/fonts: locations of fonts for the captcha, leaving it blank will use the default font
access/captcha: if true, users must complete a captcha before accessing the site proper
python -m anonstream
This will start a webserver listening on the local host at port 5051
--port PORT to override).
If you go to
http://localhost:5051 in a web browser now you should see
the site. When you started the webserver some credentials were printed
in the terminal; you can log in with those at
The only things left are (1) streaming, and (2) letting other people access your stream. OBS.md has instructions for setting up OBS Studio and ONIONSITE.md has instructions for creating a Tor onion service. If you want to use different streaming software and put your stream on the Internet some other way, read those instructions and copy the gist.
Start anonstream like this:
python -m anonstream
The default port is 5051. Append
--help to see options.
If you want to use a different ASGI server, point it to the app factory
asgi:create_app(). For example with
python -m uvicorn asgi:create_app --factory --port 5051
In either case you can explicitly set the location of the config file
ANONSTREAM_CONFIG environment variable.
anonstream has APIs for accessing internal state and hooking into internal events. They can be used by humans and other programs. See HACKING.md.
anonstream is AGPL 3.0 or later, see LICENSES/AGPL-3.0-or-later.md.