---

✨ Features

Feature	Description
🎧 Real-time Detection	Automatically detects music from Spotify, YouTube, VLC, and more
🖼️ Album Art	Fetches and displays album covers from iTunes/Deezer APIs
💿 Rotating Vinyl	Smooth rotating album art animation
🎨 5 Beautiful Themes	Cherry Blossom, Purple, Ocean, Forest, Sunset
⚙️ Fully Configurable	Position, size, opacity, rotation speed
😴 Idle Animation	Cute "Silence... ♪ zzZ" when no music is playing
🪶 Ultra Lightweight	Client-side only, 60 FPS optimized

---

🎨 Themes

🌸 Cherry Blossom (Default)

💜 Purple

🌊 Ocean

🌲 Forest

🌅 Sunset

---

⌨️ Controls

Key	Action
N	Toggle widget ON/OFF
M	Open settings menu
,	Quick cycle through themes

All keybinds are configurable in Options → Controls → Now Playing IRL

---

🎵 Supported Players

✅ Fully Supported

• Spotify (Desktop App)
• YouTube (Chrome, Edge, Firefox)
• VLC Media Player
• foobar2000
• AIMP
• MusicBee
• Winamp
• iTunes / Apple Music

🖥️ Platform Support

Platform	Status
Windows	✅ Full Support
macOS	✅ Spotify & Apple Music
Linux	✅ Via MPRIS (playerctl)

---

⚙️ Configuration

Open the config menu with M or through Mod Menu.

Option	Description	Default
Position	Widget corner position	Bottom Right
Scale	Widget size (50% - 200%)	100%
Opacity	Widget transparency	90%
Rotation Speed	Album art spin speed	Normal
Show Album Art	Display/hide cover	Visible
Theme	Color scheme	Cherry Blossom

---

📦 Installation

1. Install Fabric Loader for Minecraft 1.21.4
2. Install Fabric API
3. Download Now Playing IRL and put it in your mods folder
4. (Optional) Install Mod Menu for easy config access

---

💡 How It Works

The mod detects your currently playing music by reading window titles from media players. When music is detected:

1. 🔍 Extracts Artist and Title from the player window
2. 🌐 Fetches album artwork from iTunes/Deezer APIs
3. 🎨 Displays everything in a beautiful HUD widget
4. 💿 Animates the album cover with smooth rotation

---

❓ FAQ

Why isn't my music detected?

Make sure your media player shows the song info in its window title. Most players do this by default.

Why is there no album cover?

The mod fetches covers from iTunes/Deezer. If the song isn't in their database, a vinyl placeholder is shown instead.

Does this work on servers?

Yes! This is a client-side only mod. It works on any server without requiring server-side installation.

Does this affect performance?

No! The mod is optimized to run at 60 FPS with minimal CPU usage. Music detection runs on a separate thread.

---

🔧 Dependencies

Mod	Required
Fabric API	✅ Yes
Mod Menu	❌ Optional

---

📜 License

This mod is licensed under CC-BY-NC-4.0 License.

---