Kiku - https://kiku.kittenzexe.com

An API to get your Spotify status through discord

Note

Discord bot is not open source right now, expect it to be added later.

Links

• default api - https://kiku.kittenzexe.com/v1/your_user_id
• websocket - wss://kiku.kittenzexe.com/v1/your_user_id
• user page - https://kiku.kittenzexe.com/v1/user/your_user_id

Setup

• Join my discord (Where I have the bot hosted)
• Go to #commands and use /register
• Head over to https://kiku.kittenzexe.com/v1/your-user-ID (See below how to get your user ID if you don't know how to)
• Thats it! If you are currently listening to something on Spotify, it should appear!

How to get you user ID

Using the Kiku Bot

• Use /userid to get your user ID.

Discord developer mode

• If you havent enabled developer mode before, follow these steps
  • Go to your settings
  • Scroll down to advanced
  • Enable Developer Mode
• Then right click your profile and down the bottom you should see Copy User ID

Examples

On a website

(using websocket connection on my personal website!)

Example for livestream overlay

• Kiku-Livestrean (This is what I use for my streams)

Running

For local dev

• npm install
• npx ts-node src/app.ts
• localhost:1545

For Docker

• docker-compose up -d
• localhost:1545

Contributing

Any contribution is welcome. This has been an off and on project for the past few weeks so my horrible code might need some fixes. I plan to implement some more features in the future though so be prepared.

License

Under the GNU Affero General Public License v3.0

Star History