Lia's Media player

Lia's Media player

For Minecraft 1.21.1 - 26.2 · NeoForge · Client-side only

Lia's Media player is a companion mod that can display medias that you can interact — right inside Minecraft, without ever leaving the game.

What it does at a glance

When a link to an image or video appears in chat, the mod quietly replaces the raw URL with a short, colored label:

• A gold [picture] for images
• A gold [gif] for Tenor GIFs
• An aqua, underlined video label for videos, YouTube links, YouTube playlists, and Twitch streams
• A green, underlined [audio] label for audio files

Pictures and GIFs

Hover to preview. Open your chat and move the mouse over any [picture] label. A preview of the image pops up right above your cursor — no clicking, no browser, no tabbing out. The image is downloaded the first time you hover and then kept ready, so it appears instantly after that. Animated GIFs play in the preview.

Supported images. Standard picture files work out of the box: PNG, JPG/JPEG, GIF, and BMP.

Tenor GIFs. The mod figures out the real animated GIF behind the tenor page automatically and shows it for you — these appear as a [gif] label.

Pin it on screen. Want to keep a picture up while you keep playing or chatting? Click to pin it as its own little window. Pinned images can be:

• Dragged anywhere on screen
• Resized by dragging the bottom-right corner, or by holding Ctrl and scrolling the mouse wheel to zoom
• Hidden or closed with the small corner buttons

Previews and pinned windows are automatically scaled down to fit comfortably on your screen, never blown up past their real size.

Videos

Click a video label and the mod opens a real, working video player inside Minecraft — with sound. Hovering over a video label provides a handy tooltip reminder of your options.

• Alt-Click a video link to play it as audio-only in the compact audio bar.

What it can play:

• Direct video files shared in chat: MP4, WEBM, MOV, MKV, M4V, AVI, FLV, OGV, and TS
• Live/adaptive streams: HLS (.m3u8) and DASH (.mpd) manifests
• YouTube links: normal watch links, youtu.be short links, and Shorts
• YouTube playlists: a youtube.com/playlist?list=... page — clicking it queues the whole list
• Twitch streams: channel and VOD links

The player window gives you full controls:

• Play / pause
• A seek bar with elapsed and total time, so you can scrub to any point
• A speaker toggle and a pop-up volume slider
• A next button when more than one video is lined up
• A loop button that cycles through off → loop the queue → loop this video
• A shuffle button (while a queue exists) that mixes up what is coming
• Move, resize, and zoom the window exactly like a pinned image

A built-in queue. Instead of cluttering your screen with a new window for every link, extra videos are added to the current player's queue. When one finishes (or you press next), the window automatically swaps to the next video in place. The queue panel shows each entry's thumbnail and its real video name (the actual YouTube title, or the file name), so you can tell what's coming up at a glance.

Whole YouTube playlists. Click a [youtube playlist] label and the mod reads the playlist (it takes a moment) and queues every video in it, in order — alt-click to listen to it as audio only. Turn on loop and it plays forever; turn on shuffle as well and each new round is reshuffled, so you never get the same order twice.

In-Game Playlists GUI (/liasmediaplayer playlists)

• Create, manage, and rename multiple personal playlists.
• Reorder tracks effortlessly (click the up/down arrows or use the swap buttons next to tracks).
• One-click shuffle play, and a loop toggle for endless playback.
• Import playlists directly from your clipboard (lines of URLs) and export playlists to your clipboard for easy sharing.

Keeps playing in the background. Hide a player, and it keeps running — audio and all — so you can listen while you play. Close it with the × button when you're done. While no menu or chat screen is open, visible video windows stay drawn on your HUD so a clip keeps showing during normal gameplay.

Everything just works. Video playback relies on two small helper tools: ffmpeg (to decode video and sound) and yt-dlp (to play YouTube links). If you don't already have them, the mod quietly downloads the official copies into its own folder when the game starts — so you don't have to set anything up. If you do have them installed, the mod finds them automatically in the usual places.

Audio

Click an [audio] label and the mod opens a small audio bar — just the track name and a row of controls — so you can listen without a big window in the way. Hovering over an audio label will provide a tooltip reminder to click it.

What it can play:

• Direct audio files shared in chat: MP3, WAV, OGG/OGA, FLAC, M4A, AAC, OPUS, WEBA, WMA and AIFF

The bar gives you:

• Play / pause, previous and next
• A loop button that cycles through off → loop the whole queue → loop this track
• A shuffle button — with loop on, every round is reshuffled instead of repeating the same order
• A seek bar with elapsed and total time
• A speaker toggle, plus scroll the mouse wheel over the bar to change the volume

A built-in queue, just like videos. Click more audio links, and they line up behind the current one; the bar plays them one after another and the time read-out shows how many are waiting (a little +N). The volume is shared with the video player, so one setting controls everything.

