✧ Junimo Jams ✧

Your Music. Your Farm. Your Vibe.

"Why pause your cozy farm life to check a song title, when the music can flow right through the valley?"

🌿 The Story

You’re watering your crops as the sun sets over Pelican Town, and a perfect song starts playing. You want to know what it is. You Alt+Tab to check, the cozy immersion breaks, you miss the sunset, and Pierre’s shop is closed by the time you tab back in.

Never again.

Junimo Jams (formerly Spotify Valley) is a premium, lightweight, and highly customizable in-game HUD that bridges the gap between your farm and your music. It dynamically fetches track details, high-res covers, and provides full media control—all integrated seamlessly into Stardew Valley’s gorgeous interface.

No matter if you use Spotify, YouTube Music, Apple Music, or high-fidelity local players like TIDAL—Junimo Jams has you covered.

📜 Changelog

You can find the detailed changelog and version history for each update directly on the GitHub Releases page or under the changes tab on Nexus Mods.

✨ Premium Features

🖼️ Real-Time Album Art Search
- Automatically searches and retrieves high-resolution covers.
- Uses an advanced Jaccard similarity algorithm to ensure 99% matching accuracy even for generic/browser playing states.
🎮 Tactile HUD Controls
- Prev, Play/Pause, and Next buttons rendered directly onto the HUD frame.
- Control your music instantly without ever tabbing out of the game.
🎨 Cozy Theming Engine
- Comes with multiple handcrafted themes, including:
- Overgrown Grass Flowery — Adorned with delicate vines and flowers.
- Stardew Valley Wood — The classic, warm wood aesthetic.
🔤 Universal Character Map
- Turkish, Cyrillic, and special international characters are automatically normalized.
- No more broken fonts, empty glyph boxes, or weird text rendering.
🐧 True Cross-Platform
- Built to run flawlessly on Windows, macOS, and Linux (fully integrated with MPRIS2 desktop audio protocols).
⚡ Zero Performance Impact
- Features a smart local caching system for album covers and redraws only when state changes.
- Your FPS remains completely untouched.

🎧 Supported Music Players

Category	Supported Players & Clients
🎵 Streaming	Spotify • YouTube Music (Browser) • Apple Music • Amazon Music
🚀 High-Fidelity	TIDAL • Deezer • Cider • Plexamp
📼 Classic Desktop	iTunes • foobar2000 • MusicBee • AIMP • Winamp • VLC • Strawberry • Rhythmbox
⚙️ Custom	Add any process name to `ExtraPlayers` in `config.json` (Auto-detects MPRIS2 on Linux)

⚙️ How to Install & Configure

SMAPI: Download and install the latest version of SMAPI.
GMCM (Optional): Install Generic Mod Config Menu for in-game configuration.
Install: Download Junimo Jams and extract the folder into your Stardew Valley/Mods/ directory.
Enjoy: Launch the game, open your favorite player, and enjoy the music!

🎨 Want to Create a Custom Theme?

Drop your custom .png assets in: Mods/JunimoJams/assets/your_theme_name/

background.png (400x150 px) — The HUD frame
btn_play.png / btn_pause.png / btn_next.png / btn_prev.png (128x128 px) — The controls

Select your theme instantly inside the game config menu. See assets/THEME_SPEC.md for full design guidelines.

💬 A Message From the Developer

"I built the original version of this mod because I kept dying in the Skull Cavern while alt-tabbing to check a song name in my playlist. It was a tragedy. This mod saved my farm, and I hope it brings a touch of melody to yours."

— MehmetCanWT 🌻

Stardew Valley is a trademark of ConcernedApe LLC. This mod is an independent creation and not affiliated with ConcernedApe, Spotify, Apple, Google, or any other music platform.