Updated Readme File

This commit is contained in:
brotoskyj
2025-12-31 12:20:28 -05:00
parent 547a067e54
commit 464d7f6fab
+19 -66
View File
@@ -1,76 +1,29 @@
## Welcome to RhythmWorks ## Welcome to RhythmWorks
Please use the [getting started](#getting-started) section for instructions on how to create a bot for RhythmWorks RhythmWorks is a lightweight Discord music bot designed for simple, direct audio playback from YouTube links. It focuses on manual control, minimal complexity, and local execution, making it ideal for personal servers or small communities.
### Getting Started
#### You will need to create a bot in Discord for this to work. This is not an application you can add from Discord's App Store.
1. Go to the [Discord Development Portal](https://discord.com/developers/applications)
2. Click New Application
3. Give it a name
4. Go to the OAuth2 Section
- Check mark the "bot" option under "OAuth2 URL Generator"
![botselection](images/1.png)
- Enable the Following Bot Permissions (Next Section)
- Send Messages
- Read Message History
- Connect
- Speak
![permissionsselection](images/2.png)
- Copy the Generated URL and paste it into your browser
- This will automatically launch discord and allow you to add the bot to your server
![copyURL](images/3.png)
5. Go to the "Bot" Section
- Click "Reset Token" and copy it
* **You will need to save this in a secure place. This current version does not have a save functionality and you will have to type it in every time**
![tokenReset](images/4.png)
- When you start the bot, paste the token into the prompt
6. Enable all three privileged gateway intents
![intents](images/5.png)
6. Download Necessary Files
- Windows:
- Download [yt-dlp (Windows)](https://git.racooncity.org/brotoskyj/RhythmWorks/src/branch/master/assets/yt-dlp.exe)
- Linux:
- Download [yt-dlp (Linux)](https://git.racooncity.org/brotoskyj/RhythmWorks/src/branch/master/assets/yt-dlp)
7. Place these files in the same directory as RhythmWorks
8. Keep the bot running while you want music to play
9. **IMPORTANT - You will need to !stop the currently playing track or wait for the track to finish before you start playing a new song. If you don't, the two tracks will play overtop of each other**
# Other Important Notes Unlike many modern Discord bots, RhythmWorks does not rely on hosted services or third-party dashboards. You run it yourself, connect it to your Discord server, and control playback using straightforward text commands.
1. In Windows 11, because of smartscreen and their extra security features, if the bot appears to hang once you do !play in discord, you might have to unblock yt-dlp. Right click on the file, click properties, and near the bottom uncheck the box that says this file came from the internet and is blocked
### Commands
``` ### Features
!join - Play Audio directly from YouTube
``` - Basic Playback Controls
This will join the bot to your current voice channel - Runs locally on your machine
- No external accounts or external bot hosting required
``` ### How It Works
!play https://youtube.com/full-url RhythmWorks connects to Discord using a custom bot that you generate through the Discord Developer Portal
```
This will play the youtube audio from the URL
```
!stop
```
Completely stops the bot
```
!pause
```
Pauses the currently playing track
```
!resume
```
Resumes the paused track
```
!leave
```
The bot will leave the channel
### Roadmap ### Roadmap
- Add save funtionality for Discord Bot Token
- User Interface for the admin or whoever the person is who started the bot to have a heads up display and be able to control the bot
- [Project Roadmap](https://git.racooncity.org/brotoskyj/RhythmWorks/projects/4) - [Project Roadmap](https://git.racooncity.org/brotoskyj/RhythmWorks/projects/4)
### Getting Started
Please follow the [Getting Started](https://git.racooncity.org/brotoskyj/RhythmWorks/wiki/Getting-Started) Documentation for details on how to get RhythemWorks up and running
### Discord Commands
Please review the [Commands](https://git.racooncity.org/brotoskyj/RhythmWorks/wiki/Commands) for usage
### Wiki
[RhythmWorks Wiki](https://git.racooncity.org/brotoskyj/RhythmWorks/wiki/?action=_pages) - Please review this all for all documentation
## License ## License
[AGPLv3](https://choosealicense.com/licenses/agpl-3.0/) [AGPLv3](https://choosealicense.com/licenses/agpl-3.0/)