rustpm 0.2.2

A fast, friendly APT frontend with kernel, desktop, and sources management
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

# rustpm

A fast, friendly APT frontend written in Rust — similar to [nala](https://gitlab.com/volian/nala) but with first-class kernel management.

## Features

- **Package management**: install, remove, upgrade, search, show, list — with a full interactive TUI
- **Kernel management**: install/remove/pin Debian kernels + linux-headers atomically; GRUB updated automatically
- **Vanilla kernels**: download and install mainline kernels from [kernel.org](https://www.kernel.org/) via Ubuntu mainline builds
- **Desktop environments**: install/remove KDE, GNOME, XFCE, MATE, LXQt, Cinnamon with one command
- **APT sources**: view, add, remove, enable/disable APT sources from a TUI panel
- **Transaction history**: view past operations; undo installs/removals
- **Self-update checker**: notifies you when a new version is available
- **Interactive TUI by default**: running `rustpm` with no arguments opens a full-screen terminal UI

## Install

rustpm requires root for APT operations and automatically re-executes itself under `sudo` if not already root. Install it to a system-wide PATH location so this works correctly.

```bash
# From crates.io — installs to /usr/local/bin
sudo cargo install --root /usr/local rustpm

# Or build from source
git clone https://gitlab.com/dfred26/rustpm
cd rustpm
sudo make install   # builds and installs to /usr/local/bin/rustpm
```

## Usage

```
rustpm                          # open interactive TUI
rustpm update                   # refresh package lists
rustpm upgrade                  # upgrade packages (shows diff first)
rustpm install <pkg>...         # install packages
rustpm remove <pkg>...          # remove packages
rustpm search <term>            # search packages
rustpm show <pkg>               # show package details
rustpm list [--installed]       # list packages

rustpm kernel list              # show installed/available Debian kernels
rustpm kernel install <ver>     # install kernel + headers
rustpm kernel remove <ver>      # remove kernel (refuses running kernel)
rustpm kernel update            # upgrade to latest Debian kernel
rustpm kernel pin <ver>         # pin kernel version
rustpm kernel vanilla list      # list mainline kernel releases
rustpm kernel vanilla install <ver>  # download & install vanilla kernel

rustpm desktop list             # show available desktop environments
rustpm desktop install kde      # install KDE Plasma
rustpm desktop switch gnome     # install GNOME and set as default DM

rustpm sources list             # list APT sources
rustpm sources add <uri> <suite> <components...>
rustpm sources disable <uri>    # comment out a source

rustpm history                  # view transaction history
rustpm history undo <id>        # undo a transaction
```

## Environment variables

| Variable | Effect |
|---|---|
| `RUSTPM_NO_TUI=true` | Disable TUI, use plain text output |
| `RUSTPM_NO_UPDATE_CHECK=true` | Skip self-update check |

## License

GPL-3.0-or-later