https://github.com/kdesp73/xbps
A simple, user-friendly wrapper around Void Linux’s xbps package manager.
https://github.com/kdesp73/xbps
bash void-linux xbps
Last synced: 6 months ago
JSON representation
A simple, user-friendly wrapper around Void Linux’s xbps package manager.
- Host: GitHub
- URL: https://github.com/kdesp73/xbps
- Owner: KDesp73
- License: mit
- Created: 2025-06-24T21:03:12.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-07-01T21:16:14.000Z (6 months ago)
- Last Synced: 2025-07-01T22:25:01.177Z (6 months ago)
- Topics: bash, void-linux, xbps
- Language: Shell
- Homepage:
- Size: 4.88 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# xbps
> A simple, user-friendly wrapper around Void Linux’s `xbps` package manager.
**xbps** makes installing, removing, searching, and managing packages on Void Linux faster and more intuitive, using concise syntax and optional dry-run support.
## Features
- Short aliases for common tasks (`+` for install, `-` for remove, `/` for search)
- Install/remove multiple packages at once
- Search and view detailed package info
- System upgrade support
- Dry-run mode to preview commands
- Auto-logs all installs/removals to `~/.xbps_wrapper.log`
- Colorized terminal output for better UX
## Usage
```bash
xbps [COMMAND] [PKGS...] [--dry-run]
```
| Command | Alias | Description |
|--------------|-------|---------------------------------------|
| `install` | `+` | Install one or more packages |
| `remove` | `-` | Remove one or more packages |
| `search` | `/` | Search for packages by name |
| `info` | `i` | Show detailed info for a package |
| `upgrade` | `u` | Upgrade all installed packages |
| `list` | `ls` | List all installed packages (paged) |
| `version` | | Show current version |
| `help` | | Display usage guide |
### Optional Flags
| Flag | Description |
|-------------|-----------------------------------------------|
| `--dry-run` | Preview the commands without running them |
## Examples
```bash
xbps + vim git curl # Install multiple packages
xbps - nano # Remove nano
xbps / terminal # Search for packages with "terminal" in name
xbps i ffmpeg # View info for ffmpeg
xbps u # System upgrade
xbps ls # List installed packages
xbps + htop --dry-run # Simulate install (no action taken)
```
## Log File
All install, remove, and upgrade actions are logged to:
```
~/.xbps_wrapper.log
```
## Installation
Just clone and place the script somewhere in your `PATH`:
```bash
git clone https://github.com/KDesp73/xbps
cd xbps
chmod +x xbps
sudo mv xbps /usr/local/bin/
```
## License
MIT License.
See [`LICENSE`](./LICENSE) for details.