---
title: "Installation *FFmpeg*"
author: "Oliver Ehmer"
date: "`r Sys.Date()`"
output:
  rmarkdown::html_vignette:
    toc: true
    toc_float: false
    toc_depth: 2
vignette: >
  %\VignetteIndexEntry{Installation FFmpeg}
  %\VignetteEngine{knitr::rmarkdown}
  \usepackage[utf8]{inputenc}
---
# English
## Windows
To install *FFmpeg* on *Windows* the program must be downloaded and its location must be specified in an environment variable. This is necessary so that FFmpeg can be started easily in the command prompt or terminal. The steps required for installation are explained below for *Windows 10*.

##### (1) Download
*FFmpeg* can be downloaded from the following site:
<https://github.com/BtbN/FFmpeg-Builds/releases>

On this site, *FFmpeg* is available for various operating systems and under several open source licenses. Be sure to download a .zip file that contains `win64` in the name, e.g. the following:

`ffmpeg-N-102754-g604924a069-win64-lgpl.zip`

If the above link does not work, an alternative link is available on the FFmpeg main page <https://ffmpeg.org/download.html>.

##### (2) Unzip
The .zip file will be located in your Downloads folder after downloading. Find the file and extract it. (Right click on the file > "Extract all...")

 ![](images/image001.png)

##### (3) Rename the folder
After unpacking, you will get a folder with the overall name of the original .zip file.

Inside it, there is a subfolder with the same name.
Rename this folder to ffmpeg (right click > "Rename".)

 ![](images/image002.png)

This folder has two subfolders named doc and `bin`. The `doc` folder contains documentation, the `bin` folder contains various program files, among them the file `ffmpeg.exe` .

 ![](images/image003.png)

##### (4) Move the folder
Move the newly renamed `ffmpeg` folder to the main level of your hard disk `C:\` .

To do this, first select the `ffmpeg` folder and press the key combination *CTRL + X* (to cut).

Then navigate to the main level of your hard disk `C:\` and press the key combination *CTRL + V* (to paste).

The folder `ffmpeg` should now be on the main level of the hard disk C:\ and the folder bin should be directly inside it.

(Note: You can also move the folder to another location, but then you will have to adjust the path accordingly in step (8)).

 ![](images/image004.png)

##### (5) Open Advanced System Properties
In the search bar next to the Start menu icon, type `Advanced System Properties`.

 ![](images/image005.png)

From the list of search results, select the “Advanced System Properties” app.

 ![](images/image006.png)

The „System properties“ window opens.

 ![](images/image007.png)

##### (6) Open environment variables
Select "Environment variables..." on this window.

 ![](images/image008.png)

The "Environment variables" window opens.

 ![](images/image009.png)

##### (7) Changing the "Path" variable
Click on the "Path" entry in the upper "User variables" area.
Then select "Edit...".

 ![](images/image010.png)

Another window opens.

 ![](images/image011.png)

Select the "New" command here.

One of the lines is then activated. Enter the following string: `C:\ffmpeg\bin`

 ![](images/image012.png)

(This is the path to the folder where the program ffmpeg.exe is located).

Click "OK”

Close the "Environment Variables" window with "OK”

Close the "System Properties" window with "OK”

##### (8) Testing the installation
In the search bar next to the Start menu icon, type “Command Prompt.”


 ![](images/image013.png)

Select the Command Prompt app from the list.

 ![](images/image014.png)

A terminal window will open.

 ![](images/image015.png)

Enter the following command: 

`ffmpeg -version`

 ![](images/image016.png)

If the installation was successful, you will receive the adjacent output with the version information.

 ![](images/image017.png)

If an error occurs, you will receive the adjacent message that *FFmpeg* could not be found. 

In this case, restart the computer and try the steps in (9) again.

If this does not help, check if the path in the environment variable "Path" is specified correctly and points to the folder where you saved `ffmpeg.exe` .

 ![](images/image018.png)

## macOS
For installation on *macOS* the package manager *homebrew* can be used. The following steps are necessary for installation.

##### (1) Installing XCode
*XCode* can be installed for free via the Apple AppStore.

 ![](images/image019.png)

##### (2) Installing homebrew
For installation, the terminal window in *RStudio* can be used. Alternatively, a separate Terminal window can be opened. The terminal is located in the Applications/Utilities folder of your Mac.

Enter the following command in the Terminal window to install *homebrew*.

`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" `

