🎵 Spotify Live Banner

Show off what you're jamming to, right on your GitHub profile! 🎧

Ever wanted your GitHub profile to scream "Look at my awesome music taste!"? Well, now it can! This widget displays your current Spotify track in real-time with cool animations. It's like having a mini music player on your profile! 🎶

---

---

Visitors 👀:

---

✨ Features at a Glance

• 🎵 Real-time Updates - Shows what you're listening to RIGHT NOW.
• 🎨 Premium Aesthetics - High-end Glassmorphism, Dark mode, and Animated gradients.
• 🌈 Adaptive Theming - Matches banner colors to your current album art automatically.
• 🆓 100% Free & Open Source - Deploy on free platforms, own your data.
• ⚡ Optimized Performance - Pure SVG generation for zero latency and high compatibility.
• 🔒 Privacy First - You control your API keys and playback data.

---

Details

🚀 Quick Start & Deployment

Think of this like ordering a pizza: first you grab the ingredients, then you get your secret recipe keys, and finally, you bake it in the cloud! 🍕

🍕 1. Order the Ingredients (Clone Repo)

git clone https://github.com/SahooShuvranshu/Spotify-Live-Banner.git
cd Spotify-Live-Banner/source

🎫 2. Get Your VIP Pass (API Keys)

We made it SUPER easy with a web tool!

👉 Get Token Here 👈

Or use Last.fm:

• Visit Last.fm API to get your key.

🚀 3. Bake to Cloud (Deploy)

⚡ Vercel (Recommended - Never Sleeps!)

🛤️ Railway

✨ Render

🏠 Local Hosting (For Power Users)

Want to run it on your own machine? It's simple:

1. Clone the Repo:

   git clone https://github.com/SahooShuvranshu/Spotify-Live-Banner.git
   cd Spotify-Live-Banner/source

2. Setup Secrets: Create a .env file in the source folder and add your Spotify/Last.fm keys.
3. Install Dependencies:

   pip install -r requirements.txt

4. Fire it up:

   DEV_SERVER=1 python main.py

---

🎨 Personalize Your Widget

You can customize almost everything by adding parameters to your URL!

📋 Customization Table

Parameter	Options	Default	Purpose
recently_playing	true, false	false	Fallback to last track if not live.
adaptive	true, false	false	Match colors to album art.
blur	true, false	false	Blurred background effect.
theme	light, dark, glass	light	Visual aesthetic style.
spin	true, false	false	Vinyl record animation.
eq_color	Hex, rainbow	1DB954	Visualizer bar color.

---

🎭 Style Gallery

Choose the look that fits your profile! Click a category to see the magic. ✨

🌈 Core Aesthetics (Light, Dark, Glass)

Default (Clean and Simple):
https://spotify-live-banner.vercel.app/

Midnight Mode (For Dark Theme Profiles):
https://spotify-live-banner.vercel.app/?theme=dark

iOS Glass (Modern Glassmorphism):
https://spotify-live-banner.vercel.app/?theme=glass

🧠 Intelligent Effects (Adaptive, Blur, Recent)

Adaptive Glass (Tints to match album art):
https://spotify-live-banner.vercel.app/?theme=glass&adaptive=true

Artwork Blur (Deep immersive background):
https://spotify-live-banner.vercel.app/?blur=true

Recently Played (Never show an empty banner):
https://spotify-live-banner.vercel.app/?recently_playing=true

🎨 Visual Accents (Spin, Rainbow, Scan)

Vinyl Player (Spinning Record):
https://spotify-live-banner.vercel.app/?spin=true

Rainbow Visualizer (Prism Audio):
https://spotify-live-banner.vercel.app/?eq_color=rainbow

Custom Hex Color (e.g. Deep Blue):
https://spotify-live-banner.vercel.app/?eq_color=0000FF

Spotify Scan Code (Mobile Playback):
https://spotify-live-banner.vercel.app/?scan=true

🔥 Ultimate Mode (Everything enabled!)

The Works (Spin + Scan + Dark + Rainbow):
https://spotify-live-banner.vercel.app/?spin=true&scan=true&theme=dark&eq_color=rainbow

---

🛠️ Integration & Usage

Ready to show off? Copy the snippets below and replace https://your-url.com/ with your actual hosted URL.

Markdown Snippet (Best for GitHub Profile)

[![Listening](https://your-url.com/)](https://your-url.com/about)

HTML Implementation

<a href="https://your-url.com/about">
  <img src="https://your-url.com/" alt="Live Status" />
</a>

---

📁 Project Structure

.
├── .github/
│   ├── CODE_OF_CONDUCT.md     # Community standards
│   ├── CONTRIBUTING.md        # How to help
│   ├── GEMINI.md              # Project memory
│   └── SECURITY.md            # Security policy
├── Images/                    # Static assets (logos)
├── source/                    # Main Application Source
│   ├── app/
│   │   ├── modules/           # Core logic (API, Parsing)
│   │   ├── static/            # Base64 static assets
│   │   └── templates/         # SVG and HTML templates
│   ├── main.py                # Entry point
│   └── requirements.txt       # App dependencies
├── app.json                   # Heroku deployment config
├── railway.json               # Railway deployment config
├── render.yaml                # Render deployment config
└── README.md                  # This beautiful file!

---

🌟 Star History

🤝 Community & Support

We are growing! This project is powered by the open-source community. If you enjoy using this banner, consider giving us a star!

• Official Email: connect.crystalstudio@gmail.com
• Discord: Join our community for real-time help! Invite Link
• Issues: Found a bug? Report it here
• Contribute: Check out our Contributing Guide!

---

© 2026 SahooShuvranshu. All rights reserved.

Inspired by Spotify-Readme by tthn0 🚀

Independent Open Source Project. Not affiliated with Spotify AB or Last.fm.