joeyahines
/
spoticord
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
140 Commits
2 Branches
0 Tags
569 KiB
Rust 96%
Dockerfile 2%
PLpgSQL 1.8%
Shell 0.2%
 
 
 
 
Go to file
DaXcess e2d314a70c
Merge main into dev 		2024-08-22 11:14:48 +02:00
.cargo Initial v2.2.0 push 2024-08-12 16:14:24 +02:00
.githooks I guess no pre-commit formatting 2023-02-21 14:51:40 +01:00
.github General housekeeping 2024-08-19 12:05:34 +02:00
spoticord_audio Bump version number 2024-08-22 11:12:20 +02:00
spoticord_config General housekeeping 2024-08-19 12:05:34 +02:00
spoticord_database General housekeeping 2024-08-19 12:05:34 +02:00
spoticord_player General housekeeping 2024-08-19 12:05:34 +02:00
spoticord_session Bump version number 2024-08-22 11:12:20 +02:00
spoticord_stats Initial v2.2.0 push 2024-08-12 16:14:24 +02:00
spoticord_utils Initial v2.2.0 push 2024-08-12 16:14:24 +02:00
src Add update behavior settings to /playing 2024-08-19 10:50:17 +02:00
.dockerignore Initial v2.2.0 push 2024-08-12 16:14:24 +02:00
.gitignore Initial v2.2.0 push 2024-08-12 16:14:24 +02:00
CHANGELOG.md Update CHANGELOG.md 2024-08-22 10:00:47 +02:00
COMPILING.md Bump MSRV 2024-08-21 12:29:27 +02:00
CONTRIBUTING.md Initial v2.2.0 push 2024-08-12 16:14:24 +02:00
Cargo.lock Bump version number 2024-08-22 11:12:20 +02:00
Cargo.toml Bump MSRV 2024-08-21 12:29:27 +02:00
Dockerfile Fix Dockerfile 2024-08-21 11:57:27 +02:00
LICENSE Initial v2.2.0 push 2024-08-12 16:14:24 +02:00
README.md Initial v2.2.0 push 2024-08-12 16:14:24 +02:00

README.md

Spoticord

Spoticord is a Discord music bot that allows you to control your music using the Spotify app. Spoticord is built on top of librespot (with tiny additional changes), to allow full control using the Spotify client, with serenity and songbird for Discord communication. Being built on top of rust, Spoticord is relatively lightweight and can run on low-spec hardware.

How to use

Official bot

Spoticord is being hosted as an official bot. You can find more info about how to use this bot over at the Spoticord website.

Environment variables

Spoticord uses environment variables to configure itself. The following variables are required:

  • DISCORD_TOKEN: The Discord bot token used for authenticating with Discord.
  • DATABASE_URL: The URL of the postgres database where spoticord will store user data. Currently only postgresql databases are supported.
  • LINK_URL: The base URL of the account-linking frontend used for authenticating users with Spotify. This base URL must point to an instance of the Spoticord Link frontend.
  • SPOTIFY_CLIENT_ID: The Spotify Client ID for the Spotify application that is used for Spoticord. This will be used for refreshing tokens.
  • SPOTIFY_CLIENT_SECRET: The Spotify Client Secret for the Spotify application that is used for Spoticord. This will be used for refreshing tokens.

Additionally you can configure the following variables:

  • GUILD_ID: The ID of the Discord server where this bot will create commands for. This is used during testing to prevent the bot from creating slash commands in other servers, as well as generally being faster than global command propagation. This variable is required when running a debug build, and ignored when running a release build.
  • KV_URL: The connection URL of a redis-server instance used for storing realtime data. This variable is required when compiling with the stats feature.

Providing environment variables

You can provide environment variables in a .env file at the root of the working directory of Spoticord. You can also provide environment variables the normal way, e.g. the command line, using export (or set for Windows) or using docker. Environment variables set this way take precedence over those in the .env file (if one exists).

Compiling

For information about how to compile Spoticord from source, check out COMPILING.md.

Contributing

For information about how to contribute to Spoticord, check out CONTRIBUTING.md.

Contact

Discord Shield

If you have any questions, feel free to join the Spoticord Discord server!

License

Spoticord is licensed under the GNU Affero General Public License v3.0.