header-includes
\hypersetup{colorlinks=true, allbordercolors={0 0 1}, pdfborderstyle={/S/U/W 1}}

UNIX FOR ARTISTS

Fun with FFMPEG

Requirements

The following applications and runtime environments are needed to run the scripts used in the workshop. Installation instructions are available below, broken down by operating system.

• Bash - You probably have it already!
• FFMPEG
• ImageMagick
• Youtube-dl
• Golang
• *Python3 (optional)
• *Node.js (optional)

It's very helpful to have a text editor that you can comfortably read and edit scripts in. This selection of text editors ranges from free and open source to "free to use" and "free to try". You can also use TextEdit or Notepad or any text editing application you prefer as long as it's capable of editing in plaintext.

• Atom - Free. macOS, Windows and Linux.
• GNU Emacs - Free. Linux, macOS and Windows.
• Visual Studio Code - Free. macOS, Windows and Linux.
• Sublime Text 3 - Free to evaluate. macOS, Windows and Linux.
• Notepad++ - Free to use. Windows only.
• BBEdit - Freemium. macOS only.

---

macOS

Open the Terminal app located in your Applications folder. Bash 3.2 is available by default on macOS.

Install Homebrew

Go to https://brew.sh and run the command under the "Install Homebrew" heading after pasting it into your Terminal.

You will be asked to confirm a few things while Homebrew installs.

Once the installation process is complete you can install the applications we will be using in this workshop by running the following commands:

brew install ffmpeg imagemagick youtube-dl

Optionally, you can install Node.js for a single example that we will be covering in the workshop.

brew install node

Make sure that you have a compatible version of Python installed by running the following command:

python3 --version

It should print out a value similar to Python 3.8.2. Anything higher than 3.7.0 will work.

Install Golang on macOS

Go to the Golang download site.

Select the "Mac" tab under "2. Go install." if not already selected and download the .pkg installer using the "Download Go for Mac" button.

Open the installer and follow the instructions.

Confirm that Go is installed by running the following command in Terminal:

go version

If Golang has been installed correctly you can now install primitive.

go get -u github.com/fogleman/primitive

---

Windows 10

Windows has its own command-line interpreter, but in order to keep code and examples consistent across different operating systems you will need to install the Windows Subsystem for Linux (WSL).

Enable WSL

Open the "Turn Windows Features on or off" dialog by searching in your command bar.

Enable "Virtual Machine Platform" and "Windows Subsystem for Linux" by selecting the checkboxes next to the items and hit "OK".

Restart your computer for changes to apply.

Install Ubuntu 20.04 LTS

Open the Microsoft Store and search for "Ubuntu". For the latest LTS version, install Ubuntu 20.04.

Other versions of Ubuntu or openSUSE may work, but will be subject to differences in behavior.

Once you've installed Ubuntu, you can open the shell and begin running commands using Bash.

Install Requirements on Windows 10

You can now run the following commands to install the applications for this workshop:

sudo apt update
sudo apt install -y ffmpeg imagemagick youtube-dl

Optionally install Node.js.

sudo apt install -y nodejs npm

Install Golang on Windows 10

Go to the Golang download site.

Select the "Windows" tab under "2. Go install." if not already selected and download the .msi installer by using the "Download Go for Windows" button.

Confirm that Go is installed by running the following command in your shell:

go version

If Golang has been installed correctly you can now install primitive.

go get -u github.com/fogleman/primitive

---

Additional tutorials for installing Bash on Windows 10.

• How to Install Linux Bash Shell on Windows 10
• Install Bash on Windows 10

---

Linux

Open up your preferred terminal application and install the required applications on a Debian-based system.

sudo apt install -y ffmpeg imagemagick youtube-dl

Or, if your distribution uses the yum package manager.

yum install ffmpeg imagemagick youtube-dl

Optionally install Node.js.

sudo apt install -y nodejs npm

Or using yum.

yum install nodejs

Install Golang on Linux

Go to the Golang download site.

Select the "Linux" tab under "2. Go install." if not already selected and download the .tar.gz archive using the "Download Go for Linux" button.

Navigate to the folder you downloaded the archive into. For the following commands, go1.16.3.linux-amd64.tar.gz can be replaced by the filename of the version that you just downloaded.

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.16.3.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

Either restart your terminal or run the command source $HOME/.profile to apply the changes just made to your system.

Confirm that Go is installed by running the following command:

go version

If Golang has been correctly installed you can now install primitive.

go get -u github.com/fogleman/primitive