tyler/Libation
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Libation/Documentation/InstallOnMac.md

3.5 KiB
Raw Permalink Blame History

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 13 (Ventura) and above

Install Libation

  • Download the file from the latest release and extract it.
    • Apple Silicon (M1, M2, ...): Libation.x.x.x-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!

"Apple can't check app for malicious software"

From: How to Open Anyway:

  • On your Mac, choose Apple menu > System Settings, then click Privacy & Security in the sidebar. (You may need to scroll down.)
  • Go to Security, then click Open.
  • Click Open Anyway. This button is available for about an hour after you try to open the app.
  • Enter your login password, then click OK.

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

Run Libation on MacOS