Matt McWilliams 9dc258297c | ||
---|---|---|
audio | ||
bash | ||
ffmpeg | ||
im | ||
img | ||
node | ||
processing | ||
python | ||
stream | ||
text | ||
.gitignore | ||
README.md | ||
download.sh |
README.md
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.
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