A tiny little module that adds a seek bar and the functionality to jump to a specific time in a track that is currently playing in the default VTT interface.
  • Shell 49.4%
  • JavaScript 41.8%
  • Makefile 5.8%
  • CSS 3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
g33z bca25a801a
All checks were successful
CI / check (push) Successful in 9s
Release / release (push) Successful in 19s
Release v1.1.1
2026-11-12 21:48:28 +01:00
.forgejo moving repository to forgejo; removing github stuff 2026-11-12 21:41:12 +01:00
docs adding some screenshots 2026-11-12 21:05:40 +01:00
lang adding jump input capability for hour long tracks 2026-11-12 20:57:03 +01:00
scripts adding jump input capability for hour long tracks 2026-11-12 20:57:03 +01:00
styles replace foundry timer visually, so our controls work; fixing scrub jumps 2026-11-12 20:20:42 +01:00
tools fixing foundry deployment for older jq version on ubuntu 24.04 2026-11-12 21:47:58 +01:00
.gitignore init 2026-11-12 20:10:48 +01:00
CHANGELOG.md Release v1.1.1 2026-11-12 21:48:28 +01:00
CLAUDE.md fixing foundry deployment for older jq version on ubuntu 24.04 2026-11-12 21:47:58 +01:00
Makefile fixing foundry deployment for older jq version on ubuntu 24.04 2026-11-12 21:47:58 +01:00
module.json Release v1.1.1 2026-11-12 21:48:28 +01:00
README.md fixing foundry deployment for older jq version on ubuntu 24.04 2026-11-12 21:47:58 +01:00

Scrub Music

Drag the bar to seek Click the time to jump to a typed time
Seek bar below a playing track in the Playlists sidebar Typing a time to jump to

A Foundry VTT v14 module that adds a seek bar to playing tracks in the Playlists sidebar, so the GM can jump to any position in a song. Players hear the jump too.

  • Drag the bar below a playing or paused track to seek.
  • Click the time next to it (e.g. 1:23 / 3:45), type a time (2:10, 1:30:21, 90:21 or 130 seconds) and press Enter to jump there. Escape cancels.
  • Only the GM sees the bar. Nothing else is added.

Install

In Foundry: Add-on Modules > Install Module, paste this manifest URL:

https://git.nrdblg.de/g33z/foundryvtt-scrub-music/releases/download/latest/module.json

Support

If you'd consider supporting me, I would be very grateful. Thank you very much!

Support me on Ko-fi

Development

make            # list targets
make link       # symlink this folder into Foundry's modules folder (FOUNDRY_DATA=... to override)
make check      # syntax-check scripts, validate JSON and translations
make build      # build dist/module.zip + dist/module.json locally
make foundry-dry-run  # check the foundryvtt.com release for the current version (asks for the token)
make foundry-publish  # publish the current version on foundryvtt.com by hand, if CI's step failed

Releases: add your changes under ## [Unreleased] in CHANGELOG.md, then

make release 0.1.0          # promotes the changelog, bumps module.json, commits and tags locally
git push origin main
git push origin v0.1.0      # the tag triggers the release: Forgejo release + foundryvtt.com

The release workflow publishes each version on foundryvtt.com via the Package Release API. It needs the package's release token (on the package's edit page on foundryvtt.com) as the repository secret FOUNDRY_RELEASE_TOKEN (Settings > Actions > Secrets). The token is never stored in the repository; without the secret, that step is skipped.

Macro / console: game.modules.get("scrub-music").api.seek(playlistSound, 90) seeks to 1:30.