📻 Fabric Radio Mod

A fully-featured, client-side Internet Radio mod for Minecraft Fabric (1.21.4). Listen to thousands of real-world radio stations directly in your game without any external software!

✨ Features

• Live Station Search: Powered by the free Radio Browser API, giving you access to thousands of stations globally.
• Background Audio Engine: Plays MP3 streams seamlessly in a separate background thread. It will never lag or stutter your game!
• Advanced Filters: Easily sort stations by Country or Music Genre using built-in dropdown menus.
• Favorites System: Save your preferred stations with one click (★) for quick access. Export and import your favorites as a JSON file.
• Album Art: Automatically fetches and displays the current song's album cover via the iTunes API — shown in both the toast notification and the main menu.
• Interactive Metadata Toasts: See the currently playing song in an elegant, resizable corner popup (Small / Medium / Large). Click the ⛔ button to permanently blacklist annoying songs or ads.
• Song History: Browse the last 20 played songs in a dedicated screen. Click any entry to copy it to your clipboard.
• Dynamic Icons: Automatically downloads and displays station logos — supports PNG, JPEG, WEBP and ICO formats.
• Highly Customizable: ModMenu integration lets you tweak volume, toast size, popup duration, and manage your notification blacklist.

⚙️ Installation & Requirements

This is a Client-Side only mod. You do not need to install it on your server.

1. Install Fabric Loader.
2. Download and drop the radio-mod-1.2.0.jar into your .minecraft/mods folder.
3. Required: Fabric API
4. Recommended: ModMenu (to access the settings screen).

🎮 Controls

• Press R (Default) in-game to open the Main Radio Menu.
• Use the slider in the menu to adjust the radio volume independently from the game's master volume.

🌐 Languages

The mod automatically adapts to your Minecraft language settings!

• English (Default)
• Polish (Polski) - CZYTAJ PO POLSKU (README_pl.md)

📝 Changelog

v1.2.0

• NEW: Album art fetched automatically from iTunes API — displayed in toast and main menu
• NEW: Song history screen (last 20 songs) — click any entry to copy to clipboard
• NEW: Toast size selector in settings (Small / Medium / Large)
• NEW: Export & Import favorites as JSON (config/radiomod_favorites_export.json)
• FIX: Station icons now support JPEG, WEBP and ICO formats (previously only PNG worked)
• FIX: Crash (NullPointerException) when icon download failed
• IMPROVED: Main menu button layout — evenly spaced and aligned

v1.0.0

• Initial release

📝 Credits

• Developed by AnonBOT.
• Uses MP3SPI / JLayer for audio decoding.
• Station database provided by Radio Browser.
• Album art provided by iTunes Search API.

📻 Fabric Radio Mod

A fully-featured, client-side Internet Radio mod for Minecraft Fabric (1.21.4 / 26.1.2 / 26.2). Listen to thousands of real-world radio stations directly in your game without any external software!

✨ Features

• Live Station Search: Powered by the free Radio Browser API, giving you access to thousands of stations globally.
• Background Audio Engine: Plays MP3 streams seamlessly in a separate background thread. It will never lag or stutter your game!
• Advanced Filters: Easily sort stations by Country or Music Genre using built-in dropdown menus.
• Favorites System: Save your preferred stations with one click (★) for quick access. Export and import your favorites as a JSON file.
• Album Art: Automatically fetches and displays the current song's album cover via the iTunes API — shown in both the toast notification and the main menu.
• Interactive Metadata Toasts: See the currently playing song in an elegant, resizable corner popup (Small / Medium / Large). Click the ⛔ button to permanently blacklist annoying songs or ads.
• Song History: Browse the last 20 played songs in a dedicated screen. Click any entry to copy it to your clipboard.
• Dynamic Icons: Automatically downloads and displays station logos — supports PNG, JPEG, WEBP and ICO formats.
• Highly Customizable: ModMenu integration lets you tweak volume, toast size, popup duration, and manage your notification blacklist.

⚙️ Installation & Requirements

This is a Client-Side only mod. You do not need to install it on your server.

1. Install Fabric Loader for your Minecraft version.
2. Download the correct .jar for your version:
   • radio-mod-26.1.2-1.3.0.jar for Minecraft 26.1.2
   • radio-mod-26.2-1.3.0.jar for Minecraft 26.2
   • radio-mod-1.2.0.jar for Minecraft 1.21.4

• Drop the jar into your .minecraft/mods folder.
• Required: Fabric API
• Recommended: ModMenu (to access the settings screen).

🎮 Controls

• Press R (Default) in-game to open the Main Radio Menu.
• Use the slider in the menu to adjust the radio volume independently from the game's master volume.

🌐 Languages

The mod automatically adapts to your Minecraft language settings!

• English (Default)
• Polish (Polski)

📝 Changelog

v1.3.0

• NEW: Ported to Minecraft 26.1.2 and 26.2 (dual build)
• NEW: Smooth marquee scrolling with proper clipping
• IMPROVED: Adapted to 26.x rendering API (GuiGraphicsExtractor, ActiveTextCollector)
• FIX: Station list text, toast text, and album art now render correctly on 26.x
• FIX: Removed dead code

v1.2.0

• NEW: Album art fetched automatically from iTunes API — displayed in toast and main menu
• NEW: Song history screen (last 20 songs) — click any entry to copy to clipboard
• NEW: Toast size selector in settings (Small / Medium / Large)
• NEW: Export & Import favorites as JSON (config/radiomod_favorites_export.json)
• FIX: Station icons now support JPEG, WEBP and ICO formats (previously only PNG worked)
• FIX: Crash (NullPointerException) when icon download failed
• IMPROVED: Main menu button layout — evenly spaced and aligned

v1.0.0

• Initial release

📝 Credits

• Developed by AnonBOT.
• Uses MP3SPI / JLayer for audio decoding.
• Station database provided by Radio Browser.
• Album art provided by iTunes Search API.