From 134ab8b17d6d92a21ed7f99be1cf8d27c47a84e5 Mon Sep 17 00:00:00 2001 From: skylar Date: Wed, 11 Nov 2026 15:34:04 -0800 Subject: README: recommend iTerm2 on macOS too Current iTerm2 shows 24-bit colour and reports held keys, so list it beside Ghostty and kitty, with the version it needs and the setting to turn on if the title screen says held keys aren't detectable. Co-Authored-By: Claude Opus 5.5 --- README.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 8a31fb9..abbfdf5 100644 --- a/README.md +++ b/README.md @@ -60,14 +60,19 @@ Your saves carry over. They live in `~/.local/share/orrery/saves`, and `cargo uninstall orrery` removes the game but leaves them. **Which terminal.** Orrery plays in Terminal, with two caveats, and -[Ghostty](https://ghostty.org) or [kitty](https://sw.kovidgoyal.net/kitty/) -avoid both: +[iTerm2](https://iterm2.com), [Ghostty](https://ghostty.org) or +[kitty](https://sw.kovidgoyal.net/kitty/) avoid both: - Terminal on macOS older than 26 (Tahoe) can't show 24-bit colour, so Orrery's colours come out wrong there. - Terminal can't tell when a key is held down, so in flight `↑` and `↓` - step a throttle up and down instead of thrusting while held. Ghostty and - kitty can; the title screen says which kind you're in. + step a throttle up and down instead of thrusting while held. The others + can; the title screen says which kind you're in. + +In iTerm2, keep it up to date (3.6.9 or later: iTerm2 → Check for +Updates). If the title screen says held keys aren't detectable, turn on +Settings → Profiles → Keys → "Apps can change how keys are reported", then +quit Orrery and start it again. Give it a big window, about 120 columns by 40 rows or more. Where the keys below say `ctrl`, that's the Control key, not ⌘. -- cgit v1.2.3