RimTunes | Bring your music to RimWorld!

🎵 RimTunes

Your colony. Your soundtrack.

Import your own music, create playlists, tag songs for different situations, and choose between manual playback or a dynamic soundtrack that reacts to your colony.

Two Ways to Play

Choose a mode on first launch and change it anytime in Settings.

• Dynamic Music System - RimTunes selects music to fit your colony's current situation.
• Manual Mode - Full control over playlists, song order, shuffle, repeat, and playback.

Both modes include: custom music import, playlists, song tags, hotkeys, volume normalization, smooth transitions, and the mini-player overlay.

Dynamic Music System

Turn your library into a living RimWorld soundtrack. Tag songs for specific conditions and let RimTunes select suitable tracks automatically.

• Danger - Tense music during raids and combat, calmer music when danger passes
• Time of day - Daytime, nighttime, and custom time ranges
• Weather - Rain, snow, fog, toxic fallout, and more
• Seasons - Spring, summer, fall, and winter
• Game conditions - Map-wide events and conditions, including supported mod content
• Biomes - Deserts, forests, ice sheets, tropical maps, and more
• Royal titles - Optional Royalty DLC integration

RimTunes avoids recently played tracks, supports smooth transitions, and can use either your whole library or one selected playlist.

Example: Tag a song as Peaceful + Night + Winter for quiet snowy evenings, then forbid it during danger so it never plays in a raid.

Mini-Player Overlay

Control your music without opening the main window.

• Draggable overlay with corner snapping
• Play, pause, next, and previous controls
• Seek bar with click-and-drag seeking
• Scrolling song titles for long names
• Double-click to open the main RimTunes window
• Auto-hiding controls and lockable position
• Avoids RimWorld tutorial popups automatically
• Scales with RimWorld's interface scale
• Customizable colors for the background, text, buttons, and progress bar
• Silence countdown between tracks

Import Your Own Music

• Local files - Import music from your computer
• Direct audio links - Add supported audio files from direct URLs
• Existing game music - Browse RimWorld music and music included with installed mods

When available, RimTunes automatically reads artist and title information from audio files.

Supported formats:

• .mp3
• .wav
• .ogg

Tracker formats such as .xm, .it, .mod, and .s3m are not supported.

Playlists

Create playlists for every colony, biome, mood, faction, or disaster.

• Create, rename, delete, and reorder playlists
• Drag and drop songs to change their order
• Copy and paste songs between playlists
• Merge playlists without duplicate tracks
• Choose custom playlist icons
• Shuffle tracks and choose repeat modes
• Export and import playlists through the clipboard
• Library - Browse every available song in one place
• Mod playlists - Automatically created for installed mods that include music

Song Tags

Tell the Dynamic Music System when a song should, or should not, play.

• Mood - Tense, Peaceful, Ambient
• Time of day - Day, Night, and custom time ranges
• Seasons - Spring, Summer, Fall, Winter
• Weather conditions
• Game conditions and events
• Biomes
• Royal titles when Royalty is installed

Each tag can be set separately for every song:

• Default - No preference
• Required - The condition must be active
• Forbidden - The song will not play while the condition is active

Playback

• Smooth crossfades between songs
• Separate transition settings for peaceful and dangerous situations
• Optional silence gaps between tracks
• Shorter breaks during combat and longer breaks during peaceful gameplay
• Optional idle silence after a period without activity
• Pause or skip silence gaps whenever you want
• Optional volume normalization for a more consistent music volume

Custom Hotkeys

Five fully rebindable hotkeys:

• Open or close the main music window
• Show or hide the mini-player overlay
• Pause or resume playback
• Next song
• Previous song

Supports Ctrl, Alt, Shift, and Cmd modifiers.

Mod Compatibility

• Automatically discovers music included with installed mods
• Creates separate playlists for mod soundtracks
• Keeps RimWorld's music volume synchronized with RimTunes
• Works with vanilla music and supported mod-added music

Languages

🇬🇧 English • 🇨🇳 简体中文 • 🇫🇷 Français • 🇩🇪 Deutsch

🇷🇺 Русский • 🇪🇸 Español • 🇺🇦 Українська

Requirements

• RimWorld 1.6
• Harmony

No DLC is required.

Royalty integration is enabled automatically when the Royalty DLC is installed.

Credits & Links

Created by DepsCian.

GitHub - DepsCian/RimTunes