cs en
updated  2021-09-15

After starting the application, it will lead you through all the necessary settings.

Even though the interface is textual only, it may be easy to control it – just keep pressing the keys in braces instead of using mouse. The default option is usually triggered by space.

    +----------------------------------------------------------------------+
    | Virtual Choir Rehearsal Room v1.1,                                   |
    | created by Lukas Ondracek, use under GNU GPLv3.                      |
    +----------------------------------------------------------------------+

== 1/4 == SELECT SOUND INTERFACE AND DEVICES ==================================

Usually, there are multiple ways how to communicate with your sound device
and possibly even multiple devices; different ways have different delays.

On Windows, WASAPI in exclusive mode is chosen as default.
You may need to allow exclusive mode in your system settings
and set sampling rate of both microphone and headphones to 48 000 Hz.

[space] default settings    [c] custom settings

For custom settings see Choosing audio device.

If sound is not working on Windows, see Exclusive mode.

== 2/4 == MEASURE DELAY OF SOUND SYSTEM =======================================

Several loud beeps will be played and recorded back to measure the delay
between producing sound by the application and getting it back there.

Take your headphones OFF your ears before continuing
and place microphone closer to audio source if possible.
In case of failure, you can use loudspeaker temporarily.

[space] start measuring    [s] skip  (may cause problems with synchronization)
Measuring...:  17.67 ms  17.85 ms  17.83 ms  16.47 ms  17.66 ms  
Chosen value:  17.67 ms.

[space] continue    [r] repeat

If the measured values are too high, see Choosing audio device.

== 3/4 == SET MICROPHONE AND HEADPHONES' VOLUME ===============================

Connect your headphones.

[space] continue
Sing loudly for a while, then press space to continue...

You may hear the sound being recorded by your microphone
and see its average (#) and peak (+) intensity levels on the scales below.
Set your microphone volume in system settings so that
it's peak intensity never exceeds -10 dB on the first scale; -------------+
test it by loud singing.                                                  |
At the same time further intensity adjustments will be performed          |
and displayed on the second scale;                                        |
the average level of laud singing on this scale may be just below -20 dB. |
Also set your microphone position                                         |
to hear your voice but not your breathing.                                |
                                                                          |
[space] confirm setting    [r] reset adjustments               average  peak
                     -78                          -20  -10    0   |       |
                       |                            |    |    |   V       V
system level:          [######++++----------------------------] -65 dB (-57 dB)
adjusted level:        [############++++----------------------] -52 dB (-45 dB)

See how to set system Microphone volume if needed.

You may hear some glitches in the first half a minute; if they remain or no sound is audible at all, check Exclusive mode settings.

In case of occasional glitches, Optimizing application performance may be useful.

== 4/4 == SERVER SETTINGS =====================================================

Disclaimer:
  After entering server address,
  sound being recorded as well as all key presses to this application
  may be send unencrypted to the server.

Your name (without diacritics, at most 10 letters):
Server address:

Here write your name and server address, each followed by Enter key. If you don’t have server address yet, see Server section.

Contacting server...
Waiting for server response...
Connected.

Now, you should hear the other people, continue reading Client control.

In case of other sound issues, first find out at whose side the problem is. Are you the only one hearing it or is it coming from one person to everybody? You can utilize muting individual people to discover it.

If echo is the issue, somebody’s microphone probably records sound from the headphones; try to change the position of microphone or use closed headphones, whose sound is not so audible from the outside. Some phone headsets with 4-pin jack may cause leaking the played signal into the recorded one; the echo is then recorded even though no sound is audible outside.

In case of noise, buzzing, or creaking of loud tones, check correct settings of Microphone volume in the third step.

If you experience frequent glitches, high delays or connection failures, it may be caused by unstable internet connection. If you cannot use cable connection, see some tips on WiFi connection optimization. Application performance optimization may be also helpful in such a case.

Use double y to reconnect if needed:

Connection lost or cannot be established, connect again? [y/n]: y
Use the same server address? [y/n]: y