Musikat

Overview

A modern web application that allows users to search for songs on Spotify and automatically download them from YouTube, then seamlessly add them to your Navidrome music server. Perfect for building your personal music library with proper metadata, album art, and organized file structure.

Requirements

        Requires a `config.json` file to be mounted at `/app/config.json` before starting the container. See configuration details: https://github.com/soggy8/music-downloader/blob/main/config.json


        Requires a number of JSON files to be created on the host system BEFORE the container is started. These files can be created with the `touch` command.

Runtime arguments

Web UI: http://[IP]:[PORT:8000]/
Network: bridge
Privileged: false

Template configuration

Web UI PortPorttcp

Container Port: 8000

Target: 8000
Default: 8000
Value: 8000

Navidrome Music PathPath

Path to your Navidrome music folder

Target: /music

Temp Downloads PathPath

Path to temporary downloads folder

Target: /app/downloads
Default: /mnt/user/appdata/music_downloader/downloads
Value: /mnt/user/appdata/music-downloader/downloads

YouTube Cookies PathPathro

Path to your YouTube cookies file

Target: /app/youtube_cookies.txt
Default: /mnt/user/appdata/music_downloader/youtube_cookies.txt
Value: /mnt/user/appdata/music-downloader/youtube_cookies.txt

Navidrome - URLVariable

URL to your Navidrome server

Target: NAVIDROME_API_URL
Default: http://IP_ADDRESS:4533
Value: http://IP_ADDRESS:4533

Navidrome - Admin UsernameVariable

Your Navidrome admin username

Target: NAVIDROME_USERNAME

Navidrome - Admin PasswordVariable

Your Navidrome admin password

Target: NAVIDROME_PASSWORD

Navidrome - Enable SyncVariable

Periodically scan Navidrome path and mark matching catalog tracks as downloaded

Target: NAVIDROME_SYNC_ENABLED
Default: false|true

Spotify - Client IDVariable

Your Spotify Client ID

Target: SPOTIFY_CLIENT_ID

Spotify - Client SecretVariable

Your Spotify Client Secret

Target: SPOTIFY_CLIENT_SECRET

Spotify - Redirect URIVariable

Your Spotify Redirect URI

Target: SPOTIFY_REDIRECT_URI
Default: http://localhost:8000/callback
Value: http://localhost:8000/callback

Music FormatVariable

Desired music format for downloads

Target: OUTPUT_FORMAT
Default: mp3
Value: mp3

Music QualityVariable

Desired audio quality in kbps

Target: AUDIO_QUALITY
Default: 128
Value: 128

Navidrome - Sync Interval (Hours)Variable

Interval in hours for syncing with Navidrome

Target: NAVIDROME_SYNC_INTERVAL_HOURS
Default: 4
Value: 4

Navidrome - Sync Initial Delay (Seconds)Variable

Initial delay in seconds before first sync with Navidrome

Target: NAVIDROME_SYNC_INITIAL_DELAY_SEC
Default: 120
Value: 120

Navidrome - Sync API Delay (Seconds)Variable

Delay in seconds between API calls during Navidrome sync

Target: NAVIDROME_SYNC_API_DELAY_SEC
Default: 0.12
Value: 0.12

Internal HostVariable

Internal host for the web server. Not recommended to change.

Target: API_HOST
Default: 0.0.0.0
Value: 0.0.0.0

Internal PortVariable

Internal port for the web server. Not recommended to change.

Target: API_PORT
Default: 8000
Value: 8000

Internal Music PathVariable

Internal path to your Navidrome music folder. Not recommended to change.

Target: NAVIDROME_MUSIC_PATH
Default: /music
Value: /music

Internal YouTube Cookies PathVariable

Internal path to your YouTube cookies file. Not recommended to change.

Target: YOUTUBE_COOKIES_PATH
Default: /app/youtube_cookies.txt
Value: /app/youtube_cookies.txt

CORS OriginsVariable

Comma-separated list of allowed CORS origins

Target: CORS_ORIGINS
Default: http://localhost:3000,http://127.0.0.1:3000
Value: http://localhost:3000,http://127.0.0.1:3000

Links

Template Support GHCR Project

Details

Repository

ghcr.io/soggy8/musikat:latest

Registry

https://registry.hub.docker.com/r/ghcr.io/soggy8/musikat

Last Updated2026-06-02

First Seen2026-03-29

Run Musikat on Unraid.

Musikat is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS