Skip to main content
Sign in
Snippets Groups Projects

DiscordJoke

Star 0
Project ID: 80579418
Select Git revision
  • main default protected
1 result
  • Open with
  • Download source code
  • Your workspaces

      A workspace is a virtual sandbox environment for your code in GitLab.

      No agents available to create workspaces. Please consult Workspaces documentation for troubleshooting.

    • capybaracascade's avatar
    Add theme

    Most recent commit.

    capybaracascade authored
    84f0e41e
    History
    capybaracascade's avatar 84f0e41e
    History
    Name Last commit Last update
    config Initial import
    musicbot Initial import
    LICENSE.txt Initial import
    README.md Edit
    Startup.bat Edit typo
    Startup.sh Edit typo
    ffmpeg.exe Initial import
    run.py Add theme
    README.md

    DiscordJoke

    DiscordJoke is an open source, lightweight musicbot for Discord. It was written in python using Discord.py. It can stream music from sites like youtube straight to your Discord voice channels and helps you create a more chill atmosphere while enjoying your favourite games.

    This bot is somewhat outdated and could therefore not function as intended. Fixing it is on my backlog, so do not worry :)

    Getting Started

    (To learn more about the features of DiscordJoke, type !help in your serverchat or read the documentation below.)

    I am no longer hosting this bot as I am working on an improved version with a whole lot more features. Also, some features could break by changes being made to the official repo of discord.py in the future, so be aware of that.

    If you want to run the bot on your local machine or a server, see the instructions below.

    Prerequisites

    You need to have a version of python 3.5+ installed on your machine. If you are windows, make sure that the executable is added to PATH. How to do it on Windows 10

    You also need the newest versions of aiohttp, youtube-dl and bs4, as well as the rewrite version of Discord.py. To install those, simply us ethe following pip command

    pip install -U aiohttp youtube-dl bs4 git+https://github.com/Rapptz/discord.py@rewrite#egg=discord.py[voice]

    On Linux, you might also need to install some additional packages:

    apt-get install libffi-dev libnacl-dev python3-dev ffmpeg

    Installing - Hosting the bot yourself

    The setup is really straight forward. First, you need to create a new application here and turn it into a Bot-User via the "Add" button on the "Bot" menu. Next, you need to add the bot to your server. Here is a simple explanation on how to do that. Now you need to reveal and copy the token of the bot.

    At last, you need to download this repository, copy it to wherever you like, insert the token at the top of the "config/config.py" file (save it) and run the startup.bat or startup.sh script, based on you OS. Alternatively, you can also run the run.py script with python via your console from the root directory of the project.

    The bot should join you server automatically.

    Usage

    After the bot has joined your server, you can pm him !help or write it in a textchannel to get an overview of the available commands. At the moment, the following commands are supported:

    !connect [channel (optional)]
    • Connects the bot to a voice channel. Connects to the first one if no name is specified or the channel does not exist.
    !disconnect
    • Disconnects the bot from the current voice channel.
    !cc [channel]
    • Moves the bot to another channel.
    !addbot
    • Displays information on how to add the bot to another server of yours.
    !yt [link/video title/key words/playlist-link]
    • Plays the audio of a Youtube video. The argument can either be:
      • A link to the video (https://ww...)
      • The title of a video (Rick Astley - Never Gonna Give You Up)
      • Keywords for a search(lofi hip-hop) - the bot plays the first result
      • A link to a playlist - the bot plays the songs in order
    • If the player is already playing, the command adds the song to a queue and plays them in succession
    !spotify [nickname (optional)]
    • Gives you an easy way to share a song from Spotify via the bot.
      • Spotify needs to be linked to your Discord account for this to work.
      • The command takes the song that is being played by your Spotify client and plays it on the bot via Youtube.
      • You can target another users client by specifying his nickname as an argument.
      • The song has to be playing for the command to launch, so you need to listen for the first few seconds of the song while the bot loads it up.
      • If the player is already playing, the command adds the song to the playingqueue.
      • The bot is not 100% accurate and plays slightly different versions of the songs every now and then.
    !pause
    • Pauses the current song.
    !resume
    • Resumes the paused song.
    !stop
    • Stops the current song and clears the playqueue.
    !skip
    • Stops the current song and plays the next one in the queue.
    !prev
    • Goes back one song and plays the last song again.
    !vol [volume in %]
    • Changes the volume of the music player. (0-200%)
    !songinfo
    • Shows more details about the current song.
    !history
    • Shows you the titles of the 15 last played songs.

    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

    Shoutout to the community over at the Discord-API Discord servers, who gave me a helping hand when the Rewrite library gave me headaches.