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 url
   8 - Youtube/Soundcloud URL (everything supported by youtube-dl)
   9 - Local folder (disabled, I need to work on the web interface)
  10
  11 -----
  12 ## Menu
  13 1. [Web Interface](#web-interface)
  14 2. [Installation](#installation)
  15 3. [Generate a certificate](#optional-generate-a-certificate)
  16 4. [Starting the bot](#starting-the-bot)
  17 5. [Custom commands](#custom-commands)
  18 6. [Contributors](#contributors)
  19
  20
  21 ### Web interface
  22 * Disabled by default. It's working but ugly (I'm not a web developer).
  23
  24 You need to create a folder for all your music. Organize your music by subfolder.
  25 The main folder needs to be declared in the config (with a '/' at the end)
  26 You can enable the web interface into the configuration.ini file.
  27
  28 ### Installation
  29 1. You need python 3 with opuslib and protobuf (look at the requirement of pymumble)
  30 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.
  31
  32 Example installation commands for Debian and Ubuntu:
  33 ```
  34 apt install python3-venv
  35 apt install ffmpeg
  36 git clone --recurse-submodules https://github.com/azlux/botamusique.git
  37 cd botamusique python3 -m venv venv
  38 venv/bin/pip install wheel
  39 venv/bin/pip install -r requirements.txt
  40 ```
  41
  42 ### (Optional) Generate a certificate
  43 `$ openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout botamusique.pem -out botamusique.pem -subj "/CN=botamusique"`
  44
  45 ### Starting the bot
  46 `$ venv/bin/python mumbleBot.py -s HOST -u BOTNAME -P PASSWORD -p PORT -c CHANNEL -C /path/to/botamusique.pem`
  47
  48 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)
  49
  50 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)
  51
  52 ### Custom commands
  53 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.
  54
  55 you have the section :
  56 - server : configuration about the server and bot name. This is overrided by the `./mumbleBot.py` parameters.
  57 - bot : basic configuration of the bot : comment, folder, volume at start ....
  58 - webinterface : basic configuration about the interface (disabled by default)
  59 - command : you can customize the command you want for each action (if you put `help = helpme` , the bot will response to `!helpme` )
  60 - radio : here you can have a list of default radio ( I can play a jazz radio with the command `!radio jazz`)
  61 - strings : you can customize all string the bot can say.
  62 - debug : option to active ffmpeg or pymumble debug. (Can be very verbose)
  63
  64 ### Contributors
  65 If you want to participate, You're welcome to fork and pull requests Fix et new features.
  66
  67 The following people joined the collaborators for a faster development, big thanks:
  68 - @slipenbois
  69 - @mertkutay
  70
  71 Feel free to ask me if you want to help activelly without using pull requests.