blob: 9ca02aff53fb9df7ccee72ee4710808c22c0f0e1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
# pacfzf
An fzf-based interactive package manager for Arch Linux.
## Commands
| Command | Description |
|---|---|
| `pacfzf install` | Browse and install packages from official repositories |
| `pacfzf remove` | Browse and remove installed packages from official repositories |
| `pacfzf aur-install` | Browse and install packages from the AUR |
| `pacfzf aur-remove` | Browse and remove installed AUR/foreign packages |
| `pacfzf info` | Browse installed packages and inspect details/files |
| `pacfzf history` | Browse the pacman transaction log (most recent first) |
## Usage
```
pacfzf <command>
Commands:
install Browse and install packages from official repositories
remove Browse and remove installed packages from official repositories
aur-install Browse and install packages from the AUR
aur-remove Browse and remove installed AUR/foreign packages
info Browse installed packages and view package details
history Browse the pacman transaction log (most recent first)
Options:
-h, --help Show help
-V, --version Show version
```
### Key bindings (all commands)
| Key | Action |
|---|---|
| `TAB` | Multi-select a package |
| `ENTER` | Confirm selection and proceed |
| `ESC` | Cancel |
| `ALT-P` | Toggle preview pane |
| `ALT-B` | Toggle PKGBUILD view (`aur-install`, `aur-remove` only) |
| `ALT-F` | Toggle installed files view (`info` only) |
| `ALT-D / ALT-U` | Scroll preview down/up (half page) |
| `ALT-J / ALT-K` | Scroll preview line by line |
## Configuration
pacfzf reads `~/.config/pacfzf/config` on startup (respects `$XDG_CONFIG_HOME`).
| Variable | Default | Description |
|---|---|---|
| `AUR_QUERY_HELPER` | `yay` | AUR helper for package listing and previews |
| `AUR_INSTALL_HELPER` | `paru` | AUR helper for installing and removing packages |
Example `~/.config/pacfzf/config`:
```sh
AUR_QUERY_HELPER=paru
AUR_INSTALL_HELPER=paru
```
Any helper compatible with standard yay/paru flags works (e.g. `yay`, `paru`, `trizen`).
## Dependencies
- `fzf`
- `pacman`
- `yay` — default `AUR_QUERY_HELPER` (listing and previews)
- `paru` — default `AUR_INSTALL_HELPER` (AUR installs and removes)
Both yay and paru can be swapped out via the [config file](#configuration).
## Installation
### From AUR
```
paru -S pacfzf
```
### Manually
Requires [scdoc](https://sr.ht/~sircmpwn/scdoc/) to compile the man page:
```
scdoc < pacfzf.1.scd > pacfzf.1
sudo install -Dm755 pacfzf /usr/bin/pacfzf
sudo install -Dm644 pacfzf.1 /usr/share/man/man1/pacfzf.1
```
|