A simple bot to control your spotify account from matrix.
This is a work in progress, and is not ready for production use. Feel free to contribute! :)
- Checkout the repository
- Build via
./gradlew build
Before deplying you need to build the project
- Create a matrix account for the bot on your favourite homeserver.
- Copy one of the
build/distributions/*files to your server, then unzip/untar the file. - Run the
bin/script. The software will create a config.json file in the same directory and exit - Create a spotify app via the spotify developer hub and get the client id and secret.
- Add
spotifyClientIdandspotifyClientSecretto theconfig.jsonfile - Run the
bin/script again - The server will print a URL to the console, open it in your browser and login with the matrix account you first created for the bot.
- Copy the redirect url and paste it into the console
- Enjoy! :)
The bot still doesn't support joining rooms.
For now, you'll need to first log in with the same account of the bot on a matrix client and join the desired room.
Then, you can send commands to the bot via any account that is in the room.
| Command | Description |
|---|---|
!login |
Prints the login url |
!search <query> |
Searches for a song |
!skip |
Skips the current song |
!playing |
Prints the currently playing song |
<spotify uri> |
Plays a song |
This project would not be possible without the help of: