radixsh/qubitz

Qubitz is an uwubot and a music bot that can upload custom emojis and help you find people by their roles.

Bitz? Quartz?

Qubitz is an uwubot and a music bot with custom emoji uploading capability, the ability to find people by their roles, and connectivity to The Cat API just for fun.

I began developing an uwubot named Bitz for Discord in June 2020, in discord.js because the first guides I found were in JavaScript. This turned out to be very misguided, because (as I realized when our AP Computer Science Principles teacher taught us Python and the basics of discord.py later that year) discord.py is far superior. Over the summer of 2020, I developed and hosted both bots on my Chromebook. Sometime or other I also spun up another discord.py bot, Amicitia, to help students in a university Discord server find people with the same major (majors being roles).

I've wanted to translate Bitz's uwubot functionalities to Python for a while, and I finally did, almost two years later. Bitz, the original uwubot I created, has been translated to Python and conflated with Quartz's capabilities to form Qubitz.

Development of Qubitz is stagnant. I only update when I don't have homework and want to fix a breaking change.

Functionalities

Qubitz's functionalities include:

Music

• .p[lay] <search term>: Streams the first YouTube result in vc.
• .np: Displays the current song.
• .q[ueue]: Displays the song queue.
• .rm <some song>: Removes the specified song from the queue.
• .skip: Skips the currently playing song.
• .stop: Disconnects Qubitz from vc.

Utilities

• .l[ist]: Lists each role and everyone in them.
• .f[ind] <some role>: Prints a list of everyone with the specified role.
• .p[ing]: Pokes Qubitz to see if they're awake.
• .up[time]: Displays how long Qubitz has been awake.
• .i[nfo] ("all"): Displays guild and channel information, and if "all" is given as an argument, then displays guild member information as well.

Miscellaneous

• .create <emoji_name>: Sets attached image as a custom server emoji with the given name.
• .uwu[ify] <something>: Uwuifies your message, deleting the command message.
• .echo <something>: Echoes back your message, deleting the command message.
• .c[at]: Shows a cat from The Cat API.

Technologies

• discord.py
  • discord.ext.commands
• Discord API
• node.js
  • nodemon
• The Cat API

Usage

To set Qubitz up locally, you'll need python3 and the packages for discord, requests, and aiohttp.

You'll also need an API token, which you get by creating an application in your Discord developer portal. Click the subheading "bot" in the menubar on the left and add a bot, and a secret token will have been generated under the bot's username.

Create a file called env.py with this as its contents:

TOKEN = "your-token-here-between-quotes"

In the developer portal again, under Bot, enable the server members and message content intents. Under OAuth2 > URL Generator, generate an invite link by selecting the "bot" scope and adding the following permissions:

• Read Messages / View Channels
• Send Mesages
• Manage Messages
• Embed Links
• Attach Files
• Use External Emojis
• Add Reactions

Then you can run Qubitz with python3 index.py (or nodemon --exec python3 index.py).

Acknowledgements

• aiohttp documentation, especially this comparison between aiohttp and requests
• discord.js guide
  • Getting user input
  • Adding more commands
  • Creating embeds
  • Some basic es6 syntax examples
  • Dynamically executing commands
  • Miscellaneous examples, including playing music from YouTube and retrieving emoji characters from another file created in the same directory as index.js
• How to create a music bot (Free Code Camp)
• Adding a config file (An Idiot's Guide) – This was helpful for conceptualizing the flow of order when the bot is running under nodemon. Using a config file taught me how the config file responds to calls from the index file.
  • Understanding roles and permissions
• And, of course, places where people before me have asked questions:
  • Get a picture from a message (Stack Overflow)
  • Take file as argument (Stack Overflow)
  • Discord bot send attachments (Reddit): pointed me to aiohttp
  • Using nodemon with python3 (Stack Overflow)
• Eric Yeung's Discord music bot (GitHub)
• discord.py documentation, particularly:
  • Cog documentation
    • Coggification example (Stack Overflow)
  • Voice client documentation

Bitz was named by my close friend Tumega500#1234.

License

Released under GNU GPL v3.