Media HUD

Full Description

Media HUD adds a local media player directly to the Minecraft HUD.

It is built for players who want music, videos, and visualizers inside Minecraft without constantly alt-tabbing. You can scan a local media folder, load files directly, drag the player anywhere on the screen, switch between full and compact layouts, and choose between several visual modes ranging from standard video playback to Minecraft-style mosaic rendering.

This mod is client-side only and local-files only. It does not require server installation, it does not use streaming services, and it does not rely on online playback.

Features

• Client-side only Fabric mod
• Local file playback only
• Draggable HUD with saved position
• Full and compact HUD layouts
• Expandable library panel for folders and files
• Scrollable library panel with current-track follow behavior
• Audio playback for mp3, wav, and ogg
• Video playback for mp4
• Progress bar with click-to-seek
• Play, pause, stop, next, previous, loop, shuffle, and volume controls
• Filter modes for audio, video, or both
• Saved HUD scale and transparency settings
• Built-in HUD color themes
• Custom HUD theme colors with hex input
• Normal video mode with aspect-aware layout
• Waveform visualizer mode
• Dance visualizer mode
• Dense mosaic video mode
• Item mosaic video mode built around Minecraft item icon visuals
• /media and /m command aliases

Supported Formats

• Audio: mp3, wav, ogg
• Video: mp4

Recommended video format for the smoothest results:

• H.264 video
• AAC audio
• .mp4 container

Supported Minecraft Versions

Media HUD currently has working builds for:

• 1.20.5
• 1.20.6
• 1.21
• 1.21.1
• 1.21.2
• 1.21.3
• 1.21.4
• 1.21.5
• 1.21.6
• 1.21.7
• 1.21.8
• 1.21.9
• 1.21.10
• 1.21.11

Fabric API Version Guide

Use the Media HUD jar built for your exact Minecraft version, and match it with the Fabric API version line below:

• Minecraft 1.20.5 -> Fabric API 0.97.8+1.20.5
• Minecraft 1.20.6 -> Fabric API 0.100.8+1.20.6
• Minecraft 1.21 -> Fabric API 0.102.0+1.21
• Minecraft 1.21.1 -> Fabric API 0.116.9+1.21.1
• Minecraft 1.21.2 -> Fabric API 0.106.1+1.21.2
• Minecraft 1.21.3 -> Fabric API 0.114.1+1.21.3
• Minecraft 1.21.4 -> Fabric API 0.119.4+1.21.4
• Minecraft 1.21.5 -> Fabric API 0.128.2+1.21.5
• Minecraft 1.21.6 -> Fabric API 0.128.2+1.21.6
• Minecraft 1.21.7 -> Fabric API 0.129.0+1.21.7
• Minecraft 1.21.8 -> Fabric API 0.136.1+1.21.8
• Minecraft 1.21.9 -> Fabric API 0.134.1+1.21.9
• Minecraft 1.21.10 -> Fabric API 0.138.4+1.21.10
• Minecraft 1.21.11 -> Fabric API 0.141.3+1.21.11

Recommended:

• Fabric Loader 0.18.4 or newer
• Java 21

Installation

1. Install Minecraft Java Edition for one of the supported versions above
2. Install Fabric Loader 0.18.4 or newer
3. Install the matching Fabric API version for your Minecraft version
4. Use Java 21
5. Put the correct versioned mediahud jar in your mods folder
6. Launch the game and use /m ui to open the interaction overlay

Media HUD is client-side only. A multiplayer server does not need to install it.

This public build is packaged for Windows x86_64. No extra FFmpeg or JavaCV download is required for this release file. This release package includes third-party notice material for bundled runtime components.

Command Guide

You can use either /m or /media. They are identical aliases.

Basic HUD Commands

• /m show Shows the HUD.

• /m hide Hides the HUD.

• /m toggle Toggles the HUD on or off.

• /m ui Opens the drag-and-move interaction overlay.

• /m pos reset Resets the HUD position back to its default location.

Playback Commands

• /m play Starts playback of the currently selected media.

• /m pause Pauses playback.

• /m stop Stops playback.

• /m next Selects the next track or video.

• /m prev Selects the previous track or video.

• /m seek <seconds> Seeks to a specific time in seconds. Example: /m seek 90

• /m volume <0-200> Sets volume from 0 to 200. Example: /m volume 75

Library and File Commands

• /m folder <path> Sets the root media folder and scans it. Example: /m folder C:\Users\Name\Music

• /m refresh Rescans the current media folder.

• /m load <path> Loads a specific local file directly. Example: /m load C:\Users\Name\Videos\clip.mp4

