Follow

How-to install required components

VideoDrive 3 requires several components to function properly. These components are downloaded and installed during the Welcome wizard when first launching VideoDrive. In some rare circumstances, automatic installation may fail. When this happens, the VideoDrive Welcome Wizard will show which components failed to install. Depending on which component(s) are missing, follow the next steps to install the missing components manually on your system:

 

step 1) Run the Welcome Wizard

If the Welcome Wizard is displayed at startup, follow the steps until you can no longer proceed because of the missing components. If the Welcome Wizard is not displayed, you can launch it from the menu bar under 'Help'. Next, install the missing component(s) as described below. Do not quit the Welcome Wizard.

 

step 2) Install the missing component(s)

 

Install HandBrake

HandBrake is an open-source tool offering fast and reliable video conversions. Follow these steps to install the required components:

Short explanation: Download HandBrakeCLI and move it to the folder /usr/local/bin/

Long explanation:

Step 1)  Download HandBrakeCLI from the HandBrake website. Make sure to always download the HandBrakeCLI (Command Line Interface) 64-bit version for Mac.

Step 2) Open the downloaded DMG file by double clicking it.

Step 3) Open Terminal and copy/paste the following command and press ENTER to create the required system folder. The user admin password will be asked.

sudo mkdir /usr/local/bin/

Step 4) Move the downloaded HandBrakeCLI file to that folder. This system folder is hidden by default on macOS. To easily copy the file, copy/paste the following command in Terminal and press ENTER. Replace nameofthevolume with the name of the DMG file you just downloaded.

sudo cp /Volumes/nameofthevolume/HandBrakeCLI /usr/local/bin/

 Step 5) Check that HandBrakeCLI is correctly installed by running the following command in the Terminal:

 HandBrakeCLI --version

The message "Your version of HandBrake is up to date." should be displayed. If the message "command not found" or another error is shown, HandBrakeCLI was not properly installed. Possibly, your Path is incorrectly set. Check this article to set the Path correctly.

 

Install Subler

Subler is an open-source tool offering remuxing of H.264 tracks and can save metadata inside video files. Follow these steps to install the required components:

Short explanation: Download SublerCLI and move it to the folder /usr/local/bin/

Long explanation:

Step 1)  Download SublerCLI (ZIP file) from the Subler website. Make sure to always download the Subler (Command Line Interface) version for Mac.

Step 2) macOS will automatically unzip the file after downloading. If not, open the downloaded ZIP file by double clicking it.

Step 3) Open Terminal and copy/paste the following command and press ENTER to create the required system folder. The user admin password will be asked (skip this step if you already did this while installing HandBrake)

sudo mkdir /usr/local/bin/

Step 4) Move the downloaded SublerCLI file to that folder. This system folder is hidden by default on macOS. To easily copy the file, copy/paste the following command in Terminal and press ENTER.

sudo cp ~/Downloads/SublerCLI /usr/local/bin/

Step 5) Check that SublerCLI is correctly installed by running the following command in the Terminal:

SublerCLI -version

The version number should be displayed. If the message "command not found" or another error is shown, SublerCLI was not properly installed. Possibly, your Path is incorrectly set. Check this article to set the Path correctly.

 

Install audio codecs

You may need to download an audio codec to handle stereo and 5.1 surround sound from A52 and AC-3 audio. This type of audio is often found in DVD movies. If this codec is not present, VideoDrive will warn you as without the codec, your resulting iTunes videos might be missing audio.

Step 1) Download the A52codec from the Aroona Software download server.

Step 2) Unzip the A52codec.component file and move it to  /Library/Audio/Plug-Ins/Components. Run the following command from the terminal line:

sudo mv ~/Downloads/A52Codec.component /Library/Audio/Plug-ins/Components

 

 

Install Satimage.osax

Satimage.osax provides search-and-replace commands and regular expressions and is used in VideoDrive to analyse file names. If this library is not present, VideoDrive will not be able to analyse file names.

Step 1) Download Satimage.osax from the Satimage download server.

Step 2) Run the downloaded file to copy the library to its destination system folder /Library/ScriptingAdditions/Satimage.osax

 

 

 

Step 3) Finish the Welcome Wizard

After finishing the steps above, click "Verify" in the Welcome Wizard. VideoDrive will detect the installed components. Click Next to continue the wizard.

If the components are still not detected, contact Technical Support.

 

This article applies to VideoDrive 3.4 and above 

4 Comments

  • Avatar
    Erik Austin Deerly

    OSX 10.11 will not allow VideoDrive to access the directory usr/local/bin by default, due to changes in security. Therefore, even when those CLIs were copied, Videodrive is not able to verify until the following changes have been made: 

    sudo chown -R $(whoami) /usr/local/bin

    sudo chmod -R 755 /usr/local/bin

    Once this has been done, VideoDrive sees the files and all is well. This is obviously NOT going to work for most users, so another solution should be found for OSX 10.11 and beyond. 

  • Avatar
    Bart

    Thanks for reporting this. There are indeed some cases where there's an issue on El Capitan: for instance if users have deleted the /usr/local folder, it's impossible to recreate it. In that case, the CLI files should be stored somewhere else and added to the $PATH variable.

    We have tested our new Welcome Wizard with new installations of El Capitan, and creating the /usr/local/bin subfolder and adding the CLI files to it, should work fine though. 

  • Avatar
    Ramiro Garcia

    I have tried both options listed above, am running the latest OS X Capitan & iTunes but still can;t get past the HandBreak install verification....funny thing is I had Handcbreak already, re-installed it per the above instructions and nothing... still will not find it when VideoDrive tried to "verify"...here is my screenshot

  • Avatar
    Bart

    Ramiro, we have updated this support article. Please check step 5 under "Install HandBrake" to verify if HandBrakeCLI is properly installed on your system.

Please sign in to leave a comment.
Powered by Zendesk