Keeps playing in the background. Hide the bar and the music keeps going; while no menu is open it stays on your HUD showing the track name. The same top-left button that brings hidden videos back works for hidden audio bars too.

Playlists

Open the Playlists button in the top-left of your chat (or bind a key for it — see below) to manage saved playlists.

• Create a playlist and give it a name.
• Add tracks by pasting a link — a direct audio file or a YouTube video (only the sound is played).
• Import a whole YouTube playlist by pasting its playlist?list=... link into the same box: every video in it is added as a track. Pasting one on the clipboard In button creates a new playlist named after the YouTube one.
• Rename, reorder tracks (with the up/down arrows), remove tracks, or delete a playlist.
• Play it in order, or Shuffle it for a random order.
• Toggle Loop before pressing Play or Shuffle to start the playlist looping — with Shuffle, each round comes back in a new random order. The loop and shuffle buttons on the player itself change this while it plays.

Your playlists are saved to disk, so they're still there next time you play.

Mod Options

The mod now features a configurable options menu where you can tailor its behavior to your liking.

• You can access it by clicking the Options button in the Playlists menu, or via the Config button in the game's Mods list.
• Default Window Position: Choose where new windows appear by default. Options include Center, Top Left, Top Right, Bottom Left, and Bottom Right. The default is Center, which keeps the classic cascading behavior.
• Video Resolution: Choose the maximum resolution for video playback (from 144p up to 720p).
• Resource Limits: Adjust the maximum number of pinned images, video players, audio players, cached entries, and GIF frames to optimize memory usage based on your computer's capabilities.
• Advanced Limits: You can also configure the video frame queue capacity, max image cache in megabytes, and yt-dlp timeout. Watch out for red tooltips indicating sensitive settings!

- All options are saved automatically and persist between sessions.

Keybinds

The mod adds keys you can set in Options → Controls → "Lia's Media Player" to drive the players without opening chat:

• Play / Pause, Next track and Previous track: these apply to the active audio track, or if none is playing, the active video player.
• Open playlists

They're unbound by default so they never clash with your existing keys — just assign whatever you like.

Chat Commands

You can also start playing media directly via chat commands without receiving a link first:

• /show <type> <url> [newPlayer]
  • type: Either image, video, or audio (with auto-completion). Note: A video URL can be played as video or audio, but you cannot play an audio URL as a video.
  • url: The link to the media.
  • newPlayer (optional): When true, opens the media in a brand-new player window instead of adding it to the queue of an existing player. Defaults to false.

Why you'll like it

• No alt-tabbing. Images and videos play where the conversation is happening.
• Zero setup for most things. Hover an image, and it just appears; click a video, and it just plays.
• Stays out of your way. Nothing shows up until media is actually shared, labels are compact, and everything is downloaded in the background so the game never stutters waiting on a link.
• You're in control. Drag, resize, pin, hide, queue, mute — arrange your media however you like, then close it all when you're done.

Lia's Media Player is a client-side convenience mod. It only affects how shared image, video, and audio links appear in your own chat — it does not modify gameplay, the world, or other players.

Lia's Media Player

Pictures, GIFs, videos and music — right inside Minecraft.

Lia's Media Player turns media links shared in chat into previews and floating players. Watch a clip, keep a reference picture beside your build, or listen to a playlist while you play.

Minecraft 1.21.1, 1.21.11 and 26.3 · Fabric & NeoForge · Client-side only

Install it on your own client; the server and other players do not need it. On Fabric, you also need Fabric API.

From chat to your screen

Supported links become compact, coloured labels in chat: [picture], [gif], [youtube], [audio], and more.

• Hover an image label to preview it. Animated pictures play in the preview.
• Click to pin a picture or start a video or audio player. More video or audio links join the front player's queue.
• Alt-click a video to listen to its sound in a compact audio bar.
• Shift-click to open a separate player instead of adding to the existing queue.

You can also play a link from your clipboard with a configurable keybind, or use /show without posting it in chat.

Pictures and GIFs

Preview a picture beside your cursor, then click to keep it on screen. Pinned pictures can be moved, resized, hidden, or closed, and stay visible on your HUD during normal gameplay.

• PNG, JPEG, GIF and BMP, plus WebP, animated WebP, AVIF and animated PNG through ffmpeg.
• Tenor and Giphy share links resolve to the GIF itself.
• Previews fit within your screen and scale down large pictures.
• Drag a window's corner to resize it, scroll over a pinned picture to zoom, or use Ctrl + scroll to zoom resizable media windows.

Videos and streams

Click a video label to watch it in a floating window, with sound and playback controls.

