meoww-player

# 🐾 Meoww Player — The Ultimate In-Game Music Experience

Meoww Player brings a modern, luxury music player directly inside Minecraft! Stream songs online, import YouTube & Spotify playlists with a single keypress, broadcast your playing music to Discord with real-time seek bars, and groove to dynamic audio visualizers on your HUD — all with zero FPS loss.

---

## ✨ Key Features

### 🔴 YouTube & YouTube Music Support
- **Playlist Imports:** Paste any playlist URL from YouTube or YouTube Music into the in-game search bar.
- **Fast Playlist Engine:** Automatically extracts tracks with real titles, artists, and HD album art.
- **Save Collections:** Save imported playlists into your in-game playlist collection for instant 1-click access.

### 💚 Spotify Playlist & Album Support
- Copy any track, album, or playlist link from Spotify and press **Ctrl + V** in the in-game search bar.
- Loads track information seamlessly with instant playback.

### 🎵 High-Quality Music Streaming
- **Global Search:** Search millions of tracks with high-definition artwork powered by top CDNs.
- **Built-in Procedural Synthesizer:** Even when offline or without an internet connection, enjoy built-in procedural electronic tracks!
- **Local Audio Files:** Drop your own .mp3, .wav, or .aac tracks into .minecraft/meoww/local/ for local listening.

### 🎮 Spotify-Style Discord Rich Presence (RPC)
- Broadcasts your music status on Discord with an authentic seek bar, elapsed/remaining time, song title, artist, and album cover!
- Updates in real-time when you pause, play, or scrub forward/backward.
- Lightweight, zero-dependency background service with zero FPS drop.

### 📊 Real-Time Equalizer & Boss Bar HUD
- **In-Game Boss Bar HUD:** Displays song title, artist, live playback progress, and mini visualizer bars at the top of your screen.
- **8-Band Dynamic Spectrum Visualizer:** Ultra-responsive dynamic frequency analyzer with smooth gravity decay.
- **Sleek HUD Toasts:** Clean notifications appear when skipping songs or adjusting volume.

### 🛡️ Smart Danger Ducking
- Automatically lowers music volume when Creepers hiss, Wardens are nearby, or when your health drops below 3 hearts.
- Automatically pauses when you die and resumes when you respawn.

### 🌸 5 Aesthetic Themes & Animated Vinyl
- Choose between Cosmic Nebula, Cyberpunk Night, Cherry Blossom, Lo-Fi Rain, and Deep Void.
- Interactive turntable with spinning album art labels and specular reflections.

### ⚡ Ultra-Optimized Performance (Zero-Lag)
- **Client-Side Only:** Works on any multiplayer server, Realms, and singleplayer worlds without needing server installation.
- **Async Decoding:** Album art decodes on background threads — zero stutter when scrolling song lists.

---

## ⌨️ Controls & Keybindings

All shortcuts are fully customizable in Minecraft's **Options ➜ Controls ➜ Key Binds ➜ Meoww Music Player**:

| Action | Default Key | Description |
| :--- | :---: | :--- |
| **Open Music Player** | `M` | Opens the full Meoww GUI |
| **Play / Pause** | `P` | Toggle playback instantly |
| **Next Track** | `Right Arrow` | Skip to the next track |
| **Previous Track** | `Left Arrow` | Go to the previous track |
| **Volume Up** | `Up Arrow` | Increase master volume |
| **Volume Down** | `Down Arrow` | Decrease master volume |
| **Toggle Boss Bar HUD** | `H` | Show/hide top music bar |

---

## 💡 How to Import Playlists

1. Open YouTube, YouTube Music, or Spotify.
2. Copy the URL of any playlist, album, or song.
3. Open Meoww Player in Minecraft (`M`).
4. Click the search bar and press **Ctrl + V**.
5. Your tracks will load instantly! Click **Save Playlist** to keep them in your Playlists tab.

---

## 📁 Custom Assets & Offline Music

Meoww Player automatically creates user folders in your `.minecraft` directory:
- `.minecraft/meoww/backgrounds/` — Drop custom .png or .jpg wallpapers for the player GUI.
- `.minecraft/meoww/playlists/` — Saved playlists stored in clean JSON format.

---

## ❓ Frequently Asked Questions (FAQ)

- **Does this mod require server installation?**
  No! Meoww Player is 100% client-side. You can join vanilla servers, Hypixel, Realms, or modded servers without needing the server to install it.

- **Will this cause in-game lag?**
  No. Audio processing, networking, and album art decompression run entirely on dedicated background daemon threads.

- **Does Discord RPC require extra software or DLLs?**
  No! It uses a pure Java native IPC implementation over Discord's local pipe (`discord-ipc-0`) with zero external DLLs.

---

## 📜 License
Distributed under the **MIT License**.