/RiRa

RiRa is a minimalistic Discord bot that allows you to play music on your server. Easily play music via search, Youtube, or Spotify.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0


rira


Discord server Python Application Test Python Version LICENSE

About

RiRa is a minimalistic Discord bot that allows you to play music on your server.

  • Play Spotify tracks
  • Play Youtube tracks
  • Search music with query
  • Control volume
  • Built-in queue feature

Pending:

  • Adding Spotify playlists
  • Shuffle queue
  • Range based track removal

Setup

Python3 is required.
Open terminal in project directory and execute:

pip install pipenv
pipenv install

Create config.toml in the project directory:

"token"="your_discord_token_here"
"prefix"="!"
"version"="v0.1"

[music]
"max_volume"=250
"vote_skip"=true
"client"="your_spotify_client_id_here"
"secret"="your_spotify_secret_here"

Other Requirements

  • ffmpeg (Ensure added to PATH)
  • opus (Ensure added to PATH)

Starting up

Open terminal in project directory and execute the following:

pipenv shell
python -m rira

The logs will be saved in rira.log

RiRa Commands

Command Alias Task Example
!play !p To play music !p songname or youtube link or spotify url
!nowplaying !np, !current Shows currently playing music !np
!queue !q, !view View the queue !q
!remove !r, !del Removes music from the queue !r 1
!clear !c, !cq Clears the queue !c
!pause !ps Pauses the music !ps
!resume !rs Resumes the music !rs
!skip !fs Skips the music !fs
!disconnect !dc, !leave To make RiRa leave the voice channel !dc
!volume !v, !vol To change the volume !v 250
!ping !pi Returns the latency !pi
!credits !cr Returns the credits !cr

Links

Contributing

Before creating an issue, please ensure that it hasn't already been reported/suggested.

The issue tracker is only for bug reports and enhancement suggestions. If you have a question, please ask it in the [Discord server] (https://discord.gg/aMgWPApkyS) instead of opening an issue – you will get redirected there anyway.

If you wish to contribute to the RiRa codebase or documentation, feel free to fork the repository and submit a pull request.

Help

If you don't understand something in the documentation, you are experiencing problems, or you just need a gentle nudge in the right direction, please don't hesitate to join our [Discord Server] . (https://discord.gg/aMgWPApkyS).