WATERMeDIA: Multimedia API
⚠️ Important Warning
WATERMeDIA v3 alpha is coming soon. Please make sure you're downloading the correct version (2.1.x) before reporting crashes on GitHub.
📖 Project Overview
WATERMeDIA is a library with a carefully designed API that provides multimedia support using native/Java decoders and LibVLC as a video backend. This library is actively used by many Minecraft mods including LittleFrames and VideoPlayer, and also replaces FancyVideo-API in the game.
The system integrates support for numerous popular platforms: YouTube, Twitch, Kick, Google Drive, OneDrive, Dropbox, Imgur, Twitter, Streamable, Lightshot, and many more!
The library is designed to work with almost all mod loaders (Forge, NeoForge, and Fabric) starting from Minecraft 1.16.5 and can be used even outside the Minecraft context.
🎯 Mods Using WATERMeDIA
- WaterFrames (by SrRapero720)
- WaterVision (by SrRapero720)
- LittleFrames (by CreativeMD)
- WaterFrames: Backported Edition (by Toshayo)
- PictureSign (by Motschen)
- Prologue (by thunderrock424242)
- Holographic Renderers (by Mysticpasta1)
- Owleaf PlayBack (by Owleaf_Studio)
Special Mentions
- NightmareCraft: Survival (unavailable)
- VideoPlayer (not maintained)
🔧 Key Features
- Support for multiple platforms (listed in overview)
- Built-in LibVLC preinstallation for Windows 10/11 (x64)
- Compatibility with all popular mod loaders (Forge, NeoForge, and Fabric)
- Image capture functionality for bandwidth reduction
- Simple and intuitive API design
- Minecraft independence (works on most game versions and even outside it)
- High performance and multithreading
📦 Installing VideoLAN for macOS and Linux
Due to operating system limitations, macOS and Linux users require forced manual installation.
❓ Frequently Asked Questions
Why does my server crash on startup with (Neo)Forge? WATERMeDIA cannot run on the server side. You should remove the JAR file from the server and keep it only on the client. In the case of Fabric, you need to keep the WATERMeDIA JAR file on the server.
Can I use VLC 4? No.
Why does the game crash when I have FancyVideo-API? FancyVideo-API and its forks are incompatible with WATERMeDIA. Both libraries conflict when loading VLC, making it impossible to load the video player. This applies to all other multimedia APIs.
Can I install VLC via Flatpak or Pacman? No. Any package installation solution that uses sandboxed installations cannot be used with WATERMeDIA. Minecraft, VLC, and WATERMeDIA must be installed using native methods (such as APT-GET).
⚖️ Licensing
WATERMeDIA is distributed under the Polyform Strict License v1.0.0
Non-commercial use is permitted (including but not limited to: mod packs and server packs). Redistribution or creation of derivative versions is not allowed.
For commercial purposes or creating derivative versions, contact us to coordinate a commercial license through Caprica Software Limited or receive a free license for non-commercial derivative versions under specific conditions (our VLCJ license does not apply to your forks).
VLCJ Licensing
VLCJ and VLCJ-natives are distributed under the commercial license for vlcj, generously provided and donated by Caprica Software Limited.
LibVLC Licensing
LibVLC binaries for Windows 10 (x64) are distributed under the LGPLv2.1 license