The player includes play/pause, previous/next, ±10-second jumps, a seek bar, volume, mute, loop and shuffle. Seeking controls are unavailable for live streams without a seekable timeline.

Open the queue panel to see what is coming next. Double-click an entry to play it, drag entries into order, or remove the ones you no longer want. Click a YouTube playlist page to queue its videos; Alt-click to listen instead.

Theatre mode fills the screen and hides the controls when idle. Double-click the video or press Ctrl + F to enter or leave it; your window returns to its previous position and size.

Music without a big window

Audio opens in a compact bar with playback, seeking, volume, queue, loop and shuffle controls. Hide it and the music keeps playing.

• SoundCloud tracks and sets.
• Bandcamp tracks and albums.
• Direct audio: MP3, WAV, OGG/OGA, FLAC, M4A, AAC, OPUS, WEBA, WMA and AIFF/AIF.
• Video as audio: Alt-click a video link to listen without its picture.

Arrange your media around your game

Open chat to interact with your media windows, or bind Open the media controls for a dedicated screen that leaves the world running behind it.

• Drag, resize and zoom windows to suit your screen.
• Snap windows to the screen and each other. Hold Shift while dragging to position them freely.
• Hide a player to keep listening; a now-playing banner announces new tracks from hidden players.
• Keep pictures and videos on your HUD while you play.
• Remember your layout: new windows reuse the saved position and size for their kind, along with player loop, shuffle and queue-panel preferences.
• Copy a link from a window, or Shift-click the copy button to include the playback time on supported sites.
• Open the original in your browser or save it as a favourite from the title bar.

Saved playlists, history and favourites

Open Playlists above the chat, or assign its keybind, to build your own library.

• Create and rename playlists, add links, search tracks, drag them into order, and remove entries.
• Expand a YouTube playlist or SoundCloud set into individual tracks.
• Play in order or shuffled, with optional looping.
• Import links from your clipboard and copy playlists out as M3U text for sharing.
• See thumbnails beside playlist entries and history rows, with titles and thumbnails cached between visits.

The History screen keeps recently played media within reach. Search by name or URL, play something again, or add it to a playlist. Use the heart to keep a favourite: favourites survive clearing the ordinary history and are excluded from its size limit.

Playlists, history and favourites are saved between sessions.

Make it yours

Open Media Player Settings from the pause menu, Fabric's Mod Menu, NeoForge's mod list, or a keybind. Settings are grouped and searchable, with descriptions and individual reset buttons. Changes apply immediately and save automatically.

• Four themes: Dark, High contrast, Minecraft and Light.
• Video quality: choose a maximum of 360p, 480p, 720p or 1080p; the default is 720p.
• Window preferences: default placement and limits for pinned pictures, video players and audio bars.
• Chat preferences: toggle hover previews, allow or block domains, and ignore media links from selected senders.
• Performance: adjust picture memory and disk-cache limits, clear the cache, or let hidden video players switch to sound only after five seconds.
• Tools: see their status, control automatic yt-dlp updates, or use Update the tools to refresh them manually.
• Debug overlay: inspect player resolution, buffers, dropped frames and rendering costs when troubleshooting.

The rewrite adjusts video decoding to the window's size, within your quality limit, and reduces the frame rate at lower resolutions. Pictures are decoded to a size suited to how they are displayed, while cached titles and thumbnails reduce repeat downloads.

Controls

Assign keys in Options → Controls → Lia's Media Player for playback, previous/next, volume, mute, hiding or closing all windows, opening media controls, playlists and settings, or playing the clipboard link. All are unbound by default.

These shortcuts also work on the front player while chat or the media controls screen is open:

Space and the seek shortcuts only control playback while you are not typing. Ctrl shortcuts remain available while writing a message. On macOS, use Cmd in place of Ctrl.

Chat command

/show <image|video|audio> <url> [newPlayer]

Choose image, video or audio and paste the link. Add true at the end to request a separate window; otherwise, videos and audio join an existing player's queue. Use audio with a video link to play only its sound.

Getting started and upgrading

Playback uses ffmpeg and yt-dlp. The mod finds installed copies or downloads them into its own liasmediaplayer/bin/ folder on first launch. Automatic yt-dlp updates are enabled by default. If playback fails, the player shows an explanation and retry controls, with a tool-update option when appropriate.

Coming from v2? The first launch imports your old settings, playlists, history and window preferences, and preserves the original files as *.v2.bak backups.

For addon developers: the rewrite provides API 4 for custom media sources, resolvers, themes, window actions, shortcuts, keybinds and settings. Existing addons need to be ported; some older API capabilities are not available yet. See the repository's API and porting guides for details.

Lia's Media Player displays media on your own client. Playback and your saved library are local to you; the mod does not synchronise viewing with other players.