# SEMusicBoxMaker
SEMusicBoxMaker is a desktop tool for creating compatible Space Engineers music pack mods for **NordVader Synced Music Player**.
It prepares music libraries in the required format with artists, albums, tracks, sound definitions, duration metadata, library metadata, Steam Workshop description text, and a proper `thumb.jpg` thumbnail.
## Download
Download SEMusicBoxMaker:
https://drive.google.com/drive/folders/11ynTOdRlLuaxjjmFnsQigWcDJ6CytrLk?usp=sharing
## What the tool does
— Music Pack Creation — Creates local Space Engineers music pack mods.
— Artist / Album / Track Structure — Organizes music as `Audio / Artist / Album / Track.xwm`.
— Smart Track Naming — Removes the artist name from track titles when importing files like `Artist — Song.mp3`.
— Metadata Provider — Generates artist, album, title, and duration metadata for NordVader Synced Music Player.
— Sound Definitions — Creates or updates Space Engineers sound definitions.
— Drag and Drop Import — Accepts files and folders directly in the tool window.
— Inline Rename — Allows double-click rename for tracks, albums, and folders.
— Bulk Rename — Supports find/replace, prefix, suffix, numbering, and artist-prefix cleanup.
— Workshop Description Generator — Generates copy-ready Steam Workshop descriptions for music packs.
— Thumbnail Setup — Sets or converts a `thumb.jpg` image for the mod.
— Existing Pack Maintenance — Refreshes metadata and reorganizes existing packs.
## Why a special music pack format is required
NordVader Synced Music Player does not simply read random Space Engineers sound mods as full music libraries.
A compatible music pack must include:
— audio files in a game-supported format, usually `.xwm`
— Space Engineers sound definitions
— stable `SoundId` values
— artist metadata
— album metadata
— track title metadata
— track duration metadata
— correct file paths
— optional Workshop description and thumbnail
Without this metadata, the player may detect some sounds, but artist/album browsing, duration display, and reliable playlist behavior may not work correctly.
## Recommended workflow
1. Create a new music pack.
2. Enable `Organize as Artist / Album / Track`.
3. Import audio files or folders.
4. Check `Artist`, `Album`, `Title`, `SoundName`, and `New Audio Path`.
5. Rename or bulk-rename tracks if needed.
6. Import the music into the pack.
7. Run `Write / Refresh Track Durations + Provider`.
8. Set `thumb.jpg`.
9. Open the Workshop tab.
10. Copy or save the generated Workshop description.
11. Test the music pack in Space Engineers together with NordVader Synced Music Player.
12. Publish or update the mod in Steam Workshop.
## Importing music
Supported input patterns:
«`text
Artist — Track.mp3
Artist — Track.wav
Artist/Album/Track.mp3
Artist/Album/Track.wav
«`
If audio metadata exists, the tool can use:
— Artist
— Album
— Title
If metadata is missing, the tool tries to infer the values from filenames and folders.
Example:
«`text
Kino — Gruppa krovi.mp3
«`
becomes:
«`text
Artist: Kino
Title: Gruppa krovi
SoundName: Gruppa krovi
«`
The artist name is kept as artist metadata, not duplicated inside the track title.
## Rename tools
Use inline rename for small edits:
— Double-click an item to rename it.
— Press Enter to apply.
— Press Escape to cancel.
Use Bulk Rename for larger cleanup:
— Find / Replace
— Prefix
— Suffix
— Numbering
— Remove artist prefix
Example:
«`text
Artist — Song
«`
becomes:
«`text
Song
«`
## Required metadata refresh
After importing or changing music, always run:
«`text
Write / Refresh Track Durations + Provider
«`
Run it after:
— adding new tracks
— deleting tracks
— renaming tracks
— changing Artist or Album
— moving tracks between albums
— reorganizing an existing music pack
## Thumbnail
Space Engineers expects the mod preview image in the root of the mod as:
«`text
thumb.jpg
«`
Use `Set thumb.jpg` in SEMusicBoxMaker.
Recommended size:
«`text
1024×1024
«`
## Related pages
— [NordVader Synced Music Player](../nordvader-synced-music-player/)
— [Music Pack Format](../music-pack-format/)
— [Publishing Music Packs](../publishing-music-packs/)
— [Building SEMusicBoxMaker](../building-semusicboxmaker/)
— [Troubleshooting](../troubleshooting/)