Getting Started with SAVE v1.3.x on Ubuntu/Debian

This guide assumes you have successfully downloaded the most recent version of SAVE.Core.MainTool-1.3.x from SAVE's Official Webpage using your Patreon account, onto your Windows, OSX, or Linux computer. At the moment we provide no official support or guidance for users on Linux distros other than Debian or Ubuntu.

Make sure you have downloaded the correct file for your system! All supported desktop platforms include releases for both x64 and arm64 systems, except for Windows which only supports x64 at the moment. Follow the steps below in order to start using SAVE v1.3.x on your Ubuntu or Debian based system:

Step 1: Extract the ZIP archive file to a permanent directory

This step is effectively self explanatory; However we stress that users should extract their copy of SAVE v1.3.x to a permanent directory OUTSIDE of the Downloads folder. Instead, use a directory such as My Documents\Chosen Few Software\SAVE-1.3.x.

Step 2: Register your copy of SAVE with Chosen Few Software

Before you can use any copy of SAVE, you must register the product using a valid license key. In order to register your copy of SAVE with our servers, copy your license key to the clipboard from the My CFS Benefits page, and follow these sub-steps:

  1. Open the Terminal app inside of the directory you created in Step 1. To do this, right click inside the SAVE folder and click "Open in Terminal"
  2. Run this command: chmod +x ./SAVE.Core.MainTool.exe
  3. Next, run this command: ./SAVE.Core.MainTool.exe <your license key here>. Of course, you should substitute <your license key here> with the text you copied in the previous sub-step. DO NOT INCLUDE THE ANGLE BRACKETS (<>) IN THE COMMAND! Once you have finished typing the command, hit the Enter key.

For more information about your license key, how long it is valid, and when it can be revoked, see Benefits.

Already have FFmpeg installed? Prefer a manual install?

Caution

Before diving into this custom installation step, run ffmpeg -version at the command line and ensure that you have FFmpeg 7.1.x installed. If this command prints an error, skip to Step 3 below!

If you're familiar with the FFmpeg toolkit, or have used it on your system before, you may already have an existing installation of FFmpeg that you prefer to use. Use the Terminal window from Step 2.1 to tell SAVE where you have FFmpeg installed using the following command:
echo /usr/lib > .ffmpeg

Note

Note well that /usr/lib is used above only as an example. Depending on your system and preferred package manager, you may have to do some digging on your own to find out the correct override path for SAVE to find the FFmpeg libraries.

Caution

SAVE only works with the shared build version of FFmpeg. So, if your package manager only provides a static build of FFmpeg, you will still have to use the method outlined below.

Step 3: Install Homebrew

Using the Terminal window you opened in Step 2.1, run the following command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

There may be additional installation instructions to follow after installing the Homebrew package manager. If that is the case, they will be printed to the Terminal window. Simply follow the instructions as they apply to your system.

Step 4 (Automatic): Download FFmpeg 7.1

Using the same Terminal, run the following command:
brew install ffmpeg

If the command starts to run, it should automatically fetch the correct version of FFmpeg built for Linux under the GPL software license, extract it, and place it in the correct directory for SAVE to function properly. After the Terminal window finishes execution and returns to the prompt, keep it open and move onto the final step in this guide.

Step 5: Checking your work

Finally, in the Terminal window, run the command: ./SAVE.Core.MainTool.exe -h. If all of the above steps were completed correctly, you should see basic documentation on how to use the tool display on your screen.

Next steps

Proceed to check out Key Concepts and Complete List of SAVE v1.3.x Modules.