El Boto: a fun, useful Discord Bot full of utilities and more.

Release

Currently available on:
Bot OnDiscord!

Discordbots!

Commands and help

Want to know about Commands help? type $help into Discord to show the commands table.
Also, typing $help 'command name' will show more about a command.

Description

This Discord Bot is hosted on Heroku via real time cloud to make the bot run 24/7.
This repo there contains the configuration file and environ necessary to Heroku to let
the bot work properly.

This simple discord bot will help and aid in basic features like:

• BOT BASICS
  Join: simple as it seems: make the bot join the channel. -> $join
  Leave: you won't believe: make the bot leave the channel. -> $leave
  

• MUSIC
  Play and search songs from youtube: -> $play 'songname'
  Song's queue management (adding songs while one's currently playing will add to the queue)
  Skip song functionality: bored of the songs played by other? skip it! -> $skip
  Queue status for checking which song it's actually queued -> $qstatus
  Stop function to make the player stop playing -> $stop
  Pause and resume function: they do what you expect. -> $pause // $resume
  Volume adjust function to adjust the volume -> $volume 'volume number'
  

• SEARCHING
  Why open a browser when you comfortably do this on your discord channel?
  Searching features include(TEXT PAGE by default):
  Searching page by name (returns: most-top occurrence) -> $src 'something'
  Searching a video, returning the most-top occurrence of that video on youtube -> $srcvideo 'something'
  

• MODERATION
  Moderation tool that allows an Admin to perform roles and kicks action. To use this functionality, the server creator must create a role named LORD with admin features, and add this role to himself.
  Set default role: whenever a new user will join your channel, a default role will be assigned. -> $setdefrole 'ROLE NAME' (Note: everytime your bot will leave your server, you'll need to do that again.
  Addrole: add an existing role to one of the member of the server. -> $addrole @member 'ROLE NAME'
  Removerole: remove an existing role from one of the member of the server. -> $removerole @member 'ROLE NAME'
  Print roles: want to show everyone how creative you are? print your roles into che channel! -> $printroles
  Kick: the ol' nice kick. Kick someone from the server! -> $kick @someone
  

• UTILITY Offend people with the command $offence, and take a laugh. -> $offence 'Someone'
  Dice roll isn't only on World of Warcraft: win dispute with your friend launching your dice! -> $droll 'diceface' (default dice: 6, diceface can be any number).
  Test Bot: well, you want to check if your bot is alive, don't you? -> $test 'echotest'
  Info: get info about the creator (That's me!)-> $info
  

• MORE TO COME!
  

Dependencies

This bot requires internal and external dependencies in order to work.
If you'd like to compile ant test it locally, you'll need this the following dependencies:

Runtime enviroinment:

-Python 3.6.7

Internal Dependencies:

-discord.py lib
-youtube_dl lib
-google - specifically googlesearch- lib

External Dependencies

-PyNaCL
-FFMPEG/AVCONV to make the bot translate and play youtube audio into the channel

Token

• Also, don't forget to change the occurrence 'YOUR TOKEN' into the DiscordBot.py file with the token of your bot (available once you created your new bot and went into developer section to check it).

Installation

For installing and running this bot in local, make sure to have all the dependencies listed there, and then download the DiscordBot.py.
Once done, type

cd /path/to/bot
python DiscordBot.py 

into your terminal to make the bot starting his job.

Alternatively you can deploy this bot on Heroku, forking this repo and change the token with yours.
Dependencies buildpacks on Heroku:

• Python
• heroku-buildpack-ffmpeg-latest.
• AWS APT (heroku-community/apt).