detached 8cd9673

docs: document AUR and release installation

commit
8cd9673d06da4858ab60e2e746c5610c03484130
author
brice · · 2026-10-01 03:06 UTC
parent
1a6f38b
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +12 -3
M README.md +12 -3
@@ -24,14 +24,23 @@ It uses standard protocols only: `ext-idle-notify-v1`, `ext-session-lock-v1`, `w
2424
2525 ## Install
2626
27-Arch Linux: `make pkg` builds a package of the committed HEAD from `packaging/arch/PKGBUILD` into `dist/`, and `make install` installs it with pacman. `packaging/aur/neferafk-git/PKGBUILD` builds the latest `main`.
27+On Arch Linux, install from the AUR:
2828
29-From source:
29+```sh
30+paru -S neferafk-bin # latest release, pre-built
31+paru -S neferafk-git # latest main, built from source
32+```
33+
34+Pre-built archives are on the [releases page](https://github.com/bnema/neferafk/releases). To build from a checkout:
3035
3136 ```sh
32-CGO_ENABLED=0 go build -o bin/neferafk ./cmd/neferafk
37+CGO_ENABLED=0 go build -o bin/neferafk ./cmd/neferafk # builds bin/neferafk
38+make pkg # builds an Arch package of HEAD into dist/
39+make install # builds that package and installs it with pacman
3340 ```
3441
42+The packages install `/etc/pam.d/neferafk` for password mode.
43+
3544 ## Usage
3645
3746 ```
@@ -24,14 +24,23 @@ It uses standard protocols only: `ext-idle-notify-v1`, `ext-session-lock-v1`, `w
24 24
25 ## Install25 ## Install
26 26
27-Arch Linux: `make pkg` builds a package of the committed HEAD from `packaging/arch/PKGBUILD` into `dist/`, and `make install` installs it with pacman. `packaging/aur/neferafk-git/PKGBUILD` builds the latest `main`.27+On Arch Linux, install from the AUR:
28 28
29-From source:29+```sh
30+paru -S neferafk-bin # latest release, pre-built
31+paru -S neferafk-git # latest main, built from source
32+```
33+
34+Pre-built archives are on the [releases page](https://github.com/bnema/neferafk/releases). To build from a checkout:
30 35
31 ```sh36 ```sh
32-CGO_ENABLED=0 go build -o bin/neferafk ./cmd/neferafk37+CGO_ENABLED=0 go build -o bin/neferafk ./cmd/neferafk # builds bin/neferafk
38+make pkg # builds an Arch package of HEAD into dist/
39+make install # builds that package and installs it with pacman
33 ```40 ```
34 41
42+The packages install `/etc/pam.d/neferafk` for password mode.
43+
35 ## Usage44 ## Usage
36 45
37 ```46 ```

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 2

Tags 9

↑↓ moveenter openesc close