From a5e3fc40eecc103ad07b9571e3a6d5e390f3cc44 Mon Sep 17 00:00:00 2001 From: alex Date: Wed, 22 Jul 2026 20:13:45 +0200 Subject: added readme --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..c352c3a --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +# Spotify Discord Profile Widget Bot + +A Discord bot that connects Spotify accounts to update Discord Profile Identity widgets with real-time listening statistics (Top Songs, Top Artists, Top Albums, and Recently Liked tracks). + +--- +![League Widget Preview](https://cdn.discordapp.com/attachments/690492442050297886/1529539532419104909/image.png?ex=6a624e31&is=6a60fcb1&hm=9f6558980e43cb6132a75378137015a32ef2429be4a1618cd5cbee8a9d9cd052&) + +## Setup Guide + +### 1. Install Dependencies + +This project uses **uv** for fast dependency management. + +Install the required packages into your virtual environment: + +```bash +uv pip install discord.py spotipy aiohttp python-dotenv + +``` + +*(If you are managing the project using a `pyproject.toml` file, you can run `uv sync` instead.)* + +### 2. Environment Configuration + +Create a `.env` file in the root directory and add your API credentials: + +```env +SPOTIFY_CLIENT_ID=your_spotify_client_id +SPOTIFY_CLIENT_SECRET=your_spotify_client_secret +SPOTIFY_REDIRECT_URI=http://localhost:8888/callback + +DISCORD_BOT_TOKEN=your_discord_bot_token +DISCORD_APP_ID=your_discord_application_id + +``` + +> **Note:** Ensure `http://localhost:8888/callback` is listed under the Redirect URIs in your Spotify Developer Dashboard settings. + +--- + +## Running the Bot + +Run the bot script directly using `uv`: + +```bash +uv run main.py + +``` + +--- + +## Bot Commands + +| Command | Description | +| --- | --- | +| `/spotify_login` | Generates a Spotify authorization link to start account linking. | +| `/submit_code` | Submits the OAuth code or callback URL to finish linking your account. | +| `/range` | Sets the preferred timeframe for statistics (e.g. `7d`, `4w`, `6m`, `1y`). | +| `/update_widget` | Forces an immediate refresh of your Discord profile widget payload. | \ No newline at end of file -- cgit v1.2.3