summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorskylar <me@casper>2026-11-11 15:34:04 -0800
committerskylar <me@casper>2026-11-11 15:34:04 -0800
commit134ab8b17d6d92a21ed7f99be1cf8d27c47a84e5 (patch)
treeab31147abab5a301d1af94a97ee35b0aa7bc682a
parent9ccf951473e21a8b90c25161156fa09a9b227a7b (diff)
README: recommend iTerm2 on macOS tooHEADmain
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 <noreply@anthropic.com>
-rw-r--r--README.md13
1 files 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 ⌘.