Update README.md

README.md

@@ -1,13 +1,55 @@
+# 🎶 RNG Shuffle - Spotify Playlist Shuffler
+
+Welcome to **RNG Shuffle**, a Spotify-powered playlist shuffler that lets you:
+
+- Log in with your own Spotify account
+- Select one of your personal playlists
+- Shuffle the tracks using a random algorithm
+- Start playback on your active Spotify device
+
+This app works across desktop and mobile via Spotify Connect.
+
+---
+
+## 🚀 How to Use
+
+1. Click **“Log in to Spotify”**
+2. You'll be redirected to Spotify’s login page — log in and authorize the app
+3. Return to this app (you'll see a success message)
+4. Click **“Load My Playlists”** to fetch your playlists
+5. Choose a playlist and hit **“Shuffle + Play”**
+6. Playback begins on your Spotify device (must be active!)
+
+---
+
+## 🛠 Developer Notes
+
+This app is powered by:
+- [Gradio](https://www.gradio.app/) for the UI
+- [Spotipy](https://spotipy.readthedocs.io/) for Spotify API integration
+- [Flask](https://flask.palletsprojects.com/) for handling the `/callback` OAuth redirect
+
+You must register a [Spotify Developer App](https://developer.spotify.com/dashboard) and set the following redirect URI:
+https://jisaacso219-rng-shuffle.hf.space/callback
+
+Then add your Spotify credentials as **repository secrets** in Hugging Face:
+- `SPOTIFY_CLIENT_ID`
+- `SPOTIFY_CLIENT_SECRET`
+
 ---
-title: RNG Shuffle
-emoji: 🔥
-colorFrom: pink
-colorTo: indigo
-sdk: gradio
-sdk_version: 5.34.2
-app_file: app.py
-pinned: false
-short_description: RNG based playlist shuffle
+
+## 💡 Tips
+
+- Your Spotify app **must be open** and playing on a device (phone, browser, etc.)
+- This version supports **single-user login per session**
+- For multiple users or persistent tokens, OAuth session handling would need to be extended
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## 📄 License
+
+This project is for educational and personal use. Not affiliated with Spotify.
+
+
+
+