A feature-rich RAW video developer for Magic Lantern formats.
 
 
Go to file
Sofus Albert Høgsbro Rose 962d8311bc
Another README tweak
2017-01-09 00:00:05 -05:00
binaries Added code that clones magic-tools to build the newest ML binaries quickly & easily. Also fixed the licensing for the binaries. 2016-12-31 18:55:52 +01:00
color-core Huge color management release. Added lists getting ready for true compatibility, multiple LUTs, dcraw paths, updated convmlv -h. 2016-07-09 02:11:59 +02:00
color-ext Huge color management release. Added lists getting ready for true compatibility, multiple LUTs, dcraw paths, updated convmlv -h. 2016-07-09 02:11:59 +02:00
configs Huge color management release. Added lists getting ready for true compatibility, multiple LUTs, dcraw paths, updated convmlv -h. 2016-07-09 02:11:59 +02:00
docs Added cleanDocs, added package signing to mkrelease.sh, edited readme. Updated alpha version. 2016-12-09 00:36:50 -05:00
src Using array; start wipe of globals. Need to complete arg functions, globals transition, and modularization of develop() before a lot of code cleanup, then the plugin system. That'll deserve a merge, where I'll branch into the big califrames, then start committing modular features. Before 2.1.0 I'll do some RCs for myself, reevaluate the colorspace bug, and that'll be it! 2016-12-08 22:37:22 -05:00
7D_badpixels.txt Fixed the huge colorspace bug (in a weird way - see Nasty Hacks in source). Fixed sRange 1 n error, where no output would be given. Implemented hqdn3d denoiser, and ffmpeg deshake, filters. 2016-06-27 00:59:14 -04:00
CHANGELOG Added cleanDocs, added package signing to mkrelease.sh, edited readme. Updated alpha version. 2016-12-09 00:36:50 -05:00
README.md Another README tweak 2017-01-09 00:00:05 -05:00
convmlv.geany Added code that clones magic-tools to build the newest ML binaries quickly & easily. Also fixed the licensing for the binaries. 2016-12-31 18:55:52 +01:00
convmlv.sh Added cleanDocs, added package signing to mkrelease.sh, edited readme. Updated alpha version. 2016-12-09 00:36:50 -05:00
deploy.sh Heavy modularization for ease of development! convmlv.sh is now just a chooser, triggering functions in src. More work to do. 2016-12-06 00:56:08 -05:00
licence Huge color management release. Added lists getting ready for true compatibility, multiple LUTs, dcraw paths, updated convmlv -h. 2016-07-09 02:11:59 +02:00
mkBinaries.sh Added code that clones magic-tools to build the newest ML binaries quickly & easily. Also fixed the licensing for the binaries. 2016-12-31 18:55:52 +01:00
mkrelease.sh Added code that clones magic-tools to build the newest ML binaries quickly & easily. Also fixed the licensing for the binaries. 2016-12-31 18:55:52 +01:00

README.md

convmlv

RAW Formats (Magic Lantern) to Images/Movies Developer

I needed a workflow to provide me full control over development for filmmaking with Magic Lantern (beyond mlrawviewer's excellent preview!), while keeping things simple by providing defaults for everything.

So, I wrote this: A program that converts from RAW formats (MLV, RAW, DNG, CR2) to workable formats (EXR, MOV, DPX, DNxHD, MJPEG, etc.) with many, many features in between (color management, filters, dual iso, demosaic, etc.)

It's extensible, letting you write plugins controlling/filtering any leg of the journey from raw to developed. Config file syntax also makes it a kind of "make for productions"; with configs and one command, you can develop your whole project from unsorted raw footage to editable, proxied, organized stuff!

I use it myself :D so here's some shorts with it (back at v1.7) in action!!

http://youtu.be/yi-G7sXHB1M http://youtu.be/yi-G7sXHB1M

See the primary development repo on my GitLab: https://git.sofusrose.com/so-rose/convmlv

Installation

Supported platforms are Linux and Mac. To install, copy/paste the following into a terminal:

  1. Extract tarball. Rename it "convmlv" and put it somewhere useful. cd to that directory.
  2. Install Deps: sudo apt-get install $(./convmlv.sh -K <number>). Replace as indicated below:
    • For Debain, use the number "0"
    • For Fedora, replace apt-get with yum and use the number "2".
    • For Mac, replace sudo apt-get with brew and use the number "3". *Requires Homebrew to be installed.
  3. Install Python deps: sudo python3 -m pip install $ (./convmlv.sh -Y)
  4. (Optional) Add to Path: sudo ln -s $(pwd)/convmlv.sh /usr/local/bin/convmlv

You're done! For more info, see the Documentation (especially the PDF has a guide to this).

Documentation

Especially the PDF is designed as a tutorial; take a look!

The Forum Thread at http://www.magiclantern.fm/forum/index.php?topic=16799.0 is always up to date.

The PDF found in the release is up to date, including tutorials, tips, explanations, plugin API, and more.

The Help Page is the most up to date; just run convmlv -h or look at docs-->MANPAGE in the release tarball.

Development

To build the PDF and MANPAGE using LATEX, run docs/buildDocs.sh. You can clean it up using docs/cleanDocs.sh.

To make a release tarball, simply place all the manual binary deps into the binaries dir and run ./mkrelease.sh. Optionally, you can call ./mkrelease bare to make a release without included examples.

The source code is located in src, where you'll find bash and Python code, as well as the builtin plugins. convmlv.sh itself imports all the src's, and acts as a kind of program selector; develop is but one option.