OBR Music Tool 0.3.1

OBR Music Tool 0.3.1 makes the shared stuff easy to find and edit in one place.

What's new

Generic lines (Dialogue tab)

• The Dialogue tab now starts with Generic lines: the lines every NPC of a race can say (greetings, rumors, guard barks, combat shouts). It opens into one row per race, then per sex, then the lines - so "every Orc female" is one place to edit.
• The group is flagged on purpose: replacing a line in there changes it for a mass of characters. Each generic line also says so ("every Imperial male NPC says this").
• Search still works inside the tree: orc female rumors opens straight to the matching lines.

Shared audio (sound tabs)

• Every sound tab now starts with a pinned Shared audio group: the audio files used by several sounds (one menu click serves 90 actions, creature foley shared across variants...). Each file lists the sounds that use it, can be previewed, and is replaced or removed once for all of them.
• Searching a tab also filters the shared files by source name or by any sound that uses them.

Also

• Expanded rows appear instantly (no more accordion animation).
• Exe signed with the updated certificate.

Requirements

Unchanged: Windows 10/11, Oblivion Remastered (Steam), and Wwise Authoring (free) for converting audio to .wem. Install instructions are in the README.

OBR Music Tool 0.3.0

OBR Music Tool 0.3.0 adds the Dialogue tab (every voice line in the game, with speaker and subtitle), previews for the Opus-encoded sounds, a play-length column and a round of list polish. The exe is code-signed.

What's new

Dialogue tab

• Every voice line in the game, grouped by speaker: 1,127 speakers (named NPCs, factions, classes, and "Any Orc female"-style race groups) covering 135,046 lines / 94,284 recordings. Open Sheogorath and all 320 of his lines are there. Each line shows its topic, the subtitle text (hover it to read the whole line), the voice type (race, sex, alternative voices) and the play length; the speaker row shows the line count, the total length and how many lines are replaced. Names and subtitles are the game's English text, resolved from its localisation table, not editor ids.
• Search matches speakers, words in the lines, topics, quests and voice types: haskill, sheogorath greeting, orc female rumors, martin dragonfires. The speaker whose name matches comes first, and only the matching lines are listed under each speaker.
• Play, Replace and Remove work per line; replacements are written to Media/English(US)/<id>.wem in the pak, and the release README / playlists carry the speaker and line.
• The game shares voice recordings between races: Dark Elf and Wood Elf lines use the High Elf actor's files, Orc uses Nord, Khajiit uses Argonian and Breton uses Imperial. A line that shares its recording says so (same recording as Dark Elf male, Wood Elf male), and replacing it changes it for every race that plays that file.

Previews

• Sounds stored as Wwise Opus (most voice lines and some ambience) now decode and play, alongside Vorbis and PCM. Sounds that are generated by a Wwise plugin (no audio file, e.g. synthesised tones) are marked as such and cannot be replaced.
• A Length column shows the play time of every sound, variation and voice line.

List polish

• Double-click a sound or speaker to open or close its lines (the double-click no longer triggers a stray Play).
• Row separators, vertically centred buttons, centred Replace label, no accent bar on variation rows.
• Clearer status labels: Original / Edited / Partial / Plugin (were vanilla / replace / partial); speaker rows show N edited.

Under the hood

• The dialogue index ships inside the exe (2 MB, compressed) and is decoded once on first use. It is built by tools/sfxindex from the Wwise voice events, the game's plugins (Oblivion.esm and the DLC .esp files under Dev/ObvData/Data) and the English Game.locres; the builder reports which races share voice actors.
• .locres reader and Wwise Opus decoding (opus-decoder) added; the shared pak reader now also exposes the localisation files.
• The game's pak index used for previews now loads in the background right after connecting, so the first Play no longer pauses the window. Dialogue search no longer allocates per line; clippy-clean, dead code removed.

Known limitations

• Melee weapon impacts (nws_weap_impact) may only partly take effect in-game; their soundbank carries its own copy of the audio.
• The title-screen music loops at a fixed point set inside the game (see the README).
• Xbox app / Game Pass installs are not supported.

About this build

