🔗 WaterMedia: Multimedia API
API and Library, provides multimedia support for pictures and videos using hand-made decoders and LibVLC, a very extensive API used by Minecraft mods like VideoPlayer, LittleFrames and PictureSign. Designed to work on Java games like Minecraft via MinecraftForge, NeoForge and Fabric.
Our API is structured to be easy to use for any purpose, audio playing, video playing... catching, downloading. Enhanced support for many streaming platforms like Youtube, Twitch, Kick, Google Drive, OneDrive, Dropbox, Imgur, Twitter, Pornhub and more
👷 MAINTAINERS
🔢 VERSION STATUS
✅ - SUPPORTED ||| ⚠ - PLANNED ||| ⛔ - NOT SUPPORT ||| 🚫 - N/A ||| 🚨 - DROPPING
| Version | Forge | Fabric | NeoForge |
|---|---|---|---|
| 1.18.2 | ✅ | ✅ | 🚫 |
| 1.19.2 | ✅ | ✅ | 🚫 |
| 1.20.1 | ✅ | ✅ | ✅ |
| 1.20.x | ✅ | ✅ | ⛔ |
| 1.21.1 | ✅ | ✅ | ✅ |
| 1.21.x | ⛔ | ⛔ | ⛔ |
🧑💻 INSTALLATION (GRADLE)
We use JitPack.io to build and distribute artifacts using direct GitHub tags or branches.
Check all available versions here: https://github.com/WaterMediaTeam/watermedia/tags
IN YOUR GRADLE
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
// doesn't require fg.debof() or any debofuscation tool
// watermedia is minecraft-agnostic (we don't believe in notch, or agnes)
implementation 'com.github.WaterMediaTeam.watermedia:build:<version>'
}⏯️ VIDEOLAN OS SUPPORT
Windows (x64) users has a pre-installed VLC version. You won't need to install it there (sometimes) Some OS requires manual installation, others aren't supported.
Ensure your OS is supported in this list.
[!WARNING] Linux: Flatpak and Pak-man is not supported, use
apt-getinstead or any native option.
MacOS: skip this list and download universal binaries: Download the universal version here.
| Operative System | Support status |
|---|---|
| Win 1x (x64) | ✅ |
| Win 1x (x32) | ⛔ |
| Win 1x (ARM) | 🚫 |
| MacOS (x64) | ❎ |
| MacOS (ARM) | ❎ |
| Linux (x64) | ❎ |
| Linux (ARM) | ❎ |
| Android (Pojav) | ⚠ |
- ✅ SUPPORTED
- ❎ LIMITED: Needs manually VLC 3 installation
- ⚠ PLANNED: Requires some research
- 🚫 NOT COMPATIBLE: Due to VLC limitations
- ⛔ UNSUPPORTED: Not even planned
👥 Projects using WATERMeDIA
- WATERFrAMES - By SrRapero720
- VideoPlayer - By NGoedix
- LittlePictureFrames - By CreativeMD
- PictureSign - By Motschen (TeamMidnightDust)
- Nightmare Craft By divinegaminginc
- FancyMenu (Coming Soon) - By Keksuccino
📦 SHADED DEPENDENCIES
- Java-Youtube-Downloader is public domain
- Jackson Databind is shaded under Apache v2.0 as a dependency of JYD
- SevenZipJBinding is shaded under LGPLv2.1
- NO SHADED: LWJGL, JNA/JNA-platform, gson, Log4J-api/core
⚖️ LEGAL
WaterMedia License
Polyform Strict License v1.0.0
Is permitted usage for non-comercial purposes (including and not limited to modpacks, serverpacks).
Redistribution or derivatives works of WaterMedia are not allowed
In case you want to run on commercial purposes, you need to contact us to cordinate a comercial license for WaterMedia and VLCJ with Caprica Software Limited
VLCJ license
WaterMedia v3 shades, and distributes VLCJ-natives under the Commercial license for vlcj donated by Caprica Software Limited
LibVLC license
LibVLC binaries for Windows 10 (x64) is shaded under LGPLv2.1