premium banner

MediaTools

Experimental
The lib plugin needed by MediaRadio. Provides ffmpeg & yt-dlp functionality.

Description

Media Tools

Media Tools is a supporting library mod for MediaRadio. It bundles and manages the native binaries required for media playback and extraction, allowing MediaRadio to function without relying on system-installed tools.

This mod is not meant to be used on its own.


What This Mod Does

Media Tools embeds and manages the following native utilities:

  • yt-dlp – for resolving and downloading media streams
  • ffmpeg – for audio processing and transcoding

Key features:

  • Ships platform-specific binaries directly inside the mod JAR
  • Automatically detects the user’s OS and CPU architecture
  • Extracts the correct binaries to a runtime cache directory
  • Exposes a small Java API so MediaRadio can invoke these tools safely
  • Does not rely on PATH or external system installations

Supported Platforms

Media Tools currently supports:

Windows

  • x86_64
  • ARM64

macOS

  • x86_64 (Intel)
  • ARM64 (Apple Silicon)

Linux

  • x86_64
  • ARM64

If your platform is unsupported, MediaRadio will not be able to play media.


How It’s Used

  • Media Tools runs automatically in the background
  • Required binaries are extracted from the mod JAR
  • MediaRadio calls these tools internally when resolving or playing media
  • No configuration is required by the user

Mod Dependencies

  • Required by: MediaRadio
  • Does nothing on its own

Technical Notes (For Developers)

  • Binaries are stored under:
  tools/<os>/<arch>/
  • Extraction occurs at runtime based on detected platform
  • Includes a minimal plugin entrypoint to verify readiness

Legal & Attribution

  • yt-dlp is distributed under its respective license

  • ffmpeg binaries are sourced from:

    • Windows: BtbN builds
    • macOS/Linux: Martin Riedl builds
  • All tools remain the property of their respective authors