Recipe for livestreaming over Tor
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。
 
 
 
 
n9k 022bebed73 v1.6.8 4ヶ月前
LICENSES Add licences 9ヶ月前
anonstream v1.6.8 4ヶ月前
doc Emotes: documentation 4ヶ月前
.gitignore Add venv/ to .gitignore 9ヶ月前
README.md Readme: typo 4ヶ月前
asgi.py Give `create_app` a dictionary, not a file location 6ヶ月前
config.toml Minor: increase default max_comment_lines from 12 to 20 4ヶ月前
emotes.json Emotes: documentation 4ヶ月前
requirements.txt Compress some responses 6ヶ月前
title.txt Get stream title from disk 9ヶ月前

README.md

anonstream

Recipe for livestreaming over Tor

Repo

The canonical location of this repo is https://git.076.ne.jp/ninya9k/anonstream.

These mirrors also exist:

Setup

You must have Python 3.10 at a minimum. You can check your version of Python with python --version.

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.txt in 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

Run it:

python -m anonstream

This will start a webserver listening on the local host at port 5051 (use --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 http://localhost:5051/login.

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.

Running

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 at asgi:create_app(). For example with uvicorn:

python -m uvicorn asgi:create_app --factory --port 5051

In either case you can explicitly set the location of the config file using the ANONSTREAM_CONFIG environment variable.

Hacking

anonstream has APIs for accessing internal state and hooking into internal events. They can be used by humans and other programs. See HACKING.md.

Copying

anonstream is AGPL 3.0 or later, see LICENSES/AGPL-3.0-or-later.md.

Assets

Dependencies