**Attention:** Copy *both* lines of the command, it is only one command. It does not contain a line break, only spaces.

Then enter your account password and press Enter/Return.

You should get the following display. Press Enter/Return again.
 ![](images/image020.png)

Make sure that the installation is complete. It is only complete when the prompt appears again at the end of the process. 

##### (3) Installing *FFmpeg*
In the terminal, enter the following command: 

`brew install ffmpeg`

To update to a newer version of FFmpeg, you can use the following command:

`brew upgrade ffmpeg` 

##### (4) Testing the installation
To test whether the installation was successful, enter the following command in the terminal window:

`ffmpeg -version`

If multiple lines appear, the installation was successful.

# German

## Windows
Für die Installation von *FFmpeg* unter *Windows* muss das Programm heruntergeladen und darüber hinaus in einer Umgebungsvariable festgelegt werden, wo sich das Programm befindet. Dies ist notwendig, damit *FFmpeg* in der Eingabeaufforderung bzw. im Terminal einfach gestartet werden kann. Die hierfür notwendigen Schritte werden im Folgenden für *Windows 10* erläutert.

##### (1) Herunterladen
Auf der folgenden Seite kann *FFmpeg* heruntergeladen werden:

<https://github.com/BtbN/FFmpeg-Builds/releases>

Auf dieser Seite wird *FFmpeg* für verschiedene Betriebssysteme und unter verschiedenen Open Source-Lizenzen angeboten. Achten Sie darauf, dass Sie eine .zip-Datei laden, die `win64` im Namen enthält, z.B. die folgende:

`ffmpeg-N-102754-g604924a069-win64-lgpl.zip`

Sollte der oben angegebenen Link nicht funktionieren, ist auf der Hauptseite von *FFmpeg* ein alternativer Link verfügbar <https://ffmpeg.org/download.html>.
##### (2) Entpacken
Die .zip-Datei befindet sich nach dem Herunterladen in Ihrem Downloads Ordner. Finden Sie die Datei und entpacken Sie diese. (Rechtsklick auf die Datei > „Alle extrahieren...“)

 ![](images/image001.png)

##### (3) Umbenennen des Ordners
Nach dem Entpacken erhalten Sie einen Ordner mit dem Gesamtnamen der ursprünglichen .zip-Datei.
Darin befindet sich ein Unterordner, der denselben Namen trägt.

