ChartHound

⚠ ACTION REQUIRED — SECRET KEY NOT SET

ChartHound is running but connection saving is disabled until you set a real SECRET_KEY.
Open your docker-compose.yml and replace CHANGE_ME_GENERATE_A_STRONG_RANDOM_KEY with a real key.

How to fix it in 4 steps:
1. Run this command for your OS to generate a key:
  Linux/Mac/Unraid/TrueNAS/Proxmox: python3 -c "import secrets; print(secrets.token_hex(32))"
  Windows PowerShell: python -c "import secrets; print(secrets.token_hex(32))"
  Synology/QNAP: docker run --rm python:3.12-slim python3 -c "import secrets; print(secrets.token_hex(32))"
2. Copy the result and paste it into docker-compose.yml replacing CHANGE_ME...
3. Save the file then restart: docker compose down && docker compose up -d
4. Refresh this page — the warning disappears and full functionality unlocks.

🐕 WELCOME TO CHARTHOUND

Two quick setup steps. Connect all services anytime in The Kennel after setup.

SECRET
KEY

MUSIC
PATH

READY!

ChartHound encrypts all your API tokens and passwords. To do this it needs a SECRET_KEY — a long random password only you know.

Run the command for your OS below, copy the result, then paste it into your docker-compose.yml where it says CHANGE_ME_GENERATE_A_STRONG_RANDOM_KEY. Then restart the container and click Next.

Linux

Mac

Windows (PS)

Windows (CMD)

Synology

QNAP

Unraid

TrueNAS

Proxmox

python3 -c "import secrets; print(secrets.token_hex(32))"

⚠ Never share your SECRET_KEY or docker-compose.yml after filling it in. Treat it like a master password.

After pasting your key into docker-compose.yml:
1. Save the file
2. Run: docker compose down && docker compose up -d
3. Come back here and click Next

ChartHound needs to translate your media server's file paths to the Docker /music mount so it can tag your physical files.

You should have already set the volume path in docker-compose.yml before running the container. This step tells ChartHound how the two paths relate.

EXAMPLE — HOW PATH TRANSLATION WORKS:

Media server sees: /media/colby/NAS1/MUSIC TAGGED/ABBA/Gold/Dancing Queen.flac

Docker sees: /music/ABBA/Gold/Dancing Queen.flac

The gold part stays the same — only the prefix changes. Your prefix is everything before the artist folder.

Media Server Path Prefix

Everything before the artist folder in your media server file paths

Docker Music Mount

Usually /music — only change if you edited the volume line in docker-compose.yml

Test your path (optional)

Enter a path above to preview the translation.

🐕

YOU'RE READY!

ChartHound is ready to go.

Head to The Kennel to connect Plex, Emby, Jellyfin, Last.fm, Prowlarr, Radarr, Sonarr, your download client and YouTube.

Then run The Retriever to start tagging your music library with chart data.

NAVIGATION

🔑

THE KENNEL

Connections & encrypted API vault

🏷

THE RETRIEVER

Write metadata to physical files

📡

THE SNIFFER

Find missing chart hits & grab them

✂️

THE GROOMER

Build playlists from what you own

🔍

THE BLOODHOUND

Hunt every album by any artist

🎯

THE TRACKER

Radarr/Sonarr missing & cutoff hunter

▶

THE SCOUT

YouTube playlist creator

🎬

THE LOOKOUT

Local music video manager

⟳ —

v1.0.0 · MILESTONE 4

VAULT STATUS

Plex

NOT VERIFIED

Emby

NOT VERIFIED

Jellyfin

NOT VERIFIED

Last.fm

NOT VERIFIED

Prowlarr

NOT VERIFIED

Radarr

NOT VERIFIED

Sonarr

NOT VERIFIED

Download Client

NOT VERIFIED

YouTube

NOT VERIFIED

PATH TRANSLATOR

Media Server Path Prefix

Docker Music Mount

Preview a Path

Enter a path above to preview.

SECURITY

🔐 Fernet (AES-128-CBC) encryption before SQLite write.
🔒 /register locked after first user.
🚫 Tokens never returned to the browser.
⟳ Heartbeat re-checks connections every 60s.
🐕 buymeacoffee.com/colbycurtis

API CONNECTIONS — THE VAULT

Save credentials first (encrypted immediately on save), then TEST to verify the live connection. On Linux Docker use your server's LAN IP — not localhost.

🟧 PLEX MEDIA SERVER

NOT VERIFIED

