Skip to content

MWBMPartners/MeedyaConverter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

289 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฌ MeedyaConverter

A modern, cross-platform media conversion toolkit with adaptive streaming support

Copyright ยฉ 2026 MWBM Partners Ltd. All rights reserved.

Platform Swift License


๐Ÿš€ What is MeedyaConverter?

MeedyaConverter is a professional-grade media conversion application designed for website owners and media professionals who need to prepare audio and video content for on-demand streaming. Think of it as a modern alternative to HandBrake โ€” with significantly expanded capabilities.

โœจ Key Features

Feature Description
๐ŸŽž๏ธ Video/Audio/Subtitle Passthrough Copy streams without re-encoding โ€” HandBrake forces re-encoding
๐Ÿ“ก HLS & MPEG-DASH Preparation Multi-bitrate adaptive streaming from a single source file
๐ŸŽจ HDR Preservation HDR10, HDR10+, HLG, and Dolby Vision support
๐Ÿ”„ HDR10+ โ†’ Dolby Vision Automatic Dolby Vision creation from HDR10+ content
๐ŸŽต Audio Normalization EBU R128, ReplayGain, and peak limiting
๐Ÿ“ Full Subtitle Support SRT, TTML, WebVTT, SSA/ASS, CC608/CC708, DVB-SUB, SAMI, LRC
๐Ÿ” DRM & Encryption AES-128 encryption for HLS with key management
โ˜๏ธ Cloud Upload Direct upload to S3, Azure, Cloudflare Stream, and 10+ providers
๐Ÿ–ผ๏ธ Thumbnail Sprites Auto-generate preview scrubbing sprites for video players
๐Ÿ” Forensic Watermarking Invisible watermark embedding for content protection
๐ŸŽฅ 3D / Stereoscopic MV-HEVC (Apple Vision Pro spatial) and MV-H264 multiview encoding
๐Ÿ’ฟ Optical Disc Ripping 22 disc types: Audio CD, SACD, DVD, DVD Audio, Blu-ray, UHD BD, and more โ€” disc, image, or folder
๐Ÿ’ฝ Disc Authoring & Burning Create disc images and burn to physical media for all supported disc types
๐Ÿ–ฅ๏ธ Cross-Platform macOS (primary), Windows, Linux including Raspberry Pi
๐Ÿท๏ธ Media Metadata Lookup Auto-tag via MusicBrainz, TMDB, TVDB, IMDB, MeedyaDB, Discogs
๐Ÿ“Š Quality Metrics VMAF, SSIM, PSNR objective quality scoring
๐Ÿ‘๏ธ A/B Comparison Side-by-side source vs encoded viewer
๐Ÿ“‚ Watch Folders Monitor folders for new files, auto-encode
๐Ÿ” Scene Detection Auto-chaptering from scene boundaries
๐Ÿ”Ž AI Upscaling Resolution enhancement via Real-ESRGAN
๐Ÿ–ผ๏ธ Image Conversion Bulk image format conversion (future version)
๐Ÿ’ป CLI Mode Full command-line interface for automation and scripting

๐Ÿ—๏ธ Architecture

MeedyaConverter uses a modular architecture with a shared cross-platform core:

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚           Platform-Specific UIs              โ”‚
โ”‚  macOS (SwiftUI) โ”‚ Windows (WinUI) โ”‚ Linux   โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚             meedya-convert                   โ”‚
โ”‚         (Command-Line Interface)             โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚            ConverterEngine                   โ”‚
โ”‚  Encoding Backend (hybrid)  โ”‚ Manifest โ”‚ HDR  โ”‚
โ”‚  Encoding Profiles โ”‚ Audio  โ”‚ Subs     โ”‚ Cloudโ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  • ConverterEngine โ€” Cross-platform Swift package with all encoding, analysis, and processing logic
  • meedya-convert โ€” Command-line tool built on ConverterEngine
  • MeedyaConverter โ€” Native SwiftUI macOS application (primary platform)

Internal target names are deliberately distinct from the Meedya product family (MeedyaDL, MeedyaManager, MeedyaDB) to avoid confusion.


๐Ÿ“‹ Supported Formats

๐Ÿ“ฆ Output Containers

MP4, M4V, M4A, M4B, M4P, MKV, MKA, MKS, MK3D, MOV, WebM, HLS (.m3u8), MPEG-DASH (.mpd), MXF, AVI, FLV, MPEG-TS (.ts), MPEG-PS (.mpg), 3GP/3G2, OGG/OGM, DCP, AIFF, CAF, W64, RF64

๐ŸŽฅ Video Codecs

H.264/AVC, H.265/HEVC, MV-HEVC, MV-H264, AV1, VP8, VP9, ProRes, MPEG-2, MPEG-4, DNxHR, Theora, FFV1, CineForm, VC-1/WMV, JPEG 2000

