RepoPilot

sentriz/gonic

music streaming server / free-software subsonic server API implementation

Mixed

Single-maintainer risk — review before adopting

ConcernsDependency

copyleft license (GPL-3.0) — review compatibility; top contributor handles 90% of recent commits

HealthyFork & modify

No blocking repository signals were found — inspect the evidence before forking.

HealthyLearn from

Documented and popular — useful reference codebase to read through.

MixedDeploy as-is

Scorecard "Branch-Protection" is 0/10; Scorecard "Token-Permissions" is 0/10

  • ⚠Single-maintainer risk — top contributor 90% of recent commits
  • ⚠GPL-3.0 is copyleft — check downstream compatibility
  • ⚠Scorecard: default branch unprotected (0/10)
  • ⚠1 moderate-severity advisory on direct dependencies
  • ✓Last commit 2d ago
  • ✓9 active contributors
  • ✓GPL-3.0 licensed
  • ✓CI configured
  • ✓Tests present

What would improve this?

  • •Use as dependency Concerns to Mixed if: relicense under MIT/Apache-2.0 (rare for established libs)
  • •Deploy as-is Mixed to Healthy if: bring "Branch-Protection" to ≥3/10 (see scorecard report)

Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

Informational only. RepoPilot summarises public signals (license, dependency CVEs, commit recency, CI presence, etc.) at the time of analysis. Signals can be incomplete or stale. Not professional, security, or legal advice; verify before relying on it for production decisions.

Repository brief

Repo brief: sentriz/gonic

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T14:52:53.051Z · commit 8df10c3aa8cd

Verdict

Mixed — Single-maintainer risk — review before adopting

  • Last commit 2d ago
  • 9 active contributors
  • GPL-3.0 licensed
  • CI configured
  • 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Gonic is a free-software Subsonic API server implementation written in Go that streams music from a local library. It scans and indexes music files (MP3, FLAC, Opus, M4A, WAV via taglib), serves them to Subsonic-compatible clients, and supports on-the-fly transcoding via FFmpeg. It acts as a drop-in replacement for Subsonic, enabling self-hosted music streaming without proprietary server software. Monolithic Go application with modular subsystems: cmd/gonic/ is the entry point, db/ handles SQLite persistence via GORM and migrations, handlerutil/ provides HTTP handler utilities, infocache/ caches album/artist metadata, jukebox/ manages server-side playback via MPD, lastfm/ integrates…

Start here

  • cmd/gonic/gonic.go: Main entry point; router setup and HTTP server initialization for all Subsonic API handlers
  • db/db.go: Core data models (User, Album, Artist, Track, Playlist) and database queries using GORM; business logic hub
  • db/migrations.go: SQLite schema definitions and gormigrate-based migrations; tracks schema evolution
  • fileutil/fileutil.go: Library scanning logic: directory traversal, tag extraction via taglib, incremental update logic
  • cache/cache.go: Transcoding orchestration: spawns FFmpeg processes, caches encoded output, implements transcoding preferences per user

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone: git clone https://github.com/sentriz/gonic.git && cd gonic. Install: go mod download (Go 1.26.0+ required per go.mod). Verify: go test ./... to run tests. Run: See 'howToRun' section below. Note: FFmpeg bin…

Daily commands:

After go mod download, build with go build -o gonic ./cmd/gonic or run directly with go run ./cmd/gonic/gonic.go. No Makefile visible, so use go build conventions. Server will listen on a configured port (defaul…

…shortened for this brief.

Key cautions & unknowns

  • Single-maintainer risk — top contributor 90% of recent commits
  • GPL-3.0 is copyleft — check downstream compatibility
  • Scorecard: default branch unprotected (0/10)
  • FFmpeg binary must be installed on the host (not a Go dependency); transcoding will silently fail if absent. GORM v1 (deprecated since 2021) carries ongoing maintenance burden and may not work with future SQLite schema…
  • Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

For the complete agent context, use the CLAUDE.md or Cursor rules export.

Save as

Full context for agent files, or a concise PDF for human review.

View complete agent reference

Open to load every section of the agent reference.

Want this for your own repo?

Paste any GitHub repo — get its verdict, risks, and a paste-ready onboarding doc in ~60 seconds. Free, no sign-up.

Embed the "Forkable" badge

Paste into your README — live-updates from the latest cached analysis.

Variant:
RepoPilot: Forkable
[![RepoPilot: Forkable](https://repopilot.app/api/badge/sentriz/gonic?axis=fork)](https://repopilot.app/r/sentriz/gonic)

Paste at the top of your README.md — renders inline like a shields.io badge.

▸Preview social card

This card auto-renders when someone shares https://repopilot.app/r/sentriz/gonic on X, Slack, or LinkedIn.

Ask AI about sentriz/gonic

Grounded in the actual source code. Pick a starter question or write your own.

What does this repo do, in one paragraph?How would I get started using it?What are the main alternatives?Show me the entry point.
Or write your own question

Featured in lists

Curated shortlists that include this repo.

Embed this chat in your README

Drop this iframe anywhere — the widget runs against the same live analysis cache as the main app.

<iframe
  src="https://repopilot.app/embed/sentriz/gonic"
  width="100%" height="500"
  style="border:1px solid #d0d7de; border-radius:8px;"
  allow="microphone"
  loading="lazy"
></iframe>