README.md 1.4 KB
Newer Older
Johannes Barthel's avatar
intial  
Johannes Barthel committed
1
2
# senfsip-moderated-mute

3
this tool fixes three issues where meeting permissions don't work for (or rather, against) telephone users in bbb conferences
Johannes Barthel's avatar
intial  
Johannes Barthel committed
4
5
6

* phone users can unmute themselves, even when moderators restrict the microphone permission
* phone users are not muted when the microphone permission is disabled
7
* phone users joining a meeting where microphone permissions are disabled can still talk
Johannes Barthel's avatar
intial  
Johannes Barthel committed
8

9
you need to make one change in the dialplan for this to work. in the file `/opt/freeswitch/etc/freeswitch/autoload_configs/conference.conf.xml`, change the lines
Johannes Barthel's avatar
intial  
Johannes Barthel committed
10
11
```xml
      <control action="mute" digits="0"/>
12
      <control action="deaf mute" digits="*"/>
Johannes Barthel's avatar
intial  
Johannes Barthel committed
13
14
15
16
```
to
```xml
      <!--<control action="mute" digits="0"/>-->
17
      <!--<control action="deaf mute" digits="*"/>-->
Johannes Barthel's avatar
intial  
Johannes Barthel committed
18
19
```

Johannes Barthel's avatar
Johannes Barthel committed
20
21
22
23
24
To build a debian package, run `./build-deb.sh` on the target OS (Ubuntu Xenial für BigBlueButton 2.2, or Ubuntu Bionic for BigBlueButton 2.3). This is needed as one of the bundled dependencies is native and thus needs to link against the correct Python version.

## Known issues
* When restarting BigBlueButton via `bbb-conf --restart`, this service needs to be restarted manually. Otherwise mute/unmute won't work.
* Be sure to perform the change to `conference.conf.xml` described above. The package won't modify the dialplan by itself.
Johannes Barthel's avatar
Johannes Barthel committed
25
26
27

## License
This script is © by Computerwerk Darmstadt e.V., licensed under LGPL 3.0 (like BigBlueButton).