!!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

1. Download release if available, alternatively download repository zip
2. Complete Prerequisites
3. Start run.py in project root
4. 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.

Acknowledgments

https://github.com/adriansteffan/DiscordJockey