Server URL

Use your server's LAN IP — e.g. http://192.168.50.42:32400 · Default port: 32400

X-Plex-Token

Find yours: Plex Settings → Troubleshooting → Show XML → copy from URL bar

🟩 EMBY

NOT VERIFIED

Server URL

Default port: 8096 — use your server's LAN IP

API Key

Find yours: Emby Dashboard → API Keys → create new

User ID

Find yours: Emby Dashboard → Users → click your name → copy ID from URL bar

🟦 JELLYFIN

NOT VERIFIED

Server URL

Use the port you access Jellyfin on in your browser · If 503 error: add 172.28.0.0/16 to Jellyfin LAN Networks

API Key

Find yours: Jellyfin Dashboard → API Keys → create new

User ID

Find yours: Jellyfin Dashboard → Users → click your name

🔴 LAST.FM

NOT VERIFIED

API Key

Free at last.fm/api/account/create — no credit card · no URL needed

Tertiary waterfall source — mood tags and chart keyword detection. Strongly recommended for best metadata quality.

🟣 PROWLARR

NOT VERIFIED

Server URL

Default port: 9696

API Key

Find yours: Prowlarr → Settings → General → API Key

🎬 RADARR

NOT VERIFIED

Server URL

Default port: 7878 — used by The Tracker

API Key

Find yours: Radarr → Settings → General → API Key

📺 SONARR

NOT VERIFIED

Server URL

Default port: 8989 — used by The Tracker

API Key

Find yours: Sonarr → Settings → General → API Key

⬇ DOWNLOAD CLIENT

NOT VERIFIED

Used by The Sniffer, Bloodhound and Tracker. Grabs are tagged with ChartHound-Music / ChartHound-Movies / ChartHound-TV categories so your media server picks them up automatically.

Client Type

Server URL

qBittorrent: :8080 · Deluge: :8112 · Transmission: :9091

Username

Password

▶ YOUTUBE

NOT VERIFIED

Used by The Scout to create and push playlists to your YouTube account. Free tier: 10,000 units/day.

API Key

Get yours free at console.cloud.google.com — enable YouTube Data API v3 · no URL needed

SCAN SCOPE

FULL LIBRARY

SUBFOLDER

MODE

👁 PREVIEW

⚡ AUTO-PILOT

Preview mode shows proposed vs current metadata. You approve before anything is written to your files.

BATCH SIZE

Tracks per chunk

5 (safer) 50 (faster)

CONTROLS

MAINTENANCE

Clears SQLite cache. Next scan fetches fresh data from MusicBrainz, iTunes and Last.fm.

SCAN PROGRESS

READY TO SCAN

Configure options and click Start Scan

TOTAL

PROCESSED

MATCHED

FAILED

CACHED

SCAN LOG

ChartHound Retriever ready. Configure options above and start a scan.

📡

THE SNIFFER

CHART-HIT FINDER & GRABBER

Hot 100 · Adult Pop · UK · CCM · Gospel · Rock · R&B · 15+ charts.
Finds what's missing from your library · Searches via Prowlarr.
Pushes grabs with ChartHound-Music category.
Builds and pushes playlists to Plex · Emby · Jellyfin.

MILESTONE 5

✂️

THE GROOMER

PLAYLIST BUILDER

Build playlists from tracks you already own.
Filter by chart · genre · era · peak position · mood.
Push directly to Plex · Emby · Jellyfin.

MILESTONE 6

🔍

THE BLOODHOUND

ARTIST & ALBUM HUNTER

Search any artist — get every album from MusicBrainz.
Select what you want · Search via Prowlarr.
Background monitoring for new releases via APScheduler.

MILESTONE 7

🎯

THE TRACKER

RADARR / SONARR HUNTER

Hunts missing movies and TV episodes automatically.
Reads Radarr and Sonarr want lists · Searches via Prowlarr.
ChartHound-Movies and ChartHound-TV categories.
Scheduled background hunting — runs while browser is closed.

MILESTONE 8

▶

THE SCOUT

YOUTUBE PLAYLIST CREATOR

Search YouTube by chart · genre · artist.
Build YouTube playlists and push to your account.
YouTube API credentials stored encrypted in The Kennel.

MILESTONE 9

🎬

THE LOOKOUT

LOCAL MUSIC VIDEO MANAGER

Scan your server's music video collection.
Filter by quality · artist · genre · chart.
Build MV playlists and push to Plex · Emby · Jellyfin.

MILESTONE 10