README.md

   1 # botamusique
   2
   3 Botamusique is a mumble bot which goal is to allow users to listen music together with its audio output.
   4 Predicted functionalities will be ones you could expect from any classic music player.
   5
   6 Bot the can play :
   7 - Radio station from url
   8 - Radio station from http://www.radio-browser.info API (query from > 24k stations)
   9 - Youtube/Soundcloud URL (everything supported by youtube-dl)
  10 - Local folder (disabled, I need to work on the web interface)
  11
  12 -----
  13 ## Menu
  14 1. [Web Interface](#web-interface)
  15 2. [Installation](#installation)
  16 3. [Update](#udpate)
  17 4. [Generate a certificate](#optional-generate-a-certificate)
  18 5. [Starting the bot](#starting-the-bot)
  19 6. [Custom commands](#custom-commands)
  20 7. [Known issues](#known-issues)
  21 8. [Contributors](#contributors)
  22
  23
  24 ### Web interface
  25 * Disabled by default. It's working but ugly (I'm not a web developer).
  26
  27 You need to create a folder for all your music. Organize your music by subfolder.
  28 The main folder needs to be declared in the config (with a '/' at the end)
  29 You can enable the web interface into the configuration.ini file.
  30
  31 ### Installation
  32 1. You need python 3 with opuslib and protobuf (look at the requirement of pymumble)
  33 2. The Bot uses ffmpeg, so you know what you have to do if ffmpeg isn't in your package manager. I personally use [this repository](http://repozytorium.mati75.eu/) on my raspberry.
  34
  35 To Install botamusique (stable and build-in auto-update):
  36 ```
  37 curl -Lo botamusique.tar.gz https://azlux.fr/botamusique/sources.tar.gz
  38 tar -xzf botamusique.tar.gz
  39 cd botamusique
  40 python3 -m venv venv
  41 venv/bin/pip install wheel
  42 venv/bin/pip install -r requirements.txt
  43 ```
  44
  45 For the master version, you can use Git installation commands (no build-in auto-update allowed):
  46 ```
  47 apt install python3-venv ffmpeg libjpeg-dev zlibc zlib1g zlib1g-dev
  48 git clone --recurse-submodules https://github.com/azlux/botamusique.git
  49 cd botamusique
  50 python3 -m venv venv
  51 venv/bin/pip install wheel
  52 venv/bin/pip install -r requirements.txt
  53 ```
  54
  55 ### Update
  56 If using the recommanded install, you can send to the bot `!update`(command by default)
  57
  58 If using git, you need to make the update manually:
  59 ```
  60 git pull --all
  61 git submodule update
  62 venv/bin/pip install --upgrade -r requirements.txt
  63 ```
  64
  65
  66 ### (Optional) Generate a certificate
  67 `$ openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout botamusique.pem -out botamusique.pem -subj "/CN=botamusique"`
  68
  69 ### Starting the bot
  70 `$ venv/bin/python mumbleBot.py -s HOST -u BOTNAME -P PASSWORD -p PORT -c CHANNEL -C /path/to/botamusique.pem`
  71
  72 The bot listen to the 8181 port so you should redirect to this one in you NAT configuration to let others peoples access the web interface. (DISABLED)
  73
  74 If you want information about autoStart and auto-Restart the bot, [you can have help on the wiki.](https://github.com/azlux/botamusique/wiki/AutoStart---AutoRestart)
  75
  76 ### Custom commands
  77 You can copy the file `configuration.default.ini` to `configuration.ini` and customize all variable. Everything can be change but don't remove the default file.
  78
  79 you have the sections :
  80 - server : configuration about the server and bot name. This is overrided by the `./mumbleBot.py` parameters.
  81 - bot : basic configuration of the bot : comment, folder, volume at start ....
  82 - webinterface : basic configuration about the interface (disabled by default)
  83 - command : you can customize the command you want for each action (if you put `help = helpme` , the bot will response to `!helpme` )
  84 - radio : here you can have a list of default radio ( I can play a jazz radio with the command `!radio jazz`)
  85 - rbquery : search http://www.radio-browser.info API for listed radio stations - eg: `!rbquery nora`
  86 - rbplay : Play a specific radio station by ID (from rbquery) - eg: `!rbplay 96748`
  87 - strings : you can customize all string the bot can say.
  88 - debug : option to activate ffmpeg or pymumble debug. (Can be very verbose)
  89
  90 ### Known Issues
  91
  92 During installation, you can have the error:
  93 ```
  94 ImportError: libtiff.so.5: cannot open shared object file: No such file or directory
  95 ```
  96 You need to install a missing system librairie: `apt install libtiff5`
  97
  98 ---
  99
 100 At start, you can have this following error even if you have install all requirements:
 101 ```
 102 Exception: Could not find opus library. Make sure it is installed.
 103 ```
 104 You need to install the opus codec (not embeded in all system) : `apt install libopus0`
 105
 106 ### Contributors
 107 If you want to participate, You're welcome to fork and pull requests (fixes and new features).
 108
 109 The following people joined the collaborators for a faster development, big thanks:
 110 - @slipenbois
 111 - @mertkutay
 112
 113 Feel free to ask me if you want to help activelly without using pull requests.