Benennen Sie diesen Ordner um in `ffmpeg` (Rechtsklick > „Umbenennen“

 ![](images/image002.png)

In diesem Ordner befinden sich zwei Unterordner mit den Namen `doc` und `bin`. Der Ordner doc enthält eine Dokumentation, der Ordner `bin` enthält verschiedene Programmdateien, unter diesen die Datei `ffmpeg.exe` .

 ![](images/image003.png)

##### (4) Verschieben des Ordners
Verschieben Sie den neu umbenannten Ordner `ffmpeg` auf die Hauptebene ihrer Festplatte `C:\` .

Wählen Sie hierzu zuerst den Ordner `ffmpeg` aus und drücken Sie die Tastenkombination *STRG + X* (zum Ausschneiden).

Navigieren Sie dann auf die Hauptebene Ihrer Festplatte `C:\` und drücken Sie die Tastenkombination *STRG + V* (zum Einfügen).

Danach müsste sich der Ordner ffmpeg auf der Hauptebene der Festplatte `C:\` befinden und direkt darin der Ordner `bin` enthalten sein.

(Anmerkung: Sie können den Ordner auch an eine andere Stelle verschieben, müssen in Schritt (8) dann aber den Pfad entsprechend anpassen.)

 ![](images/image004.png)

##### (5) Erweiterte Systemeinstellungen öffnen
Geben Sie in der Suchleiste neben dem Startmenüsymbol den Begriff `Erweiterte Systemeinstellungen` ein.

 ![](images/image005.png)

Klicken Sie in der Liste der Suchergebnisse auf die App „Erweiterte Systemeinstellungen“.

 ![](images/image006.png)

Es öffnet sich ein Fenster mit den „Systemeigenschaften“.

 ![](images/image007.png)

##### (6) Umgebungsvariablen öffnen
Wählen Sie in diesem Fenster „Umgebungsvariablen...“.

 ![](images/image008.png)

Es öffnet sich das Fenster „Umgebungsvariablen“.
 ![](images/image009.png)

##### (7) Verändern der Variable „Path“
Klicken Sie im oberen Bereich „Benutzervariablen“ auf den Eintrag „Path“.

Wählen Sie dann „Bearbeiten...“.


 ![](images/image010.png)

Es öffnet sich ein weiteres Fenster.

 ![](images/image011.png)

Wählen Sie hier den Befehl „Neu“.

Eine der Zeilen ist dann aktiviert. Tragen Sie hier die folgende Zeichenkette ein: 

`C:\ffmpeg\bin`
 ![](images/image012.png)

(Dies ist der Pfad zu dem Ordner, in dem das Programm `ffmpeg.exe` liegt.)

Klicken Sie auf „OK“

Schließen Sie das Fenster „Umgebungsvariablen“ mit „OK“

Schließen Sie das Fenster „Systemeigenschaften“ mit „OK“


##### (8) Testen der Installation
Geben Sie in der Suchleiste neben dem Startmenüsymbol den Begriff `Eingabeaufforderung` ein.

 ![](images/image013.png)

Klicken Sie auf die App „Eingabeaufforderung“ in der Liste.

 ![](images/image014.png)

Es öffnet sich ein Terminal-Fenster.

 ![](images/image015.png)

Geben Sie hier den folgenden Befehl ein:

`ffmpeg -version`

 ![](images/image016.png)

Wenn die Installation erfolgreich war, erhalten Sie die nebenstehende Ausgabe mit den Versionsinformationen. 
 ![](images/image017.png)

Bei einem Fehler erhalten Sie die nebenstehende Nachricht, dass *FFmpeg* nicht gefunden werden konnte. In diesem Fall starten Sie den Computer neu und versuchen Sie die Schritte unter (9) nochmals.

Wenn dies nicht hilft, prüfen Sie, ob der Pfad in der Umgebungsvariable „Path“ richtig angegeben ist und auf den Ordner zeigt, in dem sie die `ffmpeg.exe` gespeichert haben.

 ![](images/image018.png)

## macOS
Für die Installation unter *macOS* kann der Paketmanager *homebrew* genutzt werden. Zur Installation sind die folgenden Schritte notwendig.

##### (1) Installieren von XCode
*XCode* kann kostenlos über den Apple *AppStore* installiert werden.

 ![](images/image019.png)

##### (2) Installieren von homebrew
Zur Installation kann das Terminal-Fenster in *RStudio* genutzt werden. Alternativ kann ein separates Terminal-Fenster geöffnet werden. Das Terminal liegt im Ordner „Programme/Dienstprogramme“ Ihres Mac.

Geben Sie den folgenden Befehl in das Terminal-Fenster ein, um *homebrew* zu installieren.

`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`

**Achtung**: Kopieren Sie *beide* Zeilen des Befehls, es handelt sich nur um einen Befehl. Er enthält keinen Zeilenumbruch, sondern lediglich Leerzeichen.

Geben Sie dann das Passwort Ihres Accounts ein und drücken Sie Enter/Return.

Sie sollten die folgende Anzeige erhalten. Drücken Sie nochmals Enter/Return.
 ![](images/image020.png)

Achten Sie darauf, dass die Installation komplett erfolgt. Diese ist erst komplett, wenn am Ende des Prozesses wieder die Eingabeaufforderung erscheint. 

##### (3) Installieren von *FFmpeg*
Geben Sie im Terminal den folgenden Befehl ein:

`brew install ffmpeg`

Um ein Update auf eine neuere Version von *FFmpeg* zu machen, können Sie den folgenden Befehl nutzen:

`brew upgrade ffmpeg`

##### (4) Testen der Installation
Um zu testen, ob die Installation erfolgreich war, geben Sie im Terminal-Fenster den folgenden Befehl ein:

`ffmpeg -version`

Wenn mehrere Zeilen ausgegeben werden, war die Installation erfolgreich.



