MLV-App (english)

01 App

Deutsche Version des Guides

This side is at present updated.

Table of Contents

Preamble
Introduction
Is there a user manual for MLV App?
How can I get MLV-App?
What must I do to get MLV-App working?
But I have Linux! What can I do?
OK! But what do you tell us in this tutorial exactly?
Some preparations
Download and unzip MLV-App
ffmpeg
The MLV-App folder
ffmpeg, once again
ffmpeg, for the last time
Some other preparation
Compile
MLV-APP
If something goes wrong?
Summary


Preamble

I tested the procedures, I show in this tutorial, with these Linux-versions:

  • openSUSE Leap 42.3
  • openSUSE Tumbleweed
  • Kubuntu 18.04 LTS

Using other Linux-distibutions, the way to go for a running MLV-App should be similar to the way, I show you for openSUSE. But the details will be different (Another paket-manager, other repositorys, other filenames…)

I didn´t test other Linux-distributions, so you will have to find the correct way yourself…


Introduction

MLV App is a tool to decode, playback, process and export MLV raw-videos (Magic Lantern). At the moment, MLV-App support these export-formats:

  • prores (up to 12bit)
  • rawavi (8bit)
  • h264 (8bit)
  • h265 (8bit)
  • cdng (up to 16bit)
  • tiff (16bit)
  • png for the actual preview-frame (8bit)
  • MLV (without audio)

There are bin-files for MacOS, Windows and Linux.


Is there a user manual for MLV App?

Not yet.
But you can have a look at the discussion in the MagicLantern forum:

http://www.magiclantern.fm/forum/index.php?topic=20025.0


How can I get MLV-App?

MLV-App can be downloaded from github:

https://github.com/ilia3101/MLV-App


What must I do to get MLV-App working?

Quite simple:

  • download the bin-file from github
  • start the app be clicking the bin-file
  • enjoy

There are actual bin-files for Windows and MacOs. The Linux bin-file is a bit outdated.


But I have Linux! What can I do?

Quite simple:

  • compile it yourself!

Oh! I see cold sweat dripping off your forehead. But don´t worry! Compiling is not as difficult as it looks 🙂


OK! But what do you tell us in this tutorial exactly?

I show you, how you can compile MLV-App yourself using Linux openSUSE.

So, let´s go….


Some preparations

I create a subfolder in my home directory, called MLV-App.  I put all the necessary stuff for MLV_App into this folder.

Makes it a bit more overseeable for me…

I create this subfolder using the filemanager dolphin. But I want to show you the way, using a terminal, too:

  • open a terminal
  • type the following code:
mkdir $HOME/MLV-App


Download and unzip MLV-App

Download the MLV-App project from github as a zip file:

02 download MLV_App

Save the zip-file into $HOME/MLV-App folder. Unzip the file.


ffmpeg

ffmpeg is a nice tool to decode, encode, change … video-files. MLV-App uses ffmpeg for encoding.

ffmpeg is shipped with openSUSE, but it´s not installed per default. It is not rocket science to open the paketmanager in openSUSE for installing ffmpeg. But I guess, we will not be happy with this ffmpeg-version.

For licensing reasons, the ffmpeg-version shipped with openSUSE is limited. Not all codecs are supported.

MLV-App needs more codecs, so a full version of ffmpeg is necessary. One way to get such a full version is to download it from the ffmpeg-website. We need the static linux  build (the git-version):

03 ffmpeg download

Save the tar-file into $HOME/MLV-App folder. Decompress the file.


The MLV-App folder

This is how my MLV-App folder lookes like atm:

02 folder

All in there, what I need…


ffmpeg, once again

Did I tell you, that MLV-App use ffmpeg for encoding? Yes? Fine!

But now, we have a problem, Huston!

The operating system cannot find ffmpeg, not knowing the exact path of the bin-file. But there are some directories, in which openSUSE lookes for bin-file automatically. So we onlny have to copy the ffmpeg bin-file into such a directory and we will be the winner!

We can look, which direcories openSUSE use for this, if we type the following code into a terminal:

echo $PATH

I prefere $HOME/bin and copy the ffmpeg bin-file into this folder:

03 ffmpeg


ffmpeg, for the last time

We can go the route, I told you, to get ffmpeg: download and decompress ffmpeg, copy the bin file into the $HOME/bin folder.

But there is another way as well: We can use ffmpeg from openSUSE. All we have to do ist to add the packman repository (with Yast). ffmpeg from packman has all the codecs MLV-App needs.

We install ffmpeg from packman, settle back and open a nice bottle of bear 🙂

OK! That´s all! Now we can start compiling….


Some other preparation

It would be nice, if we could compile MLV-App now. But there is a little thing missing: We need a developement envirement!

Don´t worry! We have openSUSE. And  we have a nice paketmanager. So we only have to install two pakets to be happy. The paketmanager does the rest for us:

openSUSE

  • open YAST
  • enter the administrator password
  • click: Software Manager
  • install: libqt5-creator
  • install: libqt5-qtmultimedia-devel

Kubuntu

I just need to istall one more package than with openSUSE. And the other two packages got other names.

  • Open package-manager (Muon) und install:
  • qtcreator
  • qtmultimedia5-dev
  • qt5-default

The package qt5-default set qt 5 as default :)) Without this package, kubuntu is looking for a qmake for qt4. It will not find one and is grumbling…


Compile

We as linux-users are interested in the qt-version of MLV-App. This platform can be found in the MLV-App-master folder:

04 qt

We change into this directory using dolphin (screenshot above) or using a terminal. Let´s try it with the terminal:

Open a terminal an type:

cd $HOME/MLV-App/MLV-App-master/platform/qt

To be sure to have no skeletons in the qt-folder, we type a nice little:

make clean

and than for preparing the compilation

qmake-qt5 ( with openSUSE)
or
qmake (with kubuntu)

now we can compile:

make

Now you can wring out the handkerchief, you have used to dry your forehead. It will be the best to loan back and open another bottle of bear…


MLV-APP

If all went fine, we can find a file called mlvapp in the MLV-App-master/platform/qt-folder. This is, how MLV-App is called in Linux.

Click on mlvapp open MLV-App 🙂

If we want, we can copy this file onto the desktop. Is easier to find, then…


If something goes wrong?

Then something is wrong, i guess. We will have to search the error. One nice little tool for this debugging ist the QT-Creator.


Summary

That was many words to read. So here a short summary of the way, I prefere. This is my way:

Install packages (openSUSE)

  • libqt5-creator
  • libqt5-qtmultimedia-devel
  • ffmpeg (packman-repository)

Install packages (Kubuntu)

  • qtcreator
  • qtmultimedia5-dev
  • qt5-default
  • ffmpeg (repository is following…)

MLV-APP Source

  • Download MLV-App (ZIP)
  • Extract  the zip-file  into ~/MLV-App

Compile (openSUSE)

  • change into ~/MLV-App/MLV-App-master/platform/qt
  • make clean
  • qmake-qt5
  • make

Compile (kubuntu)

  • change into ~/MLV-App/MLV-App-master/platform/qt
  • make clean
  • qmake
  • make

 

Have fun with MLV-App