Programming language: Go
License: GNU General Public License v3.0 only
Tags: Media Streaming     Audio Streaming    
Latest version: v0.13.1

gonic alternatives and similar software solutions

Based on the "Audio Streaming" category.
Alternatively, view gonic alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of gonic or a related project?

Add another 'Audio Streaming' Software solution


FLOSS alternative to subsonic, supporting its many clients


  • browsing by folder (keeping your full tree intact) see here
  • browsing by tags (using taglib - supports mp3, opus, flac, ape, m4a, wav, etc.)
  • on-the-fly audio transcoding and caching (requires ffmpeg) (thank you spijet)
  • jukebox mode (thank you lxea)
  • support for per-user podcasts (thank you lxea)
  • pretty fast scanning (with my library of ~27k tracks, initial scan takes about 10m, and about 5s after incrementally)
  • multiple users, each with their own transcoding preferences, playlists, top tracks, top artists, etc.
  • last.fm scrobbling
  • listenbrainz scrobbling (thank you spezifisch, lxea)
  • artist similarities and biographies from the last.fm api
  • multiple genre support (see GONIC_GENRE_SPLIT to split tag strings on a character, eg. ;, and browse them individually)
  • a web interface for configuration (set up last.fm, manage users, start scans, etc.)
  • support for the album-artist tag, to not clutter your artist list with compilation album appearances
  • written in go, so lightweight and suitable for a raspberry pi, etc. (see ARM images below)
  • newer salt and token auth
  • tested on dsub, jamstash, sublime music, soundwaves, and stmp


the default login is admin/admin.
password can then be changed from the web interface

...from source

$ apt install build-essential git sqlite libtag1-dev ffmpeg libasound-dev # for debian like
$ pacman -S base-devel git sqlite taglib ffmpeg alsa-lib                  # for arch like
$ go get go.senan.xyz/gonic/cmd/gonic
$ export PATH=$PATH:$HOME/go/bin
$ gonic -h # or see "configuration options below"

note: unfortunately if you do this above, you'll be compiling gonic locally on your machine (if someone knows how I can statically link sqlite3 and taglib, please let me know so I can distribute static binaries)

...with docker

the image is available on dockerhub as sentriz/gonic

available architectures are

  • linux/amd64
  • linux/arm/v6
  • linux/arm/v7
  • linux/arm64
# example docker-compose.yml

version: '2.4'
    image: sentriz/gonic:latest
    - TZ
    # optionally, see more env vars below
    - 80
    - ./data:/data                # gonic db etc
    - /path/to/music:/music:ro    # your music
    - /path/to/podcasts:/podcasts # your podcasts
    - /path/to/cache:/cache       # transcode / covers / etc cache dir

    # set the following two sections if you've enabled jukebox
    - audio
    - /dev/snd:/dev/snd

then start with docker-compose up -d

...with systemd

tested on Ubuntu 21.04

  1. install go 1.16 or newer, check version, and install dependencies
$ sudo apt update
$ sudo apt install golang

$ go version
go version go1.16.2 linux/amd64

$ sudo apt install build-essential git sqlite libtag1-dev ffmpeg libasound-dev
  1. install / compile gonic globally, and check version
$ sudo GOBIN=/usr/local/bin go install go.senan.xyz/gonic/cmd/[email protected]

$ gonic -version
  1. add a gonic user, create a data directory, and install a config file
$ sudo adduser --system --no-create-home --group gonic
$ sudo mkdir -p /var/lib/gonic/ /etc/gonic/
$ sudo chown -R gonic:gonic /var/lib/gonic/
$ sudo wget https://raw.githubusercontent.com/sentriz/gonic/master/contrib/config -O /etc/gonic/config
  1. update the config with your music-path, podcast-path, etc
$ sudo nano /etc/gonic/config
music-path        <path to your music dir>
podcast-path      <path to your podcasts dir>
cache-path        <path to cache dir>
  1. install the systemd service, check status or logs
$ sudo wget https://raw.githubusercontent.com/sentriz/gonic/master/contrib/gonic.service -O /etc/systemd/system/gonic.service
$ sudo systemctl daemon-reload
$ sudo systemctl enable --now gonic

$ systemctl status gonic            # check status, should be active (running)
$ journalctl --follow --unit gonic  # check logs

should be installed and running on boot now πŸ‘
view the admin UI at http://localhost:4747


configuration options

env var command line arg description
GONIC_MUSIC_PATH -music-path path to your music collection
GONIC_PODCAST_PATH -podcast-path path to a podcasts directory
GONIC_CACHE_PATH -cache-path path to store audio transcodes, covers, etc
GONIC_DB_PATH -db-path optional path to database file
GONIC_LISTEN_ADDR -listen-addr optional host and port to listen on (eg., (default
GONIC_PROXY_PREFIX -proxy-prefix optional url path prefix to use if behind reverse proxy. eg /gonic (see example configs below)
GONIC_SCAN_INTERVAL -scan-interval optional interval (in minutes) to check for new music (automatic scanning disabled if omitted)
GONIC_JUKEBOX_ENABLED -jukebox-enabled optional whether the subsonic jukebox api should be enabled
GONIC_GENRE_SPLIT -genre-split optional a string or character to split genre tags on for multi-genre support (eg. ;)


example nginx config with GONIC_PROXY_PREFIX

  location /gonic/ {
      proxy_pass http://localhost:4747/;
      # set "Secure" cookie if using HTTPS
      proxy_cookie_path / "/; Secure";
      # set "X-Forwarded-Host" header for last.fm connection callback
      proxy_set_header X-Forwarded-Host $host;

directory structure

when browsing by folder, any arbitrary and nested folder layout is supported. with one exception: albums must be contained in a single folder

please see here for more context

β”œβ”€β”€ drum and bass
β”‚Β Β  └── Photek
β”‚Β Β      └── (1997) Modus Operandi
β”‚Β Β          β”œβ”€β”€ 01.10 The Hidden Camera.flac
β”‚Β Β          β”œβ”€β”€ 02.10 Smoke Rings.flac
β”‚Β Β          β”œβ”€β”€ 03.10 Minotaur.flac
β”‚Β Β          └── folder.jpg
└── experimental
    └── Alan Vega
        β”œβ”€β”€ (1980) Alan Vega
        β”‚Β Β  β”œβ”€β”€ 01.08 Jukebox Babe.flac
        β”‚Β Β  β”œβ”€β”€ 02.08 Fireball.flac
        β”‚Β Β  β”œβ”€β”€ 03.08 Kung Foo Cowboy.flac
        β”‚Β Β  └── folder.jpg
        └── (1990) Deuce Avenue
            β”œβ”€β”€ 01.13 Body Bop Jive.flac
            β”œβ”€β”€ 02.13 Sneaker Gun Fire.flac
            β”œβ”€β”€ 03.13 Jab Gee.flac
            └── folder.jpg