= Murmur = [https://wiki.mumble.info/wiki/Running_Murmur murmur] is the server components for using our [wiki:mumble mumble chat/VOIP service]. Our murmur server is running on toussaint. == SuperUser == To have full admin access, login with the username: SuperUser You will be prompted for a password (which is in keyringer). If you ever need to change the password, run: {{{ murmurd -ini /etc/mumble-server.ini -supw }}} == Admin Group == Members of the admin group can: * Drag people into a room * Mute/Deafen and kick people To add a user to the admin group. * Login with the new username. * Right click on your username and click register. * Login as the SuperUser. * Then right click on Root and select Edit. * Click Groups. * Type: admin and hit enter * Type a new username and click add. == Bots == === Overview === Our murmur server comes with three broadcast bots: en-bot, es-bot and o-bot These bots are designed to allow listeners to follow the conversations via a web site. They each broadcast portions of a meeting, via icecast, to https://participate.mayfirst.org/ and they save a recording. The bots are installed on toussaint (same server that murmur is installed on). They broadcast to b.stream.mayfirst.org (aka sankara). They recordings are also saved on sankara (in /srv/icecast and configured via the dump-file icecast.xml directive). For mono-lingual meetings, you only need o-bot (original language bot). Just turn it on and you are done. If you have a meeting with interpretation, then you will need to use en-bot and es-bot. === How to use them === Everytime icecast2 is restarted on sankara or murmur is restarted on toussaint, the bots will drop out and need to be restarted. To restart, login to toussaint and use systemctl (e.g.`systemctl restart o-bot; systemctl restart o-bot`) Once started,they should appear in mumble in the "Meeting" room and the "Meeting/Interpret" room. By default, they are not broadcasting to icecast2 - you should instead hear the "fallback" music. To begin broadcast and recording, send a private message to each both with: "/start". You can stop recording with: "/stop". en-bot should be dragged into the main room when English is spoken, and into the Interpretation room when Spanish is spoken so that it always broadcast in English. An administrator is responsible for moving this bot during the meeting. es-bot should be dragged into the main room when Spanish is spoken, and into the Interpretation room when English is spoken so that it always broadcast in Spanish. An administrator is responsible for moving this bot during the meeting. Administrators can drag and the bots to whatever channel you like. === Installation === 1. Install cython (python c bindings library) and python-dev and ffmpeg and python-protobuf 1. In /usr/local/share, git clone both https://github.com/Robert904/pymumble and https://github.com/Robert904/mumblerecbot 1. Pull in this change to mumblerecbot: https://github.com/Robert904/mumblerecbot/pull/10/files 1. In /usr/local/share/mumblerecbot: 1. `git remote add jmcclelland https://github.com/jmcclelland/mumblerecbot.git` 1. `git remote update jmcclelland` 1. `git cherry-pick c5416a80fa278ff77b5f49d68856000089589dfc` 1. In /usr/local/share/pymumble/pycelt edit the Makefile: 1. Comment out `export PLATFORM = MINGW32` and uncomment `#export PLATFORM = UNIX` 1. Comment out `export CONFIGURE_OPTS = ""` and uncoment `#export CONFIGURE_OPTS = "--with-pic"` 1. Type: `make` 1. In /usr/local/share/pymumble/pyopus edit the Makefile: 1. Comment out `export PLATFORM = MINGW32` and uncomment `#export PLATFORM = UNIX` 1. Comment out `export CONFIGURE_OPTS = ""` and uncoment `#export CONFIGURE_OPTS = "--with-pic"` 1 Type: `make` 1. In /usr/local/share/mumblerecbot/mumblerecbotfast edit the Makefile: 1. Comment out: `PLATFORM = MINGW32` 1. Write instead: `PLATFORM = UNIX` (ensure you have no trailing spaces) 1. Type: `make` 1. In /usr/local/share/mumblerecbot/, create a symlink to pymumble: `ln -s ../pymumble` 1. Create /etc/mumblerecbot/{en-bot,es-bot, o-bot} 1. Copied constant.py to config.py in each directory and edited 1. For ENCODER, use (change en-bot to o-bot or es-bot as needed): {{{ ENCODER = "ffmpeg -f s16le -ar 48000 -ac 2 -i - -codec:a libmp3lame -b:a 16k -ac 1 -ar 22050 -content_type audio/mpeg -f mp3 icecast://en-bot:XXXXXXXXXXXXXX@b.stream.mayfirst.org:8000/en-bot.mp3 -c:a libvorbis -content_type audio/webm -f webm icecast://en-bot:XXXXXXXXXXXXXXXXXXXX@b.stream.mayfirst.org:8000/en-bot.webm" }}} 1. Create var for pid file and logs 1. Create user `mumblerecbot` and chowned the var directory to this user 1. Created /etc/systemd/system/{en-bot,es-bot, o-bot}.service files and enabled them