Skip to content

Commit

Permalink
README.md: add high-level technical explanation, tweak
Browse files Browse the repository at this point in the history
  • Loading branch information
rxhfcy authored Apr 6, 2024
1 parent 55626db commit 8620a5a
Showing 1 changed file with 10 additions and 8 deletions.
18 changes: 10 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,15 @@ The app can also be used to change the default Startup Disk directly from the me
3. Navigate to the new folder (Xcode will automatically look for and open the `.xcodeproj` file)
4. You should now be able to build and test the project (please open a new issue if that was not the case!)

## High-level technical explanation:

The app adds a menu bar icon that offers a convenient way to first use `bless --nextboot` so set the temporary Startup Disk for this restart only, and then restarts.

So basically a pretty GUI for the following:
1. Runs `sudo bless --mount "/Volumes/Linux Disk Name/" --setBoot --nextonly`
2. Then restarts the computer relatively gracefully
- the app is not allowed to use the system restart dialog directly, but restarting seems to honor the previously selected "Reopen windows when logging back in" setting (todo: test thoroughly before promising anything)

## Download initial demo version:

Download:
Expand All @@ -65,14 +74,7 @@ Download:
- Don't be stupid
- Keep it simple
- Use non-technical language (give newbies a chance, experts will know how to use the app regardless of word choices)
- Hide implementation details, but if the user explicitly wants to know how and why, explain in a help dialog:
- "this app uses Apple's official 'bless' tool with --nextonly to temporarily make e.g. Linux load after restarting
next time (i.e. without having to change the default Startup Disk value)"
- bonus: teach the possibility of using "sudo bless --mount "/Volumes/Asahi Linux" --setBoot --nextonly" in
Terminal.app and then restarting normally -> change OS for next time only
- bonus: teach newbies the essential skill of holding down the power button to get to boot picker (show animation?)
- bonus: mention the Linux version of this tool (todo) and "Linux bless"
(sudo dnf install asahi-bless && sudo asahi-bless)
- Hide implementation details, but if the user explicitly wants to know how and why, explain in the help dialog

## Stretch goals:
- Somehow convince official Asahi installer to automatically install this app (icon in user's macOS menubar)
Expand Down

0 comments on commit 8620a5a

Please sign in to comment.