[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/grilix/gonic/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","grilix","reponame","gonic","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2022-02-24T05:35:39.9455Z","description","","is_private","last_updated","2022-02-24T16:03:08.607615Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",277,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

FLOSS alternative to subsonic, supporting its many clients

\n \n \n \n \n

\n\n

\n libera.chat #gonic\n

\n\n## features\n\n- browsing by folder (keeping your full tree intact) [see here](#directory-structure) \n- browsing by tags (using [taglib](https://taglib.org/) - supports mp3, opus, flac, ape, m4a, wav, etc.) \n- on-the-fly audio transcoding and caching (requires [ffmpeg](https://ffmpeg.org/)) (thank you [spijet](https://github.com/spijet/)) \n- jukebox mode (thank you [lxea](https://github.com/lxea/)) \n- support for per-user podcasts (thank you [lxea](https://github.com/lxea/)) \n- pretty fast scanning (with my library of ~27k tracks, initial scan takes about 10m, and about 5s after incrementally) \n- multiple users, each with their own transcoding preferences, playlists, top tracks, top artists, etc. \n- [last.fm](https://www.last.fm/) scrobbling \n- [listenbrainz](https://listenbrainz.org/) scrobbling (thank you [spezifisch](https://github.com/spezifisch), [lxea](https://github.com/lxea))\n- artist similarities and biographies from the last.fm api \n- multiple genre support (see `GONIC_GENRE_SPLIT` to split tag strings on a character, eg. `;`, and browse them individually) \n- a web interface for configuration (set up last.fm, manage users, start scans, etc.) \n- support for the [album-artist](https://mkoby.com/2007/02/18/artist-versus-album-artist/) tag, to not clutter your artist list with compilation album appearances \n- written in [go](https://golang.org/), so lightweight and suitable for a raspberry pi, etc. (see ARM images below) \n- newer salt and token auth \n- tested on [dsub](https://f-droid.org/en/packages/github.daneren2005.dsub/), [jamstash](http://jamstash.com/), [sublime music](https://gitlab.com/sublime-music/sublime-music/), [soundwaves](https://apps.apple.com/us/app/soundwaves/id736139596), and [stmp](https://github.com/wildeyedskies/stmp) \n\n\n## installation\n\nthe default login is **admin**/**admin**. \npassword can then be changed from the web interface\n\n### ...from source\n\n```bash\n$ apt install build-essential git sqlite libtag1-dev ffmpeg libasound-dev # for debian like\n$ pacman -S base-devel git sqlite taglib ffmpeg alsa-lib # for arch like\n$ go install go.senan.xyz/gonic/cmd/gonic@latest\n$ export PATH=$PATH:$HOME/go/bin\n$ gonic -h # or see \"configuration options below\"\n```\n\n**note:** unfortunately if you do this above, you'll be compiling gonic locally on your machine\n(if someone knows how I can statically link sqlite3 and taglib, please let me know so I can distribute static binaries) \n\n### ...with docker\n\nthe image is available on dockerhub as [sentriz/gonic](https://hub.docker.com/r/sentriz/gonic) \n\navailable architectures are\n- `linux/amd64`\n- `linux/arm/v6`\n- `linux/arm/v7`\n- `linux/arm64`\n\n```yaml\n# example docker-compose.yml\n\nversion: '2.4'\nservices:\n gonic:\n image: sentriz/gonic:latest\n environment:\n - TZ\n # optionally, see more env vars below\n expose:\n - 80\n volumes:\n - ./data:/data # gonic db etc\n - /path/to/music:/music:ro # your music\n - /path/to/podcasts:/podcasts # your podcasts\n - /path/to/cache:/cache # transcode / covers / etc cache dir\n\n # set the following two sections if you've enabled jukebox\n group_add:\n - audio\n devices:\n - /dev/snd:/dev/snd\n```\n\nthen start with `docker-compose up -d`\n\n### ...with systemd\n\ntested on Ubuntu 21.04\n\n1. install **go 1.16 or newer**, check version, and install dependencies\n\n```shell\n$ sudo apt update\n$ sudo apt install golang\n\n$ go version\ngo version go1.16.2 linux/amd64\n\n$ sudo apt install build-essential git sqlite libtag1-dev ffmpeg libasound-dev\n```\n\n2. install / compile gonic globally, and check version\n\n```shell\n$ sudo GOBIN=/usr/local/bin go install go.senan.xyz/gonic/cmd/gonic@latest\n\n$ gonic -version\nv0.14.0\n```\n\n3. add a gonic user, create a data directory, and install a config file\n\n```shell\n$ sudo adduser --system --no-create-home --group gonic\n$ sudo mkdir -p /var/lib/gonic/ /etc/gonic/\n$ sudo chown -R gonic:gonic /var/lib/gonic/\n$ sudo wget https://raw.githubusercontent.com/sentriz/gonic/master/contrib/config -O /etc/gonic/config\n```\n\n4. update the config with your `music-path`, `podcast-path`, etc\n\n```shell\n$ sudo nano /etc/gonic/config\nmusic-path \npodcast-path \ncache-path \n```\n\n5. install the systemd service, check status or logs\n\n```shell\n$ sudo wget https://raw.githubusercontent.com/sentriz/gonic/master/contrib/gonic.service -O /etc/systemd/system/gonic.service\n$ sudo systemctl daemon-reload\n$ sudo systemctl enable --now gonic\n\n$ systemctl status gonic # check status, should be active (running)\n$ journalctl --follow --unit gonic # check logs\n```\n\nshould be installed and running on boot now 👍 \nview the admin UI at http://localhost:4747\n\n### ...elsewhere\n\n[![](https://repology.org/badge/vertical-allrepos/gonic.svg)](https://repology.org/project/gonic/versions)\n\n## configuration options\n\n|env var|command line arg|description|\n|---|---|---|\n|`GONIC_MUSIC_PATH`|`-music-path`|path to your music collection (see also multi-folder support below)|\n|`GONIC_PODCAST_PATH`|`-podcast-path`|path to a podcasts directory|\n|`GONIC_CACHE_PATH`|`-cache-path`|path to store audio transcodes, covers, etc|\n|`GONIC_DB_PATH`|`-db-path`|**optional** path to database file|\n|`GONIC_LISTEN_ADDR`|`-listen-addr`|**optional** host and port to listen on (eg. `0.0.0.0:4747`, `127.0.0.1:4747`) (*default* `0.0.0.0:4747`)|\n|`GONIC_PROXY_PREFIX`|`-proxy-prefix`|**optional** url path prefix to use if behind reverse proxy. eg `/gonic` (see example configs below)|\n|`GONIC_SCAN_INTERVAL`|`-scan-interval`|**optional** interval (in minutes) to check for new music (automatic scanning disabled if omitted)|\n|`GONIC_JUKEBOX_ENABLED`|`-jukebox-enabled`|**optional** whether the subsonic [jukebox api](https://airsonic.github.io/docs/jukebox/) should be enabled|\n|`GONIC_GENRE_SPLIT`|`-genre-split`|**optional** a string or character to split genre tags on for multi-genre support (eg. `;`)|\n\n## screenshots\n\n||||||\n|:-:|:-:|:-:|:-:|:-:|\n![](https://raw.githubusercontent.com/sentriz/gonic/master/.github/scrot_1.png)|![](https://raw.githubusercontent.com/sentriz/gonic/master/.github/scrot_2.png)|![](https://raw.githubusercontent.com/sentriz/gonic/master/.github/scrot_3.png)|![](https://raw.githubusercontent.com/sentriz/gonic/master/.github/scrot_4.png)|![](https://raw.githubusercontent.com/sentriz/gonic/master/.github/scrot_5.png)|\n\n## multiple folders support (v0.15+)\n\ngonic supports multiple music folders. this can be handy if you have your music separated by albums, compilations, singles. or maybe 70s, 80s, 90s. whatever. \n\nif you're running gonic with the command line, stack the `-music-path` arg\n```shell\n$ gonic -music-path /path/to/albums -music-path /path/to/compilations\n```\n\nif you're running gonic with ENV_VARS, or docker, try separate with a comma\n```shell\nGONIC_MUSIC_PATH=/path/to/albums,/path/to/compilations\n```\n\nif you're running gonic with the config file, you can repeat the `music-path` option\n```shell\nmusic-path /path/to/albums\nmusic-path /path/to/compilations\n```\n\nafter that, most subsonic clients should allow you to select which music folder to use. \nqueries like show me \"recently played compilations\" or \"recently added albums\" are possible for example. \n\n## example nginx config with `GONIC_PROXY_PREFIX`\n\n```nginx\n location /gonic/ {\n proxy_pass http://localhost:4747/;\n # set \"Secure\" cookie if using HTTPS\n proxy_cookie_path / \"/; Secure\";\n # set \"X-Forwarded-Host\" header for last.fm connection callback\n proxy_set_header X-Forwarded-Host $host;\n }\n```\n\n## directory structure\n\nwhen browsing by folder, any arbitrary and nested folder layout is supported, with the following caveats: \n- Files from the same album must all be in the same folder\n- All files in a folder must be from the same album\n\nplease see [here](https://github.com/sentriz/gonic/issues/89) for more context \n\n```\nmusic\n├── drum and bass\n│ └── Photek\n│ └── (1997) Modus Operandi\n│ ├── 01.10 The Hidden Camera.flac\n│ ├── 02.10 Smoke Rings.flac\n│ ├── 03.10 Minotaur.flac\n│ └── folder.jpg\n└── experimental\n └── Alan Vega\n ├── (1980) Alan Vega\n │ ├── 01.08 Jukebox Babe.flac\n │ ├── 02.08 Fireball.flac\n │ ├── 03.08 Kung Foo Cowboy.flac\n │ └── folder.jpg\n └── (1990) Deuce Avenue\n ├── 01.13 Body Bop Jive.flac\n ├── 02.13 Sneaker Gun Fire.flac\n ├── 03.13 Jab Gee.flac\n └── folder.jpg\n```\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",96410401,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",7298,"full_size",43800845,"id",194109520,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:c0bb92c8306e74c257c755113f86a9b04ddff39eb0feb8004e3d00b2c3ef5a87","features","last_pulled","2026-08-28T22:22:59.977470657Z","last_pushed","2022-02-24T16:03:09Z","os","linux","os_features","os_version","size","variant","2022-02-24T16:03:08.488501Z","last_updater","last_updater_username","media_type","public-playlists","repository",16536578,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":60,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[151],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

grilix/gonic

Tags for grilix/gonic