Skip to content

Commit

Permalink
Make README a little bit less wordy, minor fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
rxhfcy committed Apr 8, 2024
1 parent 73a5575 commit dfb8262
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 31 deletions.
11 changes: 6 additions & 5 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
{
"cSpell.ignoreWords": [
"--nextonly",
"NVRAM",
"diskutil",
"nextonly",
"Asahi",
"NVRAM",
"asahi",
"bootable",
"prefs"
"diskutil",
"prefs",
"xcodeproj"
]
}
}
37 changes: 11 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,10 +55,10 @@ This application is designed to work around the "invisibility" and slowness of t
On traditional x86-based dual-boot systems, a boot picker will usually automatically appear on the screen on startup,
but on Apple silicon, the boot picker is only allowed to be shown
if the user physically holds down the power button for several seconds while starting up the computer.
This makes it rather inaccessible, especially for inexperienced users who aren't already famililar with this quirk.
This makes it rather inaccessible, especially for inexperienced users who aren't already familiar with this quirk.
For technical reasons, Apple's boot picker is also rather slow to load the selected OS.

In essence, the app is a convenient GUI to run Apple's official `bless` tool with --nextonly
In essence, this app is a GUI to run Apple's official `bless` tool with --nextonly
(`sudo bless --mount "/Volumes/Linux Disk Name/" --setBoot --nextonly`)
to temporarily use an alternative startup disk for this restart only, and then restart.

Expand Down Expand Up @@ -92,37 +92,22 @@ Download:<br>
- Can't launch Asahi Linux installer from this app, at least for now

## Goals:
- The actual point of this app: make it easy to select which OS to use next
- The actual point of this app (and the Linux version): make it easy to select which OS to use next
- instead of requiring every user to already know the holding-down-the-power-button trick
(and/or to already know how to change the default startup disk)
- Help users conveniently boot to whichever OS they want (use the Linux version to do the same on Linux)
- Don't be annoying
- Keep it simple
- Use non-technical language (give newbies a chance, experts will know how to use the app regardless of terminology)

## Stretch goals:
- Somehow convince the official Asahi installer to automatically install this app:
add icon in the user's macOS menubar (!)
- Somehow convince Asahi project to take over and adopt this app
(have someone else maintain it, and fix the code if necessary)
- Bonus: somehow convince Asahi installer to not silently make Asahi Linux the default Startup Disk
- reason: from a new user's perspective, the installer completely hides all evidence of the user's
macOS installation ever having existed by default,
unless you already happen to know the secret spell or gesture (!)
- Convince the official Asahi installer to automatically install this app, i.e. add the app icon on macOS (!)
- Bonus goal: convince Asahi installer to not silently make Asahi Linux the default Startup Disk
- reason: from a new user's perspective, the installer by default completely hides all evidence of the user's
macOS installation ever having existed, unless you already happen to know the secret spell or gesture (!)

### (Stretch goals for the Linux version)
- Somehow convince the OS the Asahi installer installs (currently Fedora Asahi Remix) to automatically
install a corresponding app icon in Linux too (todo: implement Linux version of this app)
- Convince "Linux" (currently Fedora Asahi Remix) to automatically install the Linux version of this app (add icon)
- Additional benefit: `asahi-bless` will be useful to users (required dependency)
- Also install the extension that allows showing the icon on Gnome? (KDE Plasma allows showing the icon by default)
- Bonus: somehow convince the developer of "asahi-bless" (the Linux "bless" counterpart) to add more helpful
command line options, and generally make the tool easier to use
- Bonus: somehow convince the OS the Asahi installer installs (currently Fedora Asahi Remix) to automatically
install asahi-bless by default

## Non-goals:
- Don't support macOS versions older than 13.5 (only support what the Asahi Linux installer supports)
- Don't support Intel Macs (only support what the Asahi Linux installer supports)
- Don't implement anything that could be considered "scope creep"
- NOTE: would being "Asahi Linux Helper" be too much scope creep?
- Bonus goal: convince the developer of `asahi-bless` (the Linux `bless` counterpart) to add more helpful
command line options, and generally make the tool easier to use

# See also: [TODO.md](./Asahi%20Linux%20Helper/TODO.md)

0 comments on commit dfb8262

Please sign in to comment.