starkayc/orpheusmorebetter repository overview

⁠Orpheusmorebetter Docker

A Dockerized version of Orpheusmorebetter⁠, built on python3.13-alpine3.23⁠ image.

📦 Available on Docker Hub⁠ and GHCR⁠.

⁠📥 Installation (Recommended)

1. Create compose.yaml:

services:
  orpheusmorebetter:
    image: starkayc/orpheusmorebetter
    container_name: orpheusmorebetter
    #command: "-t totp" # For 2FA code
    volumes:
      - ./config:/config/.orpheusmorebetter # Directory where your config are stored.
      - ./data:/data # Directory where your source FLACs, transcodes and torrents are stored.

1. Create folders:

mkdir config data

1. Run the container:

docker compose up -d

1. Check Logs:

docker logs -f orpheusmorebetter

⁠🛠️ Manual Build (Optional)

If you prefer building the image yourself:

1. Download Dockerfile:

wget https://raw.githubusercontent.com/starkayc/docker-orpheusmorebetter/refs/heads/main/Dockerfile

1. Build the image:

docker build -t orpheusmorebetter .

1. Create folders:

mkdir config data

1. Run the container:

docker run \
  --name orpheusmorebetter \
  -v "$PWD/config:/config/.orpheusmorebetter" \
  -v "$PWD/data:/data" \
  orpheusmorebetter

1. Check Logs:

docker logs -f orpheusmorebetter

⁠📥 Configuration

1. Edit config file at config/config:

[orpheus]
username = username
password = password
data_dir = /data/raw
output_dir = /data/transcodes
torrent_dir = /data/torrents
formats = flac, v0, 320
media = cd, vinyl, web
24bit_behaviour = 0
tracker = https://home.opsfet.ch/
mode = both
api = https://orpheus.network/
source = OPS

1. What Settings Do:

username and password are your Orpheus login credentials.

data_dir is the directory where your source FLACs are stored.

output_dir is the directory where your transcodes will be stored after creation. If the value is blank, data_dir will be used. You may also specify per format values such as output_dir_320 or output_dir_v0, and orpheusmorebetter will redirect the outputs to the associated directory.

torrent_dir is the directory where the torrents associated with your transcodes will be created (i.e., your watch directory). Same per format settings as output_dir apply.

formats is a list of formats that you'd like to support. (If you don't want to upload V2, or any other specific format, just remove it from this list)

media is a list of lossless media types you want to consider for transcoding. The default value is all What.CD lossless formats, but if you want to transcode only CD and vinyl media, for example, you would set this to cd, vinyl.

24bit_behaviour defines what happens when the program encounters a FLAC that it thinks is 24bits. If it is set to '2', every FLAC that has a bits- per-sample property of 24 will be silently re-categorized. If it set to '1', a prompt will appear. The default is '0' which ignores these occurrences.

tracker is the base announce url to use in the torrent files.

api is the base url to use for API requests.

mode selects which list of torrents orpheusmorebetter will use to search for candidates. One of:

• snatched - Your snatched torrents.
• uploaded - Your uploaded torrents.
• both - Your uploaded and snatched torrents.
• seeding - Better.php for your seeding torrents.
• all - All transcode sources above.
• none - Disable scraping.

source is the source flag to add to created torrents. Leave blank if you are running mktorrent 1.0.

To transcode and upload a specific release:

• Make sure the source FLAC is already in your data_dir.
• If your URL contains &, either escape it (\&) or wrap the URL in quotes.

# Full URL (escaped ampersand)
orpheusmorebetter https://orpheus.network/torrents.php?id=1000\&torrentid=1000000#torrent1000000
orpheusmorebetter https://orpheus.network/torrents.php?id=1000\&torrentid=1000000

# Query-only form (escaped ampersand)
orpheusmorebetter ?id=1000\&torrentid=1000000

# Quoted URL (no escaping needed)
orpheusmorebetter "https://orpheus.network/torrents.php?id=1000&torrentid=1000000#torrent1000000"
orpheusmorebetter "https://orpheus.network/torrents.php?id=1000&torrentid=1000000"
orpheusmorebetter "?id=1000&torrentid=1000000"

⁠📎 Resources

• Base Image: python3.13-alpine3.23⁠
• Orpheusmorebetter: walkrflocka/orpheusmorebetter⁠