MumbleEchoSpatializer

Mumble spatial audio plugin for Echo VR.

Tested on Mumble 1.3.0.

Installation

From the Releases page, download both .dll files. Open an Explorer window and copy paste the following into the address bar:

%AppData%/Mumble/Plugins

Press enter and you should be in an empty directory. Copy the .dll files into this directory, then restart Mumble. In Mumble, go to Configure -> Settings -> Plugins and verify that "Echo VR" appears in the list. Check "Link to Game and Transmit Position" under "Options". Go to "Audio Output" and check "Positional Audio".

Usage

Audio will be spatialized while you are in a match with others using the plugin. The lobby and other game areas (menus, tutorials etc) are not spatialized.

Mumble settings for positional audio will need to be adjusted for best experience. Go to Configure -> Settings -> Audio Output and check the "Positional Audio" box. In the Positional Audio section make the following changes:

Check "Headphones"
Minimum Distance = 1.0m
Maximum Distance >= 80.0m
Minimum Volume <= 20%

You can adjust these to your preferences, but these are good defaults to start from.

Troubleshooting

Verify that Echo VR is running
Verify that Mumble is running

In Mumble settings, under "Audio Output":

Verify that the device is set to your Rift headphones
Verify that the "Positional Audio" checkbox is [x] checked
Under "Positional Audio", verify that the "Headphones" checkbox is [x] checked

In Mumble settings, under "Plugins":

Under "Options", verify that the "Link to Game and Transmit Position" checkbox is [x] checked
Under "Plugins", verify that "Echo VR" is present in the list
- If it is not, you probably installed the wrong plugin version (32 or 64 bit), or the plugin is missing; reinstall it
Under "Plugins", verify that the checkbox next to "Echo VR" is [x] checked

Once you have checked all of the above:

In the Mumble status pane (on the left), wait 30 seconds and ensure "Echo VR linked" appears. If it does not, start over from the beginning of this list.

If you are in the same match with someone and can't hear positional audio from them, make sure you are both using the same version of the plugin. The version number appears next to the plugin name in Settings -> Plugins.

If none of the above work:

While in a match, go to http://localhost/session in your browser, and verify that you get a text blob (page does not time out). If it is timing out, turn off your firewall or make an exception for Echo VR.

Contributing

Patches are welcome. Please use the following guidelines:

Patches should use the line endings and style of the changed file
Contributions must be public-domain, as specified in the Unlicense

Building