Skip to content

Latest commit

 

History

History
73 lines (46 loc) · 3 KB

InstallOnMac.md

File metadata and controls

73 lines (46 loc) · 3 KB

Download Libation

If you found this useful, tell a friend. If you found this REALLY useful, you can click here to PayPal.me

...or just tell more friends. As long as I'm maintaining this software, it will remain free and open source.

Run Libation on MacOS

This walkthrough should get you up and running with Libation on your Mac.

Supports macOS 10.15 (Catalina) and above

Install Libation

  • Download the file from the latest release and extract it.
    • Apple Silicon (M1, M2, ...): Libation.9.4.2-macOS-chardonnay-arm64.tgz
    • Intel: Libation.x.x.x-macOS-chardonnay-x64.tgz
  • Move the extracted Libation app bundle to your applications folder.
  • Right-click on Libation and then click on open
  • The first time, it will not immediately show you an option to open it. Just dismiss the dialog and do the same thing again (right-click -> open) then you will get an option to run the unsigned application. This takes about 10 seconds.

If this doesn't work

You can add Libation as a safe app without touching Gatekeeper.

  • Copy/paste/run the following command. Adjust the file path to the Libation.app on your computer if necessary.

    xattr -r -d com.apple.quarantine ~/Downloads/Libation.app

  • Close the terminal and use Libation!

If this still doesn't work

  • Copy/paste/run the following command (you'll be prompted to enter your Mac password)

    sudo spctl --master-disable && sudo spctl --add --label "Libation" /Applications/Libation.app && open /Applications/Libation.app && sudo spctl --master-enable
  • Close the terminal and use Libation!

Troubleshooting

If Libation fails to start after completing the above steps, try the following:

  1. Right-click the Libation app in your applications folder and select Show Package Contents
  2. Open the Contents folder and then the MacOS folder.
  3. Find the file named Libation, right-click it, and then select Open.

Libation should launch, and you should now be able to open Libation by just double-clicking the app bundle in your applications folder.

Running Hangover

Libation comes with a recovery app called Hangover. You can start it by running this command:

open /Applications/Libation.app --args hangover

Running LibationCli

Libation comes with a command-line interface. Unfortunately, due to the way apps are sandboxed on mac, its use is somewhat limited. To open a new sandboxed terminal in LibationCli's directory, run the following command:

open /Applications/Libation.app --args cli

To use LibationCli from an unsandboxed terminal, you must disable gatekeeper again and run the program directly at /Applications/Libation.app/Contents/MacOS/LibationCli

Then use ./LibationCli to execute a command.

Get Libation running on Mac

Libation_macOS_Installation.mp4