๐Ÿ”Š Audio Codecs

AAC (LC, HE-AAC, HE-AACv2), Dolby Digital (AC-3, E-AC-3, TrueHD, Atmos, AC-4, MAT), DTS (Core, DTS-HD, DTS:X), PCM, MP3, MP2, FLAC, ALAC, Opus, Vorbis, DSD (DFF/DSF), WavPack, AIFF, MQA (decode), Musepack, APE, TTA, WMA (decode), ATRAC (decode), Speex

๐ŸŽง Spatial & Immersive Audio

Dolby Atmos, Eclipsa Audio (IAMF), MPEG-H 3D Audio, 360 Reality Audio, ASAF (Apple Spatial Audio), Ambisonics (FOA/HOA), Auro-3D, NHK 22.2, AC-4 A-JOC

๐Ÿ“ Subtitles & Captions

SRT, TTML, WebVTT, SSA/ASS, SAMI, LRC (Enhanced & Walaoke), CC608, CEA-708 (EIA-708), DVB-SUB, PGS (Blu-ray), VobSub (DVD), EBU STL, SCC, MCC, EBU Teletext / DVB Teletext โ€” including OCR conversion from bitmap to text formats

๐Ÿ’ฟ Optical Disc Formats (Ripping, Authoring & Cloning)

Audio CD, SACD, Hybrid SACD, SHM-SACD, SHM-CD, Blu-spec CD, HDCD, DTS CD, CD-MIDI, CD+G, Mixed Mode CD, Enhanced CD (eCD/CD+), CDV, DualDisc, Video CD, Super Video CD, DVD-Video, DVD Audio, HD DVD, Blu-ray, Blu-ray 3D, Ultra HD Blu-ray

Supports physical discs, disc images (ISO, BIN/CUE, MDF/MDS, NRG, IMG), extracted disc structures (VIDEO_TS, BDMV), and bit-for-bit disc cloning.


๐Ÿ–ฅ๏ธ Platform Support

Platform Architecture UI Framework Priority
macOS Apple Silicon (M1+) Swift 6.3 / SwiftUI ๐Ÿ”ด Primary
Windows x86, x64, ARM WinUI 3 ๐ŸŸก Secondary
Linux x86, x64, ARM, ARMv7, ARM64 GTK4 ๐ŸŸข Tertiary
CLI All platforms Swift ArgumentParser ๐Ÿ”ด Primary

๐Ÿ› ๏ธ Tech Stack

Component Technology
Language Swift 6.3
macOS UI SwiftUI
Media Engine Hybrid โ€” FFmpeg subprocess (direct) + AVFoundation/FFmpegKit (App Store)
HDR Tools dovi_tool, DDVT (bundled)
Package Manager Swift Package Manager
CI/CD GitHub Actions
Auto-Update Sparkle 2 (direct distribution); Apple-managed (App Store)

๐Ÿ“ Repository Structure

MeedyaConverter/
โ”œโ”€โ”€ Sources/
โ”‚   โ”œโ”€โ”€ ConverterEngine/     # Cross-platform core engine
โ”‚   โ”œโ”€โ”€ meedya-convert/      # Command-line interface
โ”‚   โ””โ”€โ”€ MeedyaConverter/     # macOS SwiftUI application
โ”œโ”€โ”€ Tests/                   # Unit & integration tests
โ”œโ”€โ”€ Resources/               # Built-in profiles & help content
โ”œโ”€โ”€ Tools/                   # Bundled third-party executables
โ”œโ”€โ”€ help/                    # User documentation (Markdown)
โ”œโ”€โ”€ branding/                # Brand assets (logos, icons)
โ”œโ”€โ”€ docs/                    # Extended documentation
โ”œโ”€โ”€ .github/                 # CI/CD workflows & issue templates
โ”œโ”€โ”€ .claude/                 # Claude AI development context
โ”œโ”€โ”€ Project_Plan.md          # Detailed project plan & milestones
โ”œโ”€โ”€ PROJECT_STATUS.md        # Current development status
โ””โ”€โ”€ CHANGELOG.md             # Version history & changes

๐Ÿ—บ๏ธ Roadmap

