[[PageOutline]]

= Installing Mumble on a desktop computer =

These instruction cover installing [wiki:mumble mumble, the audio conference tool] on a desktop computer. You can also install it on your [wiki:mumble android or iphones].

Please set aside about 10 minutes to complete the installation so you can properly run through the audio configuration wizard.

For best results use a headset or head phones.

=== Install ===

First, visit [https://www.mumble.info/downloads/ the mumble download page] to get the version that's right for your computer.

Install the software.

''Windows users'': You almost certainly want to install the Windows x64 Snapshot version, not the regular Windows version 

''Mac users'' If you are using a recent version and [https://github.com/mumble-voip/mumble/issues/3471#issuecomment-410490926 this bug is not yet fixed], after installing mumble, you may need to go to `System Preferences->Security & Privacy->Privacy->Accessibility` and enable access for Mumble.

=== Audio Wizard ===

When you start Mumble for the first time, it will prompt you to follow the audio setup wizard.

**This process has about 4 screens with questions and takes about ten minutes.**

If you have a headset or head phones, please use them while doing the wizard (and for all mumble calls).

[[Image(mumble-audio-wizard-start.png, 600px)]]

== Create certificate ==

Next, you will be prompted to create a certificate. A certificate is like a key that will grant you access to the server as the username you specify.

[[Image(mumble-certificate-creation.png, 600px)]]

== Add a server ==

Next, you must tell mumble what server you want to connect to. Click the add button.

[[Image(mumble-add-new-server.png, 600px)]]

Please enter:

 * Mayfirst
 * mumble.mayfirst.org
 * [Whatever username you want]

Please note: If you are re-installing mumble or starting over, you must pick a new username. You can't use the same username twice.

[[Image(mumble-enter-server-details.png, 600px)]]

== Connect to server ==

Now, you can click on the server you just entered and click Connect.

[[Image(mumble-connect-to-server.png, 600px)]]

== Mute ==

Once connected, be sure to mute yourself.

[[Image(mumble-mute-mic.png, 600px)]]

== Join a meeting ==

You can join a meeting by dragging yourself to a room (aka Meeting).

[[Image(mumble-drag-to-meeting.png, 600px)]]

== Turn off text to speech ==

Hearing all text messages is irritating. Turn it off by clicking Settings and ensuring there is no check mark next to the "Text to Speech" menu item.

[[Image(mumble-t2s-unchecked.png, 600px)]]

== Configure Push to Talk ==

The "push-to-talk" configuration is our recommended setting. It allows you to configure a button on your keyboard to act like a CB talk button - while you are pushing it down, your microphone is open and you can speak. When you let go, it is as if you are muted. This allows you to avoid constantly muting and un-muting yourself.

You can configure "push-to-talk" by clicking `Configure -> Settings` (or `Preferences -> Settings` on a mac). Then select "Push to talk" from the Transmit section.

Then, you can configure a push-to-talk shortcut.  This is done under Configure » Settings, Shortcuts:

[[Image(push-to-talk-shortcuts.png, 800px)]]

In the Audio Input pane you can also checkmark "Display push to talk window" to get a floating always-on-top button you can click to talk, or of course switch to a different transmit setting.  (If using Continuous instead, be sure to mute yourself when not talking.)

== Audio Transmission Problems With Voice Activity ==

If people report trouble hearing you because parts of your words are cut off, check if you are using the Transmission setting '''Transmit: Voice Activity''' (under Configure » Settings, Audio Input pane).

[[Image(mumble-voice-activity.png, 800px)]]

The silence below and above sliders can be adjusted, or for certainty of being heard you can change to Continuous or Push To Talk (see above).