The exe is code-signed with the Computer Works certificate (the developer's company; OBR Music Tool stays a free, open-source hobby project, see the README). A brand-new build can still get a SmartScreen "unrecognized app" prompt until it builds up reputation: More info > Run anyway, or build from source.

Requirements

Unchanged: Windows 10/11, Oblivion Remastered (Steam), and Wwise Authoring (free) for converting audio to .wem. Install instructions are in the README.

OBR Music Tool v0.2.0

OBR Music Tool now replaces sound effects as well as music, with previews for everything.

What's new

Sound effects, not just music

• Every sound effect in the game can be replaced the same way as the 28 music tracks: ~1,190 sounds, ~5,700 audio files, organised in tabs at the top of the inventory — Music · Menu & UI · Weapons · Magic · Creatures · Player & NPC · Doors, Chests & Traps · Environment & Weather · Cinematics · Other (Dialogue is a placeholder for a later update).
• Sounds carry the game's own names (for example obj_drs_chest_open, source file al_obj_drs_chest_open.wav) instead of numeric ids. A built-in index, generated from the game files, maps every name to its Wwise media ids.
• Each tab shows 50 sounds per page; the search box filters the whole tab by sound name, group and source file name.

Variations

• Sounds with several variations (the random alternatives the game picks from) expand with the ▸ arrow. Each variation can be played, replaced or removed on its own; Replace on the sound itself still covers all of them, and partially replaced sounds show as partial.
• The app tells you when a sound shares its audio with other sounds (some menu clicks are used by 90 actions) and flags the few weapon-impact sounds whose soundbank embeds a copy of the audio ("may not replace cleanly").

Play everything

• Music previews from the game's loose mp3s as before. Sound effects are read straight out of the game's pak (read-only) and decoded in the app, so you can hear the original before replacing it. A replaced sound previews your file instead.

Under the hood

• One encode per distinct source file, however many sounds it is assigned to; a 3-variation sound becomes 3 entries in the pak.
• Release README lists replaced sounds grouped by tab. Playlists keep their format (<wwise id> = <path>, one line per variation); playlists from 0.1.0 still open.
• tools/sfxindex rebuilds the sound index from any install (any drive) after a game update.

Known limitations

• Dialogue (voice lines) is not exposed yet.
• A handful of sounds use codecs that cannot be previewed (Wwise ADPCM / Opus); replacing them still works.
• Melee weapon impacts (nws_weap_impact) may only partly take effect in-game — their soundbank carries its own copy of the audio.
• The title-screen music loops at a fixed point set inside the game, so a replacement of a different length may loop with a gap or cut off (see the README).
• Xbox app / Game Pass installs are not supported.

About this build

The exe is code-signed with the Computer Works certificate (the developer's company; OBR Music Tool stays a free, open-source hobby project, see the README). A brand-new build can still get a SmartScreen "unrecognized app" prompt until it builds up reputation; More info > Run anyway, or build from source.

Requirements

Unchanged: Windows 10/11, Oblivion Remastered (Steam), and Wwise Authoring (free) for converting audio to .wem. Install instructions are in the README.

OBR Music Tool v0.1.0-alpha.1

First public alpha of OBR Music Tool: replace any of Oblivion Remastered's 28 music tracks with your own audio, build a patch .pak, and package a Nexus-ready ZIP. Expect rough edges. If something breaks, open an issue and paste the Activity log (there is a Copy button above it).

Download

OBR-Music-Tool-v0.1.0-alpha.1-windows-x64.zip contains obr-music-tool.exe, the LICENSE and the README. Unzip anywhere and run it. No installer, no admin rights, no internet access.

Requirements

• Windows 10 / 11, 64-bit
• The Elder Scrolls IV: Oblivion Remastered (Steam or Xbox / Game Pass)
• Wwise Authoring (free, about 2 GB) to convert MP3 / WAV / OGG / FLAC into the game's .wem format. Step-by-step install instructions are in the README under "Installing Wwise". Not needed if you only use pre-encoded .wem files.

What is in this build

• Inventory of all 28 vanilla tracks (Battle, Dungeon, Explore, Public, Special) with preview playback
• Replace any track with .mp3, .wav, .ogg, .flac or .wem; conversion runs in the background through WwiseConsole
• Build & install PAK straight into the game's Paks folder
• Export PAK to any location
• Package release ZIP: the PAK in the OblivionRemastered/Content/Paks/~mods layout plus a generated README.txt, ready for Nexus / Vortex / MO2
• Save and open playlists (.obrplaylist) so a mod can be reopened and tweaked later
• Copyright reminder before exporting, with a "don't show this again" option
• Automatic detection of the game (Steam registry and libraries, Game Pass) and of Wwise

Known limitations

• Replaces existing tracks only. Adding new tracks to the playlist is planned for a future update.
• Tested on the Steam version; feedback from Game Pass installs is welcome.
• Windows only.

License

Free to use, modify and share. Mods made with the tool may not be sold or put behind a paywall; asking for donations is fine. See LICENSE for the full terms, and remember that the music you package must be yours, licensed to you, or free to use.

Checksums (SHA-256)

fe420d37954043565bf30cdccef0b4eb675cefa5877c8463fa2802afeeb4703d  OBR-Music-Tool-v0.1.0-alpha.1-windows-x64.zip
2e708e795641a4cb8215a2cb65e5c13d26352b0d705848b60c8c3a05d9d8461e  obr-music-tool.exe