Rivendell setup for remote voice-tracking and full control with VoIP real-time audio.
-------------------------------------------------------------------------------------

Note: You will need a VoIP server or VoIP accounts for the workstation and remote machines. These should ideally support Opus but G722 may be "good enough".
A free VoIP service may be ok, but we use our own Asterisk server to ensure high quality audio. Setup of Asterisk is not documented here. Opus can support HiFi Stereo two way realtime audio via SIP/RTP with a suitable server using Linphone and this is also a potential solution for outside broadcasts.


Note:
    This should NOT be confgured on your main Rivendell machine.
    Set this up on one or more additional machines (or possibly VMs) dedicated to remote use.
    This machine should be on the same LAN as the database for optimal performance.

Before you start:
    Ensure JACK audio is setup and JACK is set to auto-start on boot using the on_startup.sh script (see previous notes).
    If you have enabled Icecast and/or Rivendell streaming via JACK audio on the machine you will use for remote acces, this must be disabled.
    Ensure RDP remote access is configured.
    Ensure the machine has a unique hostname.
    Ensure that RDairplay and Darkice are NOT set to start in the on_startup.sh startup script (always edit as user, not root).
    Ensure Icecast is NOT installed: sudo apt-get remove icecast2
    

Rivendell Machine for Remote Access Setup
-----------------------------------------

Install the Pulse Audio to Jack bridge:
sudo apt-get install pulseaudio-module-jack
sudo vi /etc/pulse/default.pa
Add the following lines, underneath the #'ed out line that says #load-module module-alsa-sink
load-module module-jack-sink
load-module module-jack-source

Ensure Pulseaudio is disabled at startup:
sudo vi /etc/pulse/client.conf
(uncomment the autospawn=yes line, and set it to no)

Install Linphone:
sudo apt-get install linphone

Ensure the notificatiion area is added to the lower Gnome bar.

Run Linphone (type linphone at the terminal) and perform the following:
    Behind the box that appears on first run is a "setup assistant". Run through this selecting "I already have a SIP account and want to use it".
      Username: yourservervoipusername
      Password: yourservervoippassword
      Domain:   yourservername.domainname
    After clicking next you may need to enter the password again.
    Check the application shows the account as registered.
    Click "Close" for the setup.
    Click "Options" then untick "always start video" then click "Preferences".
    Click "Multimedia Settings" and untick "Echo Cancelation" and for "playback device" select "ALSA:default device".
    Click "CODECs" and disable all except G722 (G722 will need to be enabled).
    Once complete, close Linphone.

Make Pulseaudio start AFTER Jack and Linphone start hidden after Pulseaudio:
(as the user):
cd rdscripts
vi on_startup.sh
Add as last lines in file:
sleep 5
pulseaudio &
sleep 5
linphone -a --iconified &

Note: To change Linphone settings later, you can just run the client on the desktop, change settings and close when done.

Make Rivendell automatically patch to the correct JACK ports on startup. 
Note that this is the reverse to normal patching, as we patch the Rivendell output to the Pulse system input and Rivendell input to Pulse system output!

sudo vi /etc/rd.conf

[JackSession]
Source1=rivendell_0:playout_0L
Destination1=PulseAudioJACK Source:front-left
Source2=rivendell_0:playout_0R
Destination2=PulseAudioJACK Source:front-right
Source3=PulseAudio JACK Sink:front-left
Destination3=rivendell_0:record_0L
Source4=PulseAudio JACK Sink:front-right
Destination4=rivendell_0:record_0R

Reboot.

Run RDlibrary and use Patchage to check the JACK patching if needed.

Using the local display or VNC, ensure the server screen resolution is set to 1024x768 and our wallpaper is installed.

Reboot.



Windows Client Setup:
---------------------
Install Linphone on the Windows machine and configure it with a Voip account. As above, disable echo cancelation and ensure G722 is enabled.