robojerk/Libation
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Launch hangover from Libation app bundle for mac

Browse source
This commit is contained in:
Michael Bucari-Tovo 2023-02-13 15:47:25 -07:00
parent 65ef018719
commit 472a0f30b9
13 changed files with 98 additions and 46 deletions
Download patch file Download diff file Expand all files Collapse all files

48
Documentation/InstallOnMac.md
View file

@ -4,40 +4,38 @@
...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.
## Install Libation
- Download latest MacOS zip to downloads folder
- Extract and rename folder to Libation
- in terminal type cd and then drag your folder of libation to terminal so it looks like `cd/users/YourName/Downloads/Libation`
- Type following commands
- Download the `Libation.app.x.x.x.tar.gz` file from the latest release and extract it.
- Move the extracted Libation app bundle to your applications folder.
- Open a terminal (Go > Utilities > Terminal)
- In the terminal type the following commands
- `sudo spctl --add --label "Libation" /Applications/Libation.app` (you'll be prompted to enter your password.)
- `sudo spctl --master-disable`
- Keep the terminal open and run the Libation app
- Go back to terminal and type the following command
- `sudo spctl --master-enable`
- Close the terminal
```console
chmod +x ./Libation
sudo spctl --add --label "Libation" ./Libation
./Libation
Libation is now registered with gatekeeper and will run even when gatekeeper is turned back on.
## Running Hangover
Libation comes with a recovery app called Hangover. You can start it by running this command:
```Console
open /Applications/Libation.app --args hangover
```
## Trouble with Gatekeeper?
## Runnign LibationCli
If Gatekeeper is giving you trouble with Libation:
Disable the block
`sudo spctl --master-disable`
Launch Libation and login, etc. and allow the rules to update then re-enable the block.
`sudo spctl --master-enable`
Once Gatekeeper reenabled, you can open Libation again without it being blocked.
Thanks [joseph-holland](https://github.com/rmcrackan/Libation/issues/327#issuecomment-1268993349)!
Report bugs to https://github.com/rmcrackan/Libation/issues
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:
```Console
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`
## Get Libation running on Mac