Private BitTorrent tracker, designed from the ground up for music. Fixes some of the annoyances with, and improves upon some of the features of, extant tracker software (such as Gazelle). Under heavy development.
Multiple artists with the same name all get different pages, owing to a well-typed separation between:
- artists (who may have any contributory relationship to a release group: such as "composer", "producer", "main", and so on)
- release groups (the abstract concept of an release that groups specific releases together, and that many artists may contribute to)
- releases (specific pressings of an album: special editions, alternate editions, and so on)
- torrents (an encode of a release)
The upload page is dynamic. Typing in the name of an artist brings up an autocomplete function, which allows one to select from a list of pre-existing release groups and releases for said artist.
Torrents can be uploaded from any page, with the relevant details filled in on the upload page. For example:
- One can click "Upload Release Group" on an artist's page, to skip the artist part of the upload page, and directly add a new release group to the artist, a new release to the release group, and torrent to the release.
- One can click "Upload Release" on a release group's page, to skip the artist and release group part of the upload page, and directly add a new release to the release group and torrent to the release.
- 🟩 Robust database schema
- 🟩 Search
- 🟩 With autocomplete
- 🟨 Advanced search with filters
- 🟩 metainfo uploading
- 🟩 metainfo downloading
- 🟩 bittorrent announce
- 🟩 Authentication with passkey
- 🟩 Progressive upload page
- 🟩 Fields can be autocompleted by searching for an artist or album
- 🟩 Fields can be autocompleted by clicking "upload here" on an artist/release group/release page
- 🟩 Artist pages
- 🟩 Release group pages
- 🟩 Release pages
- 🟩 Torrent pages
- 🟨 WebTorrent support
- 🟨 Ability to stream an album
- 🟨 Ability to stream album art (maybe?)
- 🟩 Forum
- 🟩 Users
- 🟩 User biography
- 🟨 User avatar
- 🟩 User inbox/messaging system
- 🟩 Latest downloads/uploads
- 🟧 Downloads/uploads list
- 🟧 Download/upload totals and ratio
- 🟨 Current seeding list
- 🟩 Permissions system
- 🟨 User classes
- 🟩 User settings page
- 🟨 Requests
- 🟨 Bounties
- 🟨 Subscribing to requests (for a notification when it is fulfilled)
- 🟨 Linking relevant requests on artist/release group/release pages
- 🟩 News
- 🟨 Torrent subscription system (for a notification when an artist/release group/release has a new torrent)
- Python >=3.11
- Docker
- (development) Fish Shell
- (development) Sass
Code is 100% type annotated and checked. Formatting is done with black/isort.
- If not running python 3.11, install pyenv.
- Install poetry.
- Run
poetry installfrom the repository directory to set up a virtual environment with the necessary python version and packages. - Run
fish scripts/installgithooks.fishto install the appropriate git hooks.
- Start Postgres:
docker-compose --profile development up -d - Start Sass:
sass -w static/css/ - Create migrations:
poetry run python3 manage.py makemigrations - Apply migrations:
poetry run python3 manage.py migrate - Create the default user groups:
poetry run python3 manage.py create_user_groups - Create the default forum categories:
poetry run python3 manage.py create_forum_categories - Create a super user account:
poetry run python3 manage.py createsuperuser - Run the server:
poetry run python3 manage.py runserver
poetry run python3 manage.py test
poetry run mypy .
docker-compose up
MIT License. See LICENSE.md. Credits and licenses for images can be found in CREDITS.md.