A custom FFmpeg codec library for MX Player with automated build system.
Amazon is no longer updating MX Player. For continued development and updates, consider using:
- mpv-android - Modern, actively maintained video player
This repository maintains a fork of the original MX Player FFmpeg codec for those still using the legacy player.
This repository includes GitHub Actions workflows for completely automated builds!
Simply push code to master branch → Automatic build starts!
- Go to Actions tab → Manual Codec Build
- Click Run workflow
- Select architectures and options
- Download ZIP from artifacts/releases
- Go to Actions → Sync Upstream
- Automatically pulls latest changes from source
👉 See BUILD_AUTOMATION.md for detailed setup guide
- Android NDK installed
- Build tools for your platform (Make, GCC, etc.)
- Git for version control
cd ffmpeg/jni
# Edit ENV file with your NDK location
nano ENV
# Then run the build script
./rebuild-ffmpeg.shcd ffmpeg/jni
# Edit ENV with your NDK location
nano ENV
# Build for specific architecture
./build-ffmpeg.sh armeabi-v7a # 32-bit ARM
./build-ffmpeg.sh arm64-v8a # 64-bit ARM
./build-ffmpeg.sh x86 # 32-bit Intel
./build-ffmpeg.sh x86_64 # 64-bit IntelLibraries will be generated in:
ffmpeg/jni/build/[architecture]/lib/
libavcodec.so- Video/audio codecslibavformat.so- Container formatslibavutil.so- Utility functionslibswscale.so- Image scalinglibswresample.so- Audio resamplinglibavfilter.so- Audio/video filterslibavdevice.so- Device supportlibpostproc.so- Post-processing
libmp3lame.so- MP3 encoding (LAME)libssl.so+libcrypto.so- OpenSSL encryptionlibxml2.so- XML parsinglibfribidi.so- Bidirectional text supportlibfreetype.so- Font renderinglibfontconfig.so- Font configuration
Video Codecs:
- H.264, H.265 (HEVC), VP8, VP9, AV1
- MPEG-2, MPEG-4, Theora, Dirac
- And 50+ more
Audio Codecs:
- AAC, MP3, Vorbis, FLAC
- Opus, DTS, AC-3, E-AC-3
- And 30+ more
Containers:
- MP4, MKV, AVI, MOV, WebM
- FLV, TS, WAV, AIFF
- And 40+ more
| Architecture | Bit | Devices |
|---|---|---|
| armeabi-v7a | 32-bit | Older Android phones |
| arm64-v8a | 64-bit | Modern Android phones |
| x86 | 32-bit | Android tablets, emulators |
| x86_64 | 64-bit | High-end tablets, emulators |
Edit ffmpeg/jni/ENV:
# Set your NDK path
export ANDROID_NDK_ROOT="/path/to/android-ndk"
# Optimization flags
export CFLAGS="-O3"
# Target API level
export ANDROID_API_LEVEL=21Edit ffmpeg/jni/build-ffmpeg.sh to:
- Enable/disable specific codecs
- Change optimization levels
- Add/remove libraries
- Modify compilation flags
- MX Player FFmpeg Info - Original documentation
- FFmpeg Project - FFmpeg official site
- Android NDK Guide - Android Native Development Kit
- mpv-android Alternative - Modern video player
- build-codec.yml - Auto-build on push
- auto-merge.yml - Daily upstream sync
- manual-build.yml - On-demand builds
✅ Multi-architecture parallel builds
✅ Automatic GitHub releases
✅ SHA256 verification checksums
✅ Build artifacts with logs
✅ Upstream synchronization
✅ Manual trigger options
Full documentation: BUILD_AUTOMATION.md
Latest builds available in GitHub Releases
Each release includes:
- Compiled
.solibraries for all architectures - README with build information
- Manifest with library list
- SHA256 checksums
This project is a fork of the original MX Player FFmpeg codec. Please see individual component licenses:
- FFmpeg - LGPL 2.1+
- LAME - LGPL 2+
- OpenSSL - Apache 2.0 / OpenSSL License
- libxml2 - MIT
- FriBidi - LGPL 2.1+
- Report issues: GitHub Issues
- Pull requests: Contributions welcome!
- Discussions: GitHub Discussions
- This is a legacy project - MX Player is no longer maintained by Amazon
- For active development, consider mpv-android or other maintained players
- Builds typically take 20-30 minutes per architecture
- GitHub Actions provides free build minutes
Last Updated: May 2026
Original Source: MX Player GitHub
Original Documentation: MX FFmpeg Wiki