detached 19fd124

docs(readme): document Linux ARM64 releases

commit
19fd12491b879f8180a4781270715c326ea5f8c3
author
brice · · 2026-07-18 15:02 UTC
parent
879a3f0
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +10 -2
M README.md +10 -2
@@ -7,7 +7,7 @@ A terminal multiplexer for Linux and macOS on Apple silicon (arm64). One Go bina
77 > [!WARNING]
88 > Alpha software. Expect breaking changes.
99
10-CI covers Ubuntu and macOS arm64. The release installer supports Linux x86_64 and macOS arm64.
10+Pre-built releases are available for Linux x86_64, Linux arm64, and macOS on Apple silicon (arm64). CI tests on Ubuntu x86_64 and macOS arm64; it also verifies cross-compilation for Linux arm64 and macOS arm64. Linux arm64 is not tested on native ARM hardware.
1111
1212 What it is built around:
1313
@@ -18,11 +18,19 @@ What it is built around:
1818
1919 ## Install
2020
21+Install a pre-built release on Linux x86_64/arm64 or macOS Apple silicon (arm64):
22+
23+```sh
24+curl -fsSL https://raw.githubusercontent.com/bnema/vev/main/install.sh | sh
25+```
26+
27+Alternatively, build and install the binary with Go:
28+
2129 ```sh
2230 go install github.com/bnema/vev@latest
2331 ```
2432
25-The default UI runs entirely from the `vev` binary. Optional external bar anchors can be configured in `~/.config/vev/config`.
33+The default UI runs entirely from the `vev` binary. The pre-built installer also installs optional external bar anchors, which only take effect when configured in `~/.config/vev/config`.
2634
2735 ## Usage
2836
@@ -7,7 +7,7 @@ A terminal multiplexer for Linux and macOS on Apple silicon (arm64). One Go bina
7 > [!WARNING]7 > [!WARNING]
8 > Alpha software. Expect breaking changes.8 > Alpha software. Expect breaking changes.
9 9
10-CI covers Ubuntu and macOS arm64. The release installer supports Linux x86_64 and macOS arm64.10+Pre-built releases are available for Linux x86_64, Linux arm64, and macOS on Apple silicon (arm64). CI tests on Ubuntu x86_64 and macOS arm64; it also verifies cross-compilation for Linux arm64 and macOS arm64. Linux arm64 is not tested on native ARM hardware.
11 11
12 What it is built around:12 What it is built around:
13 13
@@ -18,11 +18,19 @@ What it is built around:
18 18
19 ## Install19 ## Install
20 20
21+Install a pre-built release on Linux x86_64/arm64 or macOS Apple silicon (arm64):
22+
23+```sh
24+curl -fsSL https://raw.githubusercontent.com/bnema/vev/main/install.sh | sh
25+```
26+
27+Alternatively, build and install the binary with Go:
28+
21 ```sh29 ```sh
22 go install github.com/bnema/vev@latest30 go install github.com/bnema/vev@latest
23 ```31 ```
24 32
25-The default UI runs entirely from the `vev` binary. Optional external bar anchors can be configured in `~/.config/vev/config`.33+The default UI runs entirely from the `vev` binary. The pre-built installer also installs optional external bar anchors, which only take effect when configured in `~/.config/vev/config`.
26 34
27 ## Usage35 ## Usage
28 36

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 12

Tags 11

↑↓ moveenter openesc close