2 Commits

Author SHA1 Message Date
c607aaf403 updated image in README.md 2024-08-12 13:37:10 +02:00
f41fa7e09b updated README.md 2024-08-12 13:36:36 +02:00
3 changed files with 82 additions and 50 deletions

51
Cargo.lock generated
View File

@@ -90,13 +90,32 @@ version = "1.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0" checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0"
[[package]]
name = "audiopus"
version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3743519567e9135cf6f9f1a509851cb0c8e4cb9d66feb286668afb1923bec458"
dependencies = [
"audiopus_sys 0.1.8",
]
[[package]] [[package]]
name = "audiopus" name = "audiopus"
version = "0.3.0-rc.0" version = "0.3.0-rc.0"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ab55eb0e56d7c6de3d59f544e5db122d7725ec33be6a276ee8241f3be6473955" checksum = "ab55eb0e56d7c6de3d59f544e5db122d7725ec33be6a276ee8241f3be6473955"
dependencies = [ dependencies = [
"audiopus_sys", "audiopus_sys 0.2.2",
]
[[package]]
name = "audiopus_sys"
version = "0.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "927791de46f70facea982dbfaf19719a41ce6064443403be631a85de6a58fff9"
dependencies = [
"log",
"pkg-config",
] ]
[[package]] [[package]]
@@ -149,21 +168,6 @@ version = "0.22.1"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6" checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
[[package]]
name = "bit-set"
version = "0.5.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0700ddab506f33b20a03b13996eccd309a48e5ff77d0d95926aa0210fb4e95f1"
dependencies = [
"bit-vec",
]
[[package]]
name = "bit-vec"
version = "0.6.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "349f9b6a179ed607305526ca489b34ad0a41aed5f7980fa90eb03160b69598fb"
[[package]] [[package]]
name = "bitflags" name = "bitflags"
version = "1.3.2" version = "1.3.2"
@@ -642,17 +646,6 @@ version = "0.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "af9673d8203fcb076b19dfd17e38b3d4ae9f44959416ea532ce72415a6020365" checksum = "af9673d8203fcb076b19dfd17e38b3d4ae9f44959416ea532ce72415a6020365"
[[package]]
name = "fancy-regex"
version = "0.13.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "531e46835a22af56d1e3b66f04844bed63158bc094a628bec1d321d9b4c44bf2"
dependencies = [
"bit-set",
"regex-automata 0.4.7",
"regex-syntax 0.8.4",
]
[[package]] [[package]]
name = "fastrand" name = "fastrand"
version = "2.1.0" version = "2.1.0"
@@ -1351,8 +1344,8 @@ dependencies = [
name = "lyra" name = "lyra"
version = "0.10.0" version = "0.10.0"
dependencies = [ dependencies = [
"audiopus 0.2.0",
"dotenv", "dotenv",
"fancy-regex",
"json", "json",
"lib-spotify-parser", "lib-spotify-parser",
"once_cell", "once_cell",
@@ -2832,7 +2825,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "338dd182f9f084f583c4c0db38588e28a34778ecec288208cf0b61c378ac90d1" checksum = "338dd182f9f084f583c4c0db38588e28a34778ecec288208cf0b61c378ac90d1"
dependencies = [ dependencies = [
"async-trait", "async-trait",
"audiopus", "audiopus 0.3.0-rc.0",
"byteorder", "byteorder",
"bytes", "bytes",
"crypto_secretbox", "crypto_secretbox",

View File

@@ -4,7 +4,7 @@ version = "0.10.0"
authors = ["Michał Czyż <mike@c2yz.com>"] authors = ["Michał Czyż <mike@c2yz.com>"]
edition = "2021" edition = "2021"
description = "A featureful Discord bot written in Rust." description = "A featureful Discord bot written in Rust."
documentation = "https://lyra.c2yz.com/docs" documentation = "https://github.com/eRgo35/lyra"
readme = "README.md" readme = "README.md"
homepage = "https://lyra.c2yz.com" homepage = "https://lyra.c2yz.com"
license-file = "LICENSE.md" license-file = "LICENSE.md"
@@ -13,9 +13,7 @@ keywords = ["discord", "bot", "rust", "music", "featureful"]
[dependencies] [dependencies]
lib-spotify-parser = { path = "./libs/spotify-parser" } lib-spotify-parser = { path = "./libs/spotify-parser" }
dotenv = "0.15.0" dotenv = "0.15.0"
fancy-regex = "0.13.0"
json = "0.12.4" json = "0.12.4"
openssl = { version = "0.10.66", features = ["vendored"] }
owoify = "0.1.5" owoify = "0.1.5"
poise = { default-features = true, version = "0.6.1" } poise = { default-features = true, version = "0.6.1" }
rand = "0.8.5" rand = "0.8.5"
@@ -49,6 +47,8 @@ tracing-futures = "0.2.5"
tracing-subscriber = "0.3.18" tracing-subscriber = "0.3.18"
url = "2.5.2" url = "2.5.2"
once_cell = "1.19.0" once_cell = "1.19.0"
openssl = { version = "0.10.66", features = ["vendored"] }
audiopus = "0.2.0"
[patch.crates-io.serenity-voice-model] [patch.crates-io.serenity-voice-model]
git = "https://github.com/serenity-rs/serenity" git = "https://github.com/serenity-rs/serenity"

View File

@@ -1,52 +1,82 @@
# Lyra <h2 align="center">
<a href="https://lyra.c2yz.com" target="blank_">
![](assets/lyra-256.png) <img height="256" alt="Lyra" src="assets/lyra-256.png" />
</a>
Lyra is a music bot written in Rust. <br />
Lyra: a discord music bot written in Rust :crab:
## Getting Started </h2>
Lyra is an open source, discord music bot written in Rust. Lyra is an open source, discord music bot written in Rust.
The idea behind this project is to allow a user to self-host one's own instance of the bot. The idea behind this project is to allow a user to self-host one's own instance of the bot.
User no longer has to rely on 3rd-parties to provide them a service.
The bot can be run on a desktop, a vps or a phone as it's just a simple binary.
User no longer has to rely on 3rd parties to provide them an invite link. Currently bot is still heavily in development!
The bot can be run even on a desktop or a phone because after compilation, it's just a simple binary. ## Getting started
As of now, the bot supports spotify url track recognition through a separate nodejs script. I plan to write the actual parser inside the bot iteself but as of now I postponed it into future release. Before you start, you need to create a discord bot and get a token.
You can do it [here](https://discord.com/developers/applications).
Slash commands are still work in progress! Currently bot is still heavily in development! After you create a bot, you need to invite it to your server.
## Setting up Then, head to download section and download the latest release (or compile it yourself).
After you download the binary, you need to create a `.env` file in the same directory as the binary.
Example can be found in `.env.example` file.
```
DISCORD_TOKEN=<YOUR_DISCORD_TOKEN>
PREFIX=<YOUR_PREFIX>
```
DISCORD_TOKEN is the token you got from discord developers page and PREFIX is the prefix you want to use for your bot.
Bot by default reacts only to the prefix. To enable slash commands, while the bot is running type `:register` in the chat (where `:` is your bot prefix).
## Features
- Music playback
- Audio effects (soon)
- Some multipurpose commands
- Slash commands
- Self-hosted
## Compilation
To compile the source code on your own, you need `rust` and `cargo` To compile the source code on your own, you need `rust` and `cargo`
To run a dev version use To run a dev version, `cd` into the project directory and type
```bash ```bash
$ cargo run $ cargo run
``` ```
To build a production version use To build a production version use
```bash ```bash
$ cargo build --release $ cargo build --release
``` ```
If you need an ARM version and just don't want to wait for ages for the program to compile, use If you need a version for a different system or architecture, you can use `cross` crate
```bash ```bash
$ cross build -r --target aarch64-unknown-linux-gnu $ cross build -r --target aarch64-unknown-linux-gnu
``` ```
To run a program, just type To run a program, just type
```bash ```bash
$ ./lyra $ ./lyra
``` ```
if you want to disown it from the shell, I recommend using the script I provided in `scripts` folder Remember to provide a `.env` file in the same directory as the binary.
If you want to disown the bot from the shell, I recommend using the script I provided in `scripts` folder
## Commands ## Commands
As of now, working commands are: As of now, the commands are:
``` ```
Music: Music:
@@ -60,7 +90,7 @@ Music:
/repeat Loops currently playing song provided amount of times; aliases: repeat, loop, while, for /repeat Loops currently playing song provided amount of times; aliases: repeat, loop, while, for
/resume Resumes currently paused song /resume Resumes currently paused song
/seek Seeks a track by provided seconds /seek Seeks a track by provided seconds
/skip Skips the currently playing song /skip Skips the currently playing song; aliases: skip, :skipper:
/stop Stops playback and destroys the queue; aliases: stop, end /stop Stops playback and destroys the queue; aliases: stop, end
/volume Changes output volume /volume Changes output volume
/effect Plays one of available audio effects /effect Plays one of available audio effects
@@ -69,13 +99,22 @@ Music:
Tools: Tools:
/ai Asks AI /ai Asks AI
/dice Rolls a dice /dice Rolls a dice
/dictionary Explains provided query
/ip Shows IP information
/metar Prints metar for provided airport
/owoify Owoifies whatever you want uwu /owoify Owoifies whatever you want uwu
/ping Pings you backs with a response time /ping Pings you backs with a response time
/posix Prints current time in POSIX format /posix Prints current time in POSIX format
/qr Creates a qr code from text /qr Creates a qr code from text
/taf Returns taf for provided airport
/uptime Checks how long the bot has been running
/verse Reference Bible by verse /verse Reference Bible by verse
/weather Shows weather for provided location
Help: Help:
/help Prints this help message; aliases: help, huh, welp /help Prints this help message; aliases: help, huh, welp
Use /help command for more info on a command.
You can edit you message to the bot and the bot will edit its response.
``` ```