HandBrake-docs/source/docs/en/1.0.0/help/troubleshooting-common-issues.markdown
2023-02-25 19:41:33 -05:00

4.0 KiB

Type, State, Title, Project, Project_URL, Project_Version, Language, Language_Code, Authors, Copyright, License, License_Abbr, License_URL
Type State Title Project Project_URL Project_Version Language Language_Code Authors Copyright License License_Abbr License_URL
article
obsolete
Troubleshooting common issues HandBrake https://handbrake.fr/ 1.0.0 English en
Bradley Sepos <bradley@bradleysepos.com> (BradleyS)
2023 HandBrake Team Creative Commons Attribution-ShareAlike 4.0 International CC BY-SA 4.0 https://handbrake.fr/docs/license.html

Troubleshooting common issues

HandBrake for Linux

Cannot find HandBrake executable

The HandBrake graphical interface executable is ghb. Simply launch your terminal application and type ghb followed by the return key.

Please consult your distribution's documentation for how to add HandBrake to your application launcher.

General troubleshooting

Try each of the following steps until HandBrake is working again.

  1. Make sure you have official HandBrake and not a broken third-party build; see Where to get HandBrake
  2. Restart your computer
  3. Delete your HandBrake configuration data and presets (replace username with your own)
    • /home/username/.config/ghb
  4. Install/reinstall the latest version of HandBrake; see Downloading and installing HandBrake

If the above does not solve your issue, someone may be able to help via HandBrake's Community support channels.

HandBrake for Mac

HandBrake does not launch

HandBrake versions prior to 1.1.0 and nightly builds are not code signed using an Apple Developer Certificate. By default, Gatekeeper prevents unsigned applications from running on your Mac.

More information about successfully launching HandBrake is available on Downloading and installing HandBrake.

General troubleshooting

Try each of the following steps until HandBrake is working again.

  1. Restart your computer
  2. Delete your HandBrake configuration data and presets (replace username with your own)
    • /Users/username/Library/Application Support/HandBrake
  3. Install/reinstall the latest version of HandBrake; see Downloading and installing HandBrake

If the above does not solve your issue, someone may be able to help via HandBrake's Community support channels.

HandBrake for Windows

Downloading Microsoft .NET Framework

Windows 10 already contains Microsoft .NET Framework. Updates are available for Windows 7 and 8.1 via Windows Update.

Additionally, you may download one of the following Microsoft .NET Framework standalone installers.

General troubleshooting

Try each of the following steps until HandBrake is working again.

  1. Restart your computer
  2. Install the latest version of Microsoft .NET Framework available for your Windows version
  3. Delete your HandBrake configuration data and presets (replace username with your own)
    • Windows Vista:
      • C:\Users\username\Application Data\HandBrake
      • C:\Users\username\Local Settings\Application Data\HandBrake
    • Windows 7 and later
      • C:\Users\username\AppData\Roaming\HandBrake
      • C:\Users\username\AppData\Local\HandBrake
  4. Install/reinstall the latest version of HandBrake; see Downloading and installing HandBrake

If the above does not solve your issue, someone may be able to help via HandBrake's Community support channels.