docs: drop TagLib/pkg-config build deps, bump Go/Node versions#385
Merged
Conversation
TagLib is now a pure-Go WASM binding (go.senan.xyz/taglib), so building from source no longer needs a system TagLib library or pkg-config. The Makefile's check_env validates only Go and Node. - Remove TagLib install steps from build-from-source and dev-environment - Remove pkg-config step from dev-environment - Bump Go to 1.26+ and Node to 24 to match go.mod and .nvmrc
Preview Deployment
Built from cae95f8 |
There was a problem hiding this comment.
Pull request overview
Updates Navidrome’s documentation to reflect the removal of TagLib/pkg-config build dependencies after switching to a pure-Go tag reader, and aligns stated toolchain requirements with current Go/Node versions.
Changes:
- Removed TagLib and
pkg-configinstallation steps from build-from-source and dev-environment docs. - Bumped documented Go requirement to 1.26+ and refreshed Node requirement wording.
- Renumbered the Unix dev environment setup steps accordingly.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| content/en/docs/installation/build-from-source.md | Updates prerequisites (Go/Node) and removes TagLib build dependency instructions. |
| content/en/docs/developers/dev-environment.md | Removes TagLib/pkg-config setup steps and updates Go version requirement for local dev. |
Comment on lines
+21
to
24
| First, you will need to install [Go 1.26+](https://golang.org/doc/install) and | ||
| [Node 24](https://nodejs.org/en/download). The setup is very strict, and the steps below only work with | ||
| these versions (enforced in the Makefile). Make sure to add `$GOPATH/bin` to your `PATH` as described | ||
| in the [official Go site](https://golang.org/doc/gopath_code.html#GOPATH) |
Comment on lines
+30
to
32
| 6. Create a `navidrome.toml` config file in the project's folder with ([at least](/docs/usage/configuration/options/#available-options)) the following options: | ||
| ```toml | ||
| # Set your music folder, preferable a specific development music library with few songs, |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Navidrome now reads tags via
go.senan.xyz/taglib, a pure-Go WASM (wazero) binding. As a result, building from source no longer requires a system TagLib library orpkg-config— the Makefile'scheck_envvalidates only Go and Node.These docs were still telling people to install TagLib and
pkg-config, and listed stale Go/Node versions.Changes
installation/build-from-source.mddevelopers/dev-environment.mdpkg-configsteps; renumber the listNotes
go.mod(Go 1.26) and.nvmrc(v24).faq/_index.mdandpersistent-ids.mdare left untouched: they describe the library's runtime behavior (how metadata is read), not an install step.