mlvfs & mlvfs-indicator

MLVFS

Installation

- Copy the mlfvs binary into your $PATH, e.g to /usr/local/bin
- Install FUSE in the manner appropriate for your distribution (e.g. sudo apt-get install libfuse2)

Useage:
    mlvfs <mount point> --mlv_dir=<directory with MLV files>

To unmount the filesystem:

    fusermount -u <mount point>

NOTE: The webgui does not work in background mode, which is the FUSE default. So to use the webgui, specify the -f switch

To get to the webgui go to http://localhost:8045/

### Command Line Options

#### FUSE options:

    -d   -o debug          enable debug output (implies -f)
    -f                     foreground operation
    -s                     disable multi-threaded operation

#### MLVFS options:

    --port=%s              webgui port (default is 8000)
    --resolve-naming       use DaVinci Resolve / BMD file naming convention (.MLV folders will show up as clips in Resolve)
    --cs2x2                2x2 chroma smoothing (to remove focus pixels on certain camera models and other artifacts)
    --cs3x3                3x3 chroma smoothing
    --cs5x5                5x5 chroma smoothing
    --bad-pix              hot/cold/bad pixel correction
    --really-bad-pix       very aggressive bad pixel correction
    --stripes              fixes vertical banding in highlights (present on some 5D3 and 7D cameras)
    --dual-iso-preview     preview mode for dual-ISO (very fast, but not very goold quality)
    --dual-iso             Full-blown dual-ISO conversion (quite slow)
    --amaze-edge           Dual-ISO interpolation method: use a temporary demosaic step (AMaZE) followed by edge-directed interpolation (default)
    --mean23               Dual-ISO interpolation method: average the nearest 2 or 3 pixels of the same color from the Bayer grid (faster)
    --no-alias-map         disable alias map, used to fix aliasing in deep shadows
    --alias-map            enable alias map, used to fix aliasing in deep shadows
    --prefetch=%d          when a particular frame is requested, start processing the next x frames in other threads
    --fps=%f               override the frame rate in the MLV metadata (for timelapse or slowmo footage)

Use the webgui to modify any of these options while mlvfs is running.

------------------------------------------------------------------------------------------------------------------------------------------

MLVFS-Indicator

Also under GPLv2, mlv-indicator is a python2 based appindicator, which commands some shell-scripts for providing the needed functionality.

MLVFS-Indicator depends on:
sudo apt-get install python-gobject python-gtk python-appindicator python-xdg zenity (debian package list, you will have to adapt on other distros)

Installation

Put the hidden .mlvfs folder into your home folder. It contains the bash scripts which will be running when you click on something in the indicator. If you don't see it, tell your file browser to show hidden files.
To have it's icons work, put the icons inside of the icons folder to /usr/share/icons/ or $HOME/.local/share/icons

You can then just double-click mlvfs-indicator to launch it, or put it into $PATH, e.g /usr/local/bin

If you happen to use nautilus-actions, there is an action called "mount ALL MLV files in this folder via MLVFS.desktop" which you can import into nautilus-actions (3.0 or higher). it will allow you to mount mlv files via the context menu of nautilus, and will start mlvfs-indicator by doing so.

Useage

After the indicator is loaded, you will have numerous options to deal with mlvfs.

- You can mount and unmount .mlv files. You can choose a directory with .mlv files in it, and mlvfs-indicator will mount all .mlv files in that folder to the desired mountpoint, default is /media/magicLantern. Providing this folder exists, the mountpoint should show up in your file browser. If not, it will be created automatically (you will have to enter your password to do so, as this location needs root privileges to be edited.)

- You also have the possibility to start the webinterface of mlvfs (hardcoded to port 8045 in .mlvfs/magicLanternMount right now)
- You can show mlvfs's commandline options in case you want to experiment with them
- You can change the default mountpoint,
- You can edit the mlvfs mount command directly from the indicator
- You can open the directory of the mountpoint in file-browser and terminal.
- You can go to the mlvfs homepage.

Remember, there are just shell-scripts behind these operations, so its fairly easy to customize them. Also the python code behind the indicator is very easy to customize, too.