selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Octo-Fiesta logo

Self-host Octo-Fiesta

v0.11

Subsonic proxy bridging streaming services into Navidrome

BetaOpen SourceGPL-3.0
Updated2 months ago
LanguageC#
Setup difficultyModerate
Stars
899
Port
8080 (Internal HTTP listening port (INTERNAL_PORT; docker-compose maps host port 5274 to it))
Docker
ghcr.io/v1ck3s/octo-fiesta
Install with Docker Compose

What is Octo-Fiesta?

Octo-Fiesta is a Subsonic API proxy that sits between your Subsonic clients and a music server such as Navidrome. When a requested song is missing from the local library, it searches a configured streaming provider (Deezer by default, also Qobuz, Tidal and Yandex Music), streams the track, downloads it into the library, and registers it for future plays. Downloads keep hi-res FLAC quality up to 24-bit/192kHz, embed full ID3 tags and cover art, follow a configurable Artist/Album/Track folder template, and can pick up time-synced lyrics from LRCLIB. Starring an external playlist triggers a bulk download and generates an M3U file. The proxy is deployed with Docker Compose using a .env file for provider credentials, or run manually with the .NET 9.0 SDK. Provider tokens expire and must be refreshed periodically, and because the project is still pre-1.0 (v0.x releases), expect some churn — the deprecated SquidWTF backend may be dropped in a future release.

Should you self-host Octo-Fiesta?

Octo-Fiesta scores 56/100 on selfhost.directory (how scoring works) and ranks #16 of 59 in Music Streaming. It has 899 GitHub stars, +48 in the last 30 days.

It shipped 11 stable releases in the past year. The latest, v0.11, came out on 2 September 2026. New versions land roughly every 3 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in C#.

Its closest alternative on selfhost.directory is koel (74/100, 17 336 stars). It scores higher overall, so compare the two before you pick. See Octo-Fiesta vs koel side by side.

Features

  • Automatic download and caching
  • Automatic quality upgrade
  • Customizable folder layout
  • Explicit content filtering
  • External playlist download with M3U generation
  • Hi-Res audio (up to 24-bit/192kHz FLAC)
  • Metadata and cover art embedding
  • Multi-provider music sourcing
  • Subsonic API proxy
  • Synced lyrics

Octo-Fiesta README

Octo-Fiesta

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

Why "Octo-Fiesta"?

The name was randomly generated by GitHub when creating the repository. We found it amusing and somewhat fitting for a music application. After all, "fiesta" evokes a party atmosphere, which goes well with music streaming. So we kept it!

How to install Octo-Fiesta

Install Octo-Fiesta with Docker Compose

Docker and Docker Compose (recommended)

Clone the repository

git clone https://github.com/V1ck3s/octo-fiesta.git cd octo-fiesta

Configure

cp .env.example .env

Start

docker-compose up -d

Proxy then listens on port 5274; point your Subsonic client there instead of Navidrome.

How to configure Octo-Fiesta

  • SUBSONIC_URLhttp://localhost:4533Navidrome/Subsonic server URL
  • MUSIC_SERVICEDeezerMusic service to use: Deezer, Qobuz, Tidal, Yandex, or SquidWTF (deprecated) (default: Deezer)
  • DOWNLOAD_PATH./downloadsPath where downloaded songs will be stored on the host (only applies if STORAGE_MODE=Permanent)
  • ENABLE_EXTERNAL_PLAYLISTStrue===== GENERAL SETTINGS ===== External playlists support (optional, default: true) When enabled, allows searching and downloading playlists from Deezer/Qobuz Starring a playlist triggers automatic download of all tracks and creates an M3U file
  • PLAYLISTS_DIRECTORYplaylistsPlaylists directory name (optional, default: playlists) M3U playlist files will be created in {DOWNLOAD_PATH}/{PLAYLISTS_DIRECTORY}/

Octo-Fiesta releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Music Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…