!!Activity Update!!
This repository has been inactive since 1/18/22
I am returning after a long absence to find more activity in this repository than I expected. This project is a bot I wrote for a 24 person guild and I started with minimal Python experience. Because of this, there are many mistakes and odd choices in this bot's code.
Rewrite: For simplicity
I am currently re-writing the bot to be cleaner (attempted), commented, and only support basic useful music needs. I am planning to support discord.py v2.0 and slash commands. There is no timeline on this project. When it is done, I will publish the updates to this repository.
What now?
I will ensure that the current code functions and has no major breaking issues.
DingoLingo
A Discord music bot written in Python with support for Youtube, SoundCloud, Spotify, Bandcamp, Twitter, and custom files.
Keep in mind:
- The Wiki may have the answer you are looking for https://github.com/Raptor123471/DingoLingo/wiki
- Known problems are listed in Issues. If you are interested in this project feel free to submit an Issue.
What's Coming?
- See TODO in Projects tab
Prerequisites:
API Keys
- Discord - https://discord.com/developers
- Spotify (optional) - https://developer.spotify.com/dashboard/
- Client ID
- Client Secret
- Note: Limited to 50 playlist items without API
Obtained keys must be entered into config/config.py
Requirements
- Installation of Python 3.7+
Install dependancies:
pip install -r requirements.txt
- Located in
/config
For Linux:
- ffmpeg
- libffi-dev
- libnacl-dev
Installing - Self hosting
- Download release if available, alternatively download repository zip
- Complete Prerequisites
- Start
run.pyin project root - See configuration options in /config/config.py
Button play plugin:
- Set emoji with the setting command to enable this feature
- Emote must be in same server as bot
- Needs Manage Message permissions
Custom Cookies:
- Extract cookies.txt from you browser using your preferred method
- Overwrite the existing cookies.txt in /config/cookies/
- (Optional) Set a custom cookies.txt location by modifying COOKIE_PATH in config.py
Commands:
Music
After the bot has joined your server, use $help to display help and command information.
$p [link/video title/key words/playlist-link/soundcloud link/spotify link/bandcamp link/twitter link]
- Plays the audio of supported website
- A link to the video (https://ww...)
- The title of a video ex. (Gennifer Flowers - Fever Dolls)
- A link to a YouTube playlist
- If a song is playing, it will be added to queue
Playlist Commands
$skip / $s
- Skips the current song and plays next in queue.
$q
- Show the list of songs in queue
$shuffle /$sh
- Shuffle the queue
$l / $loop
- Loop the current playing song, toggle on/off
$mv / $move
- Move song position in queue
Audio Commands
$pause
- Pauses the current song.
$resume
- Resumes the paused song.
$prev
- Goes back one song and plays the last song again.
$np
- Shows more details about the current song.
$volume / $vol
- Adjust the volume 1-100%
- Pass no arguments for current volume
$stop / $st
- Stops the current song and clears the playqueue.
General
$settings /$setting/ $set
- No Arguments: Lists server settings
- Arguments: (setting) (value)
- Use "unset" as an argument to reset a setting
- Example: $setting start_voice_channel ChannelName
- Administrators only
$c
- Connects the bot to the user's voice channel
$cc
- Switch the bot to the user's voice channel
$dc
- Disconnects the bot from the current voice channel
$history
- Shows you the titles of the X last played songs. Configurable in config.config.py
Utility
$reset / $rs
- Disconnect and reconnect to the voice channel
$ping
- Test bot connectivity
$addbot
- Displays information on how to add the bot to another server of yours.
License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.