Skip to content

Latest commit

 

History

History
57 lines (37 loc) · 2.42 KB

InstallOnMac.md

File metadata and controls

57 lines (37 loc) · 2.42 KB

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.

  • Open a terminal (Go > Utilities > Terminal)

  • Copy/paste/run the following command (you'll be prompted to enter your 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

Runnign 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