Earthborne Rangers
Music Board
Adaptive music and map companion for Earthborne Rangers
Dear community
I made an Earthborne Rangers companion app focused on adaptive music and light session tracking. If you are interested, I would really appreciate it if you could test it and share feedback.
There are Windows, Linux, and Android releases. For a more lightweight version, and especially for macOS support, you can also find NeutralinoJS builds in the release folder, though I could not test the macOS builds myself.
Current status
This is an early community release (v0.8.2). Feedback, bug reports, and platform-specific testing are very welcome.
The app logs some processes (mainly music related) that can be seen from the Settings. When encountering bugs, you can send those to me :)
What is it?
First and foremost, this app is meant to make using sound and music easier while playing Earthborne Rangers. I love Tom Figgins' music and wanted it playing in the background during sessions, but after a while I found it slightly distracting when tracks did not match the game's current context.
So I started writing a small tool for myself that mapped OST tracks to appropriate contexts, using the individual track art as hints. Over time, it grew into something larger: I wanted to support custom music as well, which meant tracking more than just path types in the Valley and strata in the Arcology.
Earthborne Rangers Music Board is now a companion app with an interactive map, persistent session state, and adaptive music playback. It is meant to sit alongside your game while you play. It helps you keep track of where the Rangers are, what day it is, which weather card is active, and which campaign unlocks or special cards are currently relevant.
What you can do
- Import the official soundtrack for automatic music playback. Naturally, you need to own the music files locally.
- Add your own custom music and assign it to weather, locations, path types, and strata.
- Let the soundtrack adapt to the campaign, terrain, travel path, location, stratum, and weather.
- Choose a campaign: Lure of the Valley or Legacy of the Ancestors.
- Follow your ranger(s) on an interactive campaign map.
- Track the current location, day, weather, and special cards/unlocks during play.
- Save sessions and continue them later.
- Adjust campaign weather slots when needed.
What you can't do
- Use sound file formats other than
.ogg,.mp3, or supported.wavfiles. - Manage decks. There are already other apps for that.
- Manage campaign details beyond day, location, path type, weather, and unlock state.
- Use it for Spire in Bloom, Shadow of the Storm, or Into the Maw yet.
Music import note
Depending on the platform or build, music import may not support selecting an entire folder directly. In that case, please select multiple individual music files at once instead. Supported formats are .ogg, .mp3, and .wav.
For .wav, only Uncompressed Linear PCM (16-bit or 24-bit) or 32-bit IEEE Float is supported.
Screenshots/Videos
Adaptive music
After music is imported, the app can automatically choose tracks that fit the current campaign state. As you travel, enter new regions, change weather, or continue a session, the music board keeps the soundtrack aligned with the table state while trying to preserve musical continuity.
Official soundtrack files are recognized automatically as long as their filenames are unchanged from the official album releases. Their titles should usually suffice.
Custom music can be added separately and assigned to specific campaign context tags such as weather, locations, path types, or strata, allowing you to expand or personalize the atmosphere of a campaign.
Session support
Campaign sessions can be saved and resumed. The app remembers your current location, day, weather state, unlocks, music context, and campaign-specific weather changes so you can pick up where you left off.
Disclaimer
This project was built with help from a coding agent. I used it to speed up development and to work through parts of Godot that I am still learning. The design goals, testing, tuning, and final decisions are mine, but the implementation benefited significantly from AI-assisted coding.
Feedback
If you try the app and run into issues, or if you have suggestions, please use the GitLab tracker. You can also check the release notes for recent changes.