OpenSource-Hub
G

gonic

SHA-256
2.4k stars·System Optimization·SHA-256 checksum verified

Music streaming server implementing the Subsonic API, with support for many clients.

Smart Download

Download Download Version

v0.20.1 · 28.6 MB

A lightweight, self-hosted music streaming server compatible with Subsonic clients.

Core Features

  • Browse by folder preserving original directory structure
  • Browse by tags (MP3, FLAC, M4A, etc.)
  • On-the-fly audio transcoding and caching (requires ffmpeg)
  • Podcast support
  • Multi-user with individual playlists and preferences

What It Can't Do

  • Initial scan can be slow for large libraries; transcoding requires ffmpeg; HTTPS not enabled by default (use reverse proxy); Jukebox mode needs mpv configuration.

Use Cases

  • Host your own private music server accessible from any Subsonic client
  • Replace commercial streaming services and keep control of your music library

Detailed Introduction

Gonic is a free, lightweight music streaming server that implements the Subsonic API. It allows you to browse your music collection by folder or tags, transcode audio on the fly, manage podcasts, and support multiple users with individual preferences. Written in Go, it runs efficiently on low-power devices like Raspberry Pi. It integrates with Last.fm and ListenBrainz for scrobbling and artist info. The server includes a web interface for configuration and supports various clients including DSub, Symfonium, and Strawberry.

Troubleshooting & FAQ (1)

Troubleshooting
How to enable transcoding in gonic without a catch-all rule?

Update gonic to version 0.20 or later (master branch). The server now transcodes audio even if no server-side transcode preferences are set, as long as the client requests a maximum bitrate or format. For seeking in transcoded tracks, gonic supports the timeOffset parameter. Ensure your client (e.g., Symfonium) sends appropriate transcode requests.

GitHub Issue #633

Tags

musicstreamingsubsonicself-hostedgoserver

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Run via Docker: docker run -d -p 4747:4747 -v /path/to/music:/music -v /path/to/data:/data sentriz/gonic

4

Open http://your-ip:4747 in browser, login with admin/admin

5

Set music path in web UI and start scan; then connect with any Subsonic client

Install Guide
  1. Run via Docker: docker run -d -p 4747:4747 -v /path/to/music:/music -v /path/to/data:/data sentriz/gonic
  2. Open http://your-ip:4747 in browser, login with admin/admin
  3. Set music path in web UI and start scan; then connect with any Subsonic client
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

ab1607c34e2c8edff432ffcc557bfc28a0736fa1901a4ca9f4d24935aacccb1e

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Stop and remove the Docker container (if used), or delete the binary and data directory.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseGPL-3.0
Last Updated2026-06-27 08:35:09
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects