65 lines
1.5 KiB
Markdown
65 lines
1.5 KiB
Markdown
|
# mumsi - SIP to Mumble gateway
|
||
|
|
|
||
|
|
SIP to Mumble gateway based on PJSIP stack and *mumlib* library. It registers to SIP registrar and listens for incoming
|
||
|
|
connections on the SIP account.
|
||
|
|
|
||
|
|
This enables the user to participate in Mumble conference using SIP client or perhaps ordinary telephone, by VoIP provider.
|
||
|
|
|
||
|
|
## Dependencies
|
||
|
|
|
||
|
|
* Boost libraries
|
||
|
|
* *log4cpp*
|
||
|
|
* *pjsua2* from Pjproject SIP stack
|
||
|
|
* CMake
|
||
|
|
* *mumlib* - https://github.com/slomkowski/mumlib
|
||
|
|
|
||
|
|
## Build and usage
|
||
|
|
|
||
|
|
* Install all needed dependencies
|
||
|
|
|
||
|
|
* Clone and compile Mumlib library. Since it doesn't have any installer, clone it to common directory:
|
||
|
|
```
|
||
|
|
mkdir mumsi-dist && cd mumsi-dist
|
||
|
|
git clone https://github.com/slomkowski/mumlib.git
|
||
|
|
mkdir mumlib/build && cd mumlib/build
|
||
|
|
cmake ..
|
||
|
|
make
|
||
|
|
cd -
|
||
|
|
```
|
||
|
|
|
||
|
|
* Then clone and build Mumsi:
|
||
|
|
```
|
||
|
|
git clone https://github.com/slomkowski/mumsi.git
|
||
|
|
mkdir mumsi/build && cd mumsi/build
|
||
|
|
cmake ..
|
||
|
|
make
|
||
|
|
```
|
||
|
|
|
||
|
|
* Copy example *config.ini* file and edit it according to your needs:
|
||
|
|
```
|
||
|
|
cp config.ini.example config.ini
|
||
|
|
```
|
||
|
|
|
||
|
|
* To run the service, type:
|
||
|
|
```
|
||
|
|
./mumsi config.ini
|
||
|
|
```
|
||
|
|
|
||
|
|
## Issues
|
||
|
|
|
||
|
|
* remember to allow incoming connections on port 5060 UDP in your firewall
|
||
|
|
|
||
|
|
* PJSIP packages in some distributions require to have a sound card in your system, which can be an issue on the server.
|
||
|
|
In this case, use *snd-dummy* sound module.
|
||
|
|
|
||
|
|
## TODO:
|
||
|
|
|
||
|
|
* SIP authentication - for now it answers every call
|
||
|
|
* multiple simultaneous connections
|
||
|
|
* outgoing connections
|
||
|
|
* text chat commands
|
||
|
|
|
||
|
|
## Credits
|
||
|
|
|
||
|
|
2015 Michał Słomkowski. The code is published under the terms of Apache License 2.0.
|