• /m probe <path> Probes a local file through the media backend. Useful when checking whether a file is detected correctly.

Playback Option Commands

• /m loop Toggles looping on or off.

• /m loop on Enables looping.

• /m loop off Disables looping.

• /m shuffle Toggles shuffle on or off.

• /m shuffle on Enables shuffle.

• /m shuffle off Disables shuffle.

• /m shuffle toggle Toggles shuffle explicitly.

Filter Commands

• /m filter audio Shows only audio files in the library.

• /m filter video Shows only video files in the library.

• /m filter both Shows both audio and video files.

Render Mode Commands

• /m mode normal Standard video preview mode.

• /m mode waveform Audio waveform visualizer mode.

• /m mode dance Dance visualizer mode.

• /m mode mosaic Dense mosaic video mode.

• /m mode itemmosaic Item-based mosaic video mode.

Resolution Commands

• /m wave resolution <3-8> Sets waveform resolution.

• /m video resolution <64-2048> Sets video preview resolution in pixels.

• /m mosaic resolution <4-160> Sets dense mosaic resolution.

• /m itemmosaic resolution <4-160> Sets item mosaic resolution.

Higher values can look better, but they may also cost more performance.

HUD Layout Commands

• /m hud mode full Uses the full HUD layout.

• /m hud mode compact Uses the compact HUD layout.

• /m hud scale <50-200> Sets HUD scale as a percentage. Example: /m hud scale 125

• /m hud transparency <0-80> Sets HUD transparency as a percentage. Example: /m hud transparency 25

Built-In Theme Commands

You can use either /m theme ... or /m hud theme ....

• /m theme Shows the current HUD theme.

• /m theme classic Uses the Classic theme.

• /m theme midnightpurple Uses the Midnight Purple theme.

• /m theme bluemoon Uses the Blue Moon theme.

• /m theme hacker Uses the Hacker theme.

• /m theme sunset Uses the Sunset theme.

• /m theme obsidian Uses the Obsidian theme.

• /m theme rosegold Uses the Rose Gold theme.

• /m theme frost Uses the Frost theme.

• /m theme custom Switches back to your saved custom theme colors.

Custom Theme Color Commands

You can type hex colors without #. Examples:

• FFAABB

• /m theme color Shows your current custom theme colors.

• /m theme color gradientprimary <hex> Sets the first gradient color.

• /m theme color gradientsecondary <hex> Sets the second gradient color.

• /m theme color main <hex> Sets the main accent color.

• /m theme color border <hex> Sets the border color.

• /m theme color button <hex> Sets the button color.

• /m theme color text <hex> Sets the text color.

Notes:

• Setting a custom color automatically switches the HUD to the custom theme.
• gradientprimary and gradient_primary both work.
• gradientsecondary and gradient_secondary both work.

Why Use It

• Keep music or video playback inside Minecraft without switching windows
• Use a Minecraft-themed HUD instead of an external desktop player
• Turn videos into stylized dense mosaics or item-based mosaics
• Run a compact layout during normal gameplay or use the full panel while browsing media
• Tune HUD scale, transparency, render resolution, and theme colors to match your setup
• Change the HUD vibe with built-in themes or your own custom palette
• Leave a world or server without worrying about media continuing to play in the background

Notes and Limitations

• Local files only. No YouTube, no streaming URLs, and no online media sources.
• This release is designed around local playback inside the game HUD, not as a full desktop media suite.
• High video, mosaic, and item-mosaic resolutions can still cost performance depending on the clip.
• Use the jar built for your exact Minecraft version.
• The best results come from using clean local files and a dedicated media folder.
• This packaged release bundles the Windows x86_64 FFmpeg runtime. Linux and macOS builds are not included in this file.

License and Third-Party Components

• Media HUD source code is licensed under MIT.
• This release bundles third-party runtime components, including JavaCV, JavaCPP, and the Windows x86_64 FFmpeg runtime via ByteDeco.
• Third-party notices and source/compliance links are included in THIRD_PARTY_NOTICES.md.
• The FFmpeg runtime in this release comes from the standard ByteDeco preset artifacts, not the separate -gpl artifacts.
• Public notice text to keep in the project page:
  • This software uses libraries from the FFmpeg project under the LGPL.
  • FFmpeg legal/compliance page: https://ffmpeg.org/legal.html
  • Corresponding FFmpeg 7.1.1 source: https://ffmpeg.org/releases/ffmpeg-7.1.1.tar.xz
  • ByteDeco preset source/build scripts: https://github.com/bytedeco/javacpp-presets/tree/1.5.12/ffmpeg