README.md

Otaku

Otaku is an open source Discord Music Bot.

Contents

• Why?
• Invite Link
• Installation
• Usage
• Configuration
• Currently Working On
• Want to Contribute?

Why

I wanted to make a Discord Music Bot just like groovy and Rythm which is open to world for contributions.

• Plays from search keyword
• Plays from link
• Supports many sites: https://ytdl-org.github.io/youtube-dl/supportedsites.html
• Has extra categories other than Music like FUN, UTILITIES, etc.

And is the first discord bot which I am maintaining.

Invite Link

Installation

Instead of hosting your own I recommend inviting the Otaku bot to your server

If you still want to host it then

Make a bot on discord developers portal and give the bot Admin Access

Copy the TOKEN of your bot(Pss. Its secret. Don't ever share it even with your close friends.)

Heroku

Installing on VPS(Ubuntu/Debian)

1. Clone the repository to your Local Machine
   • $ git clone https://github.com/AmreshSinha/Otaku
   • $ cd Otaku
2. Install all the requirements given in requirements.txt:
   • $ pip install -r requirements.txt
3. Install ffmpeg
   • $ sudo apt update
   • $ sudo apt install ffmpeg
4. Make a .env file in the same directory. (Yes exactly .env)
   • $ sudo nano .env
   • And paste your Discord Bot Token in it like
   • TOKEN = "YOUR-DISCORD-BOT-TOKEN" (Yes "" included)
5. Ensure you have python 3.8 or above
6. Uncomment the # from dotenv import load_dotenv line and # load_dotenv('.env') line.
7. Now its time to run it
   • $ python3 main.py
8. If you accidentally close the Terminal then the bot will go down and you will have to repeat Step-7
9. To Avoid this you can use Screen. Google it for usage.

I Still advise you to use the already hosted bot instead. Here's the Invite Link.

Usage

These are the Currently Usable Commands

1. Music:

   • !join Joins a voice channel
   • !link Plays from a URL (Supported: https://bit.ly/3yYrdbc)
   • !play Plays by Search
   • !queue Adds Song in Queue
   • !stop Stops and disconnects the bot from voice
   • !stream Streams from a url (same as yt, but doesn't predownload)
   • !volume Changes the player's volume

2. Random:

   • !choose Helps Selecting Between Words Randomly
   • !random Generates a Random Number between Input Number 1 and Input Number 2

3. Bot Management:

   • !donate Donation
   • !ping Checks Server Ping

Configuration

• .env file for Discord Bot Token
• No Other Configurations.

Currently Working On

1. Queue Feature
2. More Utility Features
3. Fun Features
4. Pause Feature
5. etc

Want to Contribute?

Check our Contribution Guidelines given in CONTRIBUTING.md