Octo-Fiesta

Octo-Fiesta

Docker app from grtgbln's Repository

Overview

A Subsonic API proxy server that transparently integrates Deezer as a music source. When a song is not available in your local Navidrome library, it is automatically fetched from Deezer, downloaded, and served to your Subsonic-compatible client. The downloaded song is then added to your library, making it available locally for future listens.

Requirements


        Requires a Deezer account and a separate Subsonic-compatible server.
    

Runtime arguments

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

Template configuration

Web UI PortPorttcp

Container Port: 8080

Target
8080
Default
5274
Value
5274
Subsonic - ServiceVariable

The Subsonic-compatible music service to use (e.g. Deezer, Qobuz, SquidWTF)

Target
Subsonic__MusicService
Default
SquidWTF
Value
SquidWTF
Subsonic - URLVariable

The URL of your Subsonic server

Target
Subsonic__Url
Default
http://IP_ADDRESS:4533
Value
http://IP_ADDRESS:4533
Subsonic - Admin UsernameVariable

Admin username to perform actions on Navidrome server that require admin permissions

Target
SUBSONIC_ADMIN_USERNAME
Subsonic - Admin PasswordVariable

Admin password to perform actions on Navidrome server that require admin permissions

Target
SUBSONIC_ADMIN_PASSWORD
Subsonic - Download ModeVariable

Determines whether to download individual tracks or entire albums when a track is requested.

Target
Subsonic__DownloadMode
Default
Track|Album
Explicit FilterVariable

Filter songs based on explicit content.

Target
Subsonic__ExplicitFilter
Default
All|ExplicitOnly|CleanOnly
Auto-UpgradeVariable

Re-download tracks when higher quality is available

Target
Subsonic__AutoUpgradeQuality
Default
false|true
Folder TemplateVariable

Folder template for organizing downloaded files.

Target
Subsonic__FolderTemplate
Default
{artist}/{album}/{track} - {title}}
Value
{artist}/{album}/{track} - {title}}
Deezer - ARL TokenVariable

Your Deezer ARL token for accessing Deezer content

Target
Deezer__Arl
Deezer - ARL Token FallbackVariable

Fallback Deezer ARL token if the primary one fails

Target
Deezer__ArlFallback
Deezer - QualityVariable

Preferred audio quality for Deezer downloads. Remove to default to highest.

Target
Deezer__Quality
Default
FLAC|MP3_320|MP3_128
Qobuz - User Auth TokenVariable

Your Qobuz user authentication token for accessing Qobuz content

Target
Qobuz__UserAuthToken
Qobuz - User IDVariable

Your Qobuz user ID

Target
Qobuz__UserId
Qobuz - QualityVariable

Preferred audio quality for Qobuz downloads (e.g. FLAC, FLAC_24_HIGH, FLAC_24_LOW, FLAC_16, MP3_320)

Target
Qobuz__Quality
SquidWTF - SourceVariable

The backend source to use for SquidWTF downloads

Target
SquidWTF__Source
Default
Qobuz|Tidal
SquidWTF - QualityVariable

Preferred audio quality for SquidWTF downloads. Qobuz: 27 (FLAC 24-bit), 7 (FLAC 16-bit), 6 (MP3 320), 5 (MP3 128). Tidal: HI_RES_LOSSLESS, LOSSLESS

Target
SquidWTF__Quality
SquidWTF - TimeoutVariable

Number of seconds to wait for a response from the SquidWTF instance before timing out.

Target
SquidWTF__InstanceTimeoutSeconds
Default
5
Value
5
Yandex - OAuth TokenVariable

OAuth token for API access.

Target
Yandex__OAuthToken
Yandex - QualityVariable

Preferred audio quality for Yandex downloads.

Target
Yandex__Quality
Default
FLAC|AAC_64|MP3_192|AAC_192|AAC_256|MP3_320
Yandex - LanguageVariable

Language for the API responses. Curated playlists and some album titles will be translated into that language.

Target
Yandex__Language
Default
ru
Value
ru
Yandex - Include Unavailable TracksVariable

Allow show tracks in search results, playlists and albums that are marked unavailable for listening

Target
IncludeUnavilable
Default
false|true
Playlist SupportVariable

When enabled, allows searching and downloading playlists. Starring a playlist triggers automatic download of all tracks and creates an M3U file

Target
Subsonic__EnableExternalPlaylists
Default
true|false
Downloads PathPath

Path to store downloaded files

Target
/app/downloads
Default
/mnt/user/appdata/octo_fiesta/downloads
Value
/mnt/user/appdata/octo_fiesta/downloads
Playlists FolderVariable

M3U playlist files will be created in {DOWNLOAD_PATH}/{PLAYLISTS_DIRECTORY}/

Target
Subsonic__PlaylistsDirectory
Default
playlists
Value
playlists
Internal Downloads PathVariable

Internal path to downloaded files. Not recommended to change.

Target
Library__DownloadPath
Default
/app/downloads
Value
/app/downloads
App EnvironmentVariable

Set the ASP.NET Core environment. Not recommended to change.

Target
ASPNETCORE_ENVIRONMENT
Default
Production
Value
Production
Storage ModeVariable

Set the storage mode for downloaded files.

Target
Subsonic__StorageMode
Default
Permanent|Temporary
Value
Permanent
Cache Duration (Hours)Variable

Duration in hours to cache files if using Temporary storage mode.

Target
Subsonic__CacheDurationHours
Default
1
Value
1
Internal PortVariable

Internal port. Not recommended to change.

Target
INTERNAL_PORT
Default
8080
Value
8080

Details

Repository
ghcr.io/v1ck3s/octo-fiesta:latest
Last Updated2026-05-31
First Seen2026-01-03

Run Octo-Fiesta on Unraid.

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