dannephoto/mlv-app

An all in one MLV processing app that will become great soon (or maybe is already)

🔥🔥🔥 MLV App 🔥🔥🔥

What is MLV App? A cross platform RAW conversion software that works natively with Magic Lantern MLV files.

Find the latest releases here. Download, unpack and start.

Features 💥

• Import MLV files
• Support for spanned mlv (.m00, .m01, ...)
• Support for lossless mlv
• Support for any bit depth (…, 10, 12, 14bit)
• Demosaic bilinear or multithreaded AMaZE
• Processing with many parameters (exposure, white balance, saturation, dark & light adjustments, highlights & shadows, sharpen,…)
• Processing filters for film emulation powered by neural networks 👻
• Processing in sRGB or several LOG
• RAW corrections (fix focus & bad pixels, chroma smoothing, pattern noise, vertical stripes, deflicker)
• Autodetection for focus pixels and vertical stretching
• MLV darkframe subtraction (with external / internal darkframe)
• Support for dual ISO
• Show clip information
• Analysis: histogram (including markers for under-/overexposed), waveform monitor, RGB parade, vector scope
• Session: open, import to, delete from, save, copy receipt, paste receipt (also batch paste), reset receipt, receipt file import & export, preview pictures for all clips
• Video playback in 2 modes: show each frame or drop frame mode (a kind of realtime playback which shows as many frames your computer can render)
• Audio playback in video drop frame mode
• Loop playback
• Show next frame, previous frame and scroll though timeline
• Label for timecode and duration of edited clip
• Auto load white balance, if MLV was filmed at sunny, shade, cloudy, thungsten, fluorescent, flash or kelvin
• Single frame (3x)8bit PNG export
• Clip export via ffmpeg 10bit ProRes 422 (Proxy, LT, Standard, HQ), ProRes 4444, RAW AVI, 8bit H.264 and H.265, 16bit TIFF sequence, DNxHD, DNxHR; all with or without audio
• macOS only: Clip export via Apple AVFoundation 12bit ProRes 422, ProRes 4444 and 8bit H.264, all with or without audio
• Clip export to (10/12/14/16bit for Dual ISO) Cinema DNG files (with default or Davinci Resolve naming). Exporting modes: uncompressed, lossless and fast pass (in the last one no RAW correction, processing or decompressing/compressing is done, raw data copied as is from MLV to DNG uncompressed or lossless).
• MLV export (fast pass, compressed, averaged frame (for darkframe creation), extract internal darkframe)
• Audio only export
• Clip trimming support (Cut In and Cut Out) for any export mode (ffmpeg, AVFoundation, cDNG, MLV) including audio syncing with correct timecode.
• Frame rate override for export and playback
• Aspect Ratio: stretch width (1.33x, 1.5x, 1.75x, 1.8x, 2.0x) and height (1.67x, auto detected for latest MLVs) for playback and (ffmpeg & DNG) export per clip in session. Manually changed AR is inserted to exported cDNG header.
• Upside down transformation
• Resize frame resolution for (batch) export
• Clip batch export
• Post export scripting on macOS (thx @dannephoto)
• Zoom: fit to screen, 100% and free zoom, scroll through picture
• Zebras
• Create and load MAPP files (this files include all required information from the original MLV, plus video and audio frame index. If .MAPP file already created, importing is lot faster especially on slower HDD)
• Update checker

Compiling 💥

Cocoa App

git clone https://github.com/ilia3101/MLV-App.git
cd MLV-App/platform/cocoa
make app -j4

Qt App macOS

• install XCode depending on your OSX
• install Qt5 (minimum 5.6)
• unpack ffmpegOSX.zip in platform/qt/FFmpeg
• open platform/qt/MLVApp.pro in QtCreator
• go to tab project, add command line argument -j4 (for quad core)
• Build and Start

Qt App Windows

• install Qt5 (minimum 5.6)
• unpack ffmpegWin.zip in platform/qt/FFmpeg (and copy it later into build directory)
• open platform/qt/MLVApp.pro in QtCreator
• go to tab project, add command line argument -j4 (for quad core)
• Build and Start

Qt App Linux (generally)

• install Qt5 (minimum 5.6) and ffmpeg (we use v3.3.2)
• cd platform/qt/
• qmake MLVApp.pro or equivalent (depending on distro and version and...)
• make -j4 (for quad core)
• ./mlvapp and have fun

A detailed guide for compiling MLV-App on Linux can be found here (thanks to @seescho).

The Code

All the MLV stuff is in src/mlv

Image processing is in src/processing

Other stuff also in src/...

Platform specific/GUI things in platform/...

A note about code style

You may notice a strange mixture of these styles:

1. thisNameStyle
2. this_name_style

The rule I have used in the libraries is: public functions use the thisNameStyle, and private functions use this_one. Keep it in mind if you're going to be adding something major.

Thanks for reading README.md

🐸