Skip to content

Document console sound formats (SPC, VGM, VGZ, GYM) in the Jukebox page - #165

Merged
gantoine merged 1 commit into
mainfrom
claude/jukebox-chiptune-formats
Oct 4, 2026
Merged

gantoine merged 1 commit into
mainfrom
claude/jukebox-chiptune-formats

Conversation

@sdornan

@sdornan sdornan commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

Adds the four single-song console sound formats from rommapp/romm#5079 to docs/using/jukebox.md.

Don't merge until a romm release that includes rommapp/romm#5079 ships. The docs are versioned with mike. #5079 merged to master but hasn't been released yet.

  • Lists .spc, .vgm, .vgz and .gym after the existing formats. Notes that they play in the browser through game-music-emu, that multi-song formats (.nsf, .gbs) aren't supported, and that .rsn SPC sets need extracting first.
  • After the tag-scanning paragraph, notes that these files aren't read for tags yet. They show their filename and have no catalog duration, which keeps them out of Free Radio and Decade Mix. Media keys and lock-screen controls also don't work while one plays.
  • Adds 03 - Wind Scene.spc to the example tree, so readers see the formats can share a folder.

folder-structure.md, glossary.md and uploads.md mention soundtrack/ only generically, so they're unchanged. The "complete rescan for files already on disk" caveat belongs in the romm release notes, not here.

Checks

  • uv run mkdocs build --strict passes.
  • trunk check couldn't download its plugins in the authoring environment (HTTP 403). The same linters ran directly instead: prettier 3.5.2 and markdownlint-cli 0.45.0 with the repo's .trunk/configs, plus git diff --check. All clean.

🤖 Generated with Claude Code

https://claude.ai/code/session_01RYuuiD5sUCyKqJ5AP1jZcU

List SPC, VGM, VGZ and GYM as soundtrack formats, note that they play
through game-music-emu, and cover their current limits (no tags or
catalog duration, no media keys). Adds an .spc line to the example tree.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RYuuiD5sUCyKqJ5AP1jZcU
@sdornan
sdornan marked this pull request as ready for review October 3, 2026 17:09
Copilot AI balanced review requested due to automatic review settings October 3, 2026 17:09

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

Although #5079 is now merged, a maintainer must confirm its release has shipped before merging these versioned docs.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Updates the Jukebox guide for console soundtrack support introduced by rommapp/romm#5079.

Changes:

  • Documents SPC, VGM, VGZ and GYM playback and archive extraction.
  • Explains metadata, radio and media-control limitations.
  • Adds an SPC track to the folder example.
File Description
docs/​using/​jukebox.md Adds console format guidance, limitations and a mixed-format example.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/using/jukebox.md
@gantoine
gantoine merged commit fe016fa into main Oct 4, 2026
5 checks passed
@gantoine
gantoine deleted the claude/jukebox-chiptune-formats branch October 4, 2026 14:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants