WATERMeDIA: Multimedia API

⚠️ WARNING

WATERMeDIA v3 alpha its going to be released soon, please ensure you're downloading the right version (2.1.x) before open a github issue about crashes

📕 OVERVIEW

WaterMedia it's a library with a well designed API, provides multimedia support using native/java decoders and LibVLC as video backend. Used by many minecraft mods like LittleFrames and VideoPlayer and the superseding of FancyVideo-API in Minecraft, integrates support for many platforms such as YouTube, Twitch, Kick, Google Drive, OneDrive, Dropbox, Imgur, Twitter, Streamable, Lightshot and more!

Designed to work on almost all Minecraft Mod Loader (Forge, NeoForge and Fabric) above Minecraft 1.16.5 and outside Minecraft contexts.

🧩 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 (not available)
• VideoPlayer (not maintained)

🛠️ FEATURES

• Multi platform support (listed in the overview)
• Integrated LibVLC preinstallation for Windows 10/11 (x64)
• Supports all existing modloaders (Forge, NeoForge and Fabric)
• Picture catching for bandwidth reductions
• Simplistic API design
• Minecraft agnostic (runs on almost all Minecraft versions and even outside)
• High performance and multithreated

🎮 SUPPOT US AND GET A 15% DISCOUNT

KineticHosting, our partners in hosting solutions are great to make a server and start sharing multimedia with your friends with all the listed mods above.

📦 INSTALL VIDEOLAN FOR MACOS AND LINUX

Due to OS limitations, MacOS and Linux requires a forced manual installation.

• Download VideoLAN for MacOS here
• Download VideoLAN for Linux here

⁉️ FAQ

• ¿Why my server crashes on startup using (Neo)Forge?
  • WaterMedia can't run on server-side, you should remove the jar from server-side and keep it just on client-side. Fabric on the other hand still needs to keep the WaterMedia jar on server-side
• ¿Can I use VLC 4?
  • No
• ¿Why game crashes when I have FancyVideo-API?
  • Because FancyVideo-API and its forks are incompatible with WATERMeDIA, both libraries collides each other on load VLC and both ends in can't be able to load VLC, this applies for all other multimedia APIs
• ¿Can I install VLC via Flatpak or Pacman?
  • No, in fact, any package install solution that uses sandboxed installations can't be used with WATERMeDIA, Minecraft, VLC and WATERMeDIA must be installed in native ways (like APT-GET)

⚖️ LICENSE

WaterMedia is under Polyform Strict License v1.0.0

Permitted non-commercial usage (included and not limited to; ModPacks or ServerPacks) Redistribution or derivative versions are not allowed

For commercial purposes or derivative versions, contact us to coordinate a commercial license with Caprica Software Limited or receive a free license for derivative without commercial purposes under specific conditions (our VLCJ license doesn't apply for your fork).

⚖️ VLCJ LICENSING

VLCJ and VLCJ-natives are shaded and distributed under the Commercial license for vlcj generously provided and donated by Caprica Software Limited.

⚖️ LIBVLC LICENSING

LibVLC Windows 10 (x64) binaries are wrapped under LGPLv2.1