Phase Description Status Release
Phase 0 Project Setup & Architecture ๐Ÿšง In Progress โ€”
Phase 1 Core Engine Foundation โณ Planned Alpha 0.1
Phase 2 macOS SwiftUI Application (MVP) โณ Planned Alpha 0.1
Phase 3 Essential Encoding & Passthrough โณ Planned Alpha 0.2
Phase 4 CLI Tool โณ Planned Alpha 0.2
Phase 5 Subtitles & Core Audio Processing โณ Planned Beta 0.5
Phase 6 Adaptive Streaming (HLS/MPEG-DASH) โณ Planned Beta 0.5
Phase 7 Extended Formats & Spatial Audio โณ Planned Beta 0.7
Phase 8 Advanced Audio Processing โณ Planned Beta 0.7
Phase 9 Professional Features โณ Planned RC 0.9
Phase 10 Optical Disc Ripping (22 disc types) โณ Planned v1.1+
Phase 11 Disc Image Creation & Burning โณ Planned v1.2+
Phase 12 Cloud Integration & Uploads โณ Planned v1.3+
Phase 13 Platform Expansion โ€” Windows โณ Planned v2.0
Phase 14 Platform Expansion โ€” Linux โณ Planned v2.0
Phase 15 Media Metadata Lookup โณ Planned v1.5+
Phase 16 Polish & Distribution โณ Ongoing Ongoing
Phase 17 Image Conversion (future version) โณ Planned v3.0+
Phase 18 AI-Powered Features (wishlist) ๐Ÿ”ฎ Wishlist TBD

๐Ÿ“Œ See Project_Plan.md for detailed milestone breakdown. ๐Ÿ“Š See PROJECT_STATUS.md for current progress.


๐Ÿš€ Getting Started

โš ๏ธ MeedyaConverter is currently in early development (Phase 0). Build instructions will be refined as the core engine matures.

Prerequisites

  • macOS 15+ (Sequoia or later)
  • Xcode 16.3+ (with Swift 6.3)
  • FFmpeg (bundled with app, or install via Homebrew for development: brew install ffmpeg)

Building from Source

# Clone the repository
git clone https://github.com/MWBMPartners/MeedyaConverter.git
cd MeedyaConverter

# Build all targets
swift build

# Run tests
swift test

# Build release configuration
swift build -c release

Branch Strategy

Branch Purpose Release Type
main Stable releases Production (tagged vX.Y.Z)
beta Beta testing Pre-release (vX.Y.Z-beta.N)
alpha Early development Pre-release (vX.Y.Z-alpha.N)

๐Ÿ“– Documentation

Resource Description
๐Ÿ“‹ Project Plan Milestones, architecture, and tech stack
๐Ÿ“Š Project Status Current development progress
๐Ÿ“ Changelog Version history and changes
๐Ÿ“š Help Documentation User guides, FAQ, troubleshooting
๐Ÿ”ง CLI Reference Command-line usage
๐Ÿ”Š Audio Format Compatibility Conversion matrix โ€” what converts to what
๐Ÿ“– GitHub Wiki Architecture, API docs, dev guide
๐Ÿ”’ Security Policy Vulnerability reporting

๐Ÿ”’ Security

See our Security Policy for information on reporting vulnerabilities. We take security seriously and respond to reports promptly.


๐Ÿงฉ Part of the Meedya Family

MeedyaConverter is part of the Meedya product suite by MWBM Partners Ltd:

Product Description Repository
MeedyaConverter Media conversion & streaming preparation This repo
MeedyaDL Media downloader MWBMPartners/MeedyaDL
MeedyaManager Media library management MWBMPartners/MeedyaManager
MeedyaDB Media database MWBMPartners/MeedyaDB

๐Ÿ“œ License

Proprietary โ€” Copyright ยฉ 2026 MWBM Partners Ltd. All rights reserved.

This software is the proprietary product of MWBM Partners Ltd. Unauthorized copying, distribution, modification, or use of this software is strictly prohibited without prior written permission.

Third-Party Licenses

MeedyaConverter bundles or uses the following open-source components, each under their own respective licenses:

Component License Usage
FFmpeg LGPL 2.1 / GPL 2+ Subprocess (direct) or FFmpegKit LGPL (App Store)
dovi_tool MIT Dolby Vision RPU manipulation
DDVT MIT HDR10+ to Dolby Vision conversion
MP4Box (GPAC) LGPL 2.1 MP4/DASH tooling
Tesseract OCR Apache 2.0 Bitmap subtitle OCR
libcdio / cdparanoia GPL Optical disc reading
libdvdread / libdvdnav GPL 2 DVD reading
libbluray LGPL 2.1 Blu-ray reading
libmediainfo BSD-2-Clause Detailed media file analysis

GPL tools are invoked as subprocesses (not linked), maintaining license compatibility with the proprietary application code.


๐Ÿค Contributing

MeedyaConverter is currently a private project by MWBM Partners Ltd. Contribution guidelines will be published if/when the project opens to external contributors.


๐Ÿ“ง Contact

MWBM Partners Ltd โ€” GitHub: @MWBMPartners


Built with โค๏ธ by MWBM Partners Ltd

About

All-In-One, easy to use, flexible Multimedia converter

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages