2021-09-03 06:51:22 +02:00
|
|
|
# vpm - An XBPS package management helper for VoidLinux
|
2021-10-06 09:17:29 +02:00
|
|
|
version 1.3.1
|
2021-09-03 06:50:33 +02:00
|
|
|
|
2021-09-03 06:51:22 +02:00
|
|
|
`vpm` is a simple to use, daily-driver enhancement to the awesome XBPS (X Binary
|
|
|
|
Package System), initially designed as a helper tool for use with VoidLinux.
|
|
|
|
Feel free to think "Void Package Management" or something if it helps you
|
|
|
|
remember its name, but please note that it's NOT a "package manager" in the
|
|
|
|
nitpickers understanding of the word - especially vpm shouldn't be confused with
|
|
|
|
XBPS - vpm is just an addon helper tool for XBPS to make your life easier.
|
|
|
|
That's it.
|
|
|
|
|
|
|
|
# Screenshots
|
|
|
|
|
|
|
|
vpm...
|
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
![vpm](https://codeberg.org/oSoWoSo/vpm/raw/branch/main/screenshots/vpm1.png)
|
2021-09-03 06:51:22 +02:00
|
|
|
|
|
|
|
vpm trying install package but...
|
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
![try](https://codeberg.org/oSoWoSo/vpm/raw/branch/main/screenshots/vpm2.png)
|
2021-09-03 06:51:22 +02:00
|
|
|
|
|
|
|
vpm automatic updating xbps while updating system...
|
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
![xbps](https://codeberg.org/oSoWoSo/vpm/raw/branch/main/screenshots/vpm3.png)
|
2021-09-03 06:51:22 +02:00
|
|
|
|
|
|
|
vpm installing package...
|
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
![xbps](https://codeberg.org/oSoWoSo/vpm/raw/branch/main/screenshots/vpm4.png)
|
2021-09-03 06:51:22 +02:00
|
|
|
|
|
|
|
# Motivation to write vpm
|
|
|
|
|
|
|
|
I initially found XBPS to have a steep learning-curve, so I wanted to ease the
|
|
|
|
life of new VoidLinux users, and XBPS users in general. Please don't feel afraid
|
|
|
|
to look up the corresponding XBPS commands it translates to, or use vpm
|
|
|
|
--show-translations so you even see the translations already when using vpm
|
|
|
|
help. It has been said that vpm will ease the transition from Debian's APT, and
|
|
|
|
some other user-friendly repository/package-managers.
|
|
|
|
|
|
|
|
# Dependencies
|
|
|
|
|
|
|
|
vpm requires BASH, the Bourne Again SHell, which should be installed by default
|
2021-10-06 09:17:29 +02:00
|
|
|
on a new VoidLinux system. You also will need git and xcheckrestart both provided
|
|
|
|
by xtools package to obtain a clone of the vpm GitHub repository.
|
|
|
|
(see "Installation" section, below).
|
|
|
|
|
|
|
|
Or you can just grab vpm and paste it anywhere in your system.
|
2021-09-03 06:51:22 +02:00
|
|
|
|
|
|
|
# Installation
|
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
### 1. Install xtools via `xbps-install`
|
2021-09-03 06:51:22 +02:00
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
$ xbps-install -S xtools
|
2021-09-03 06:51:22 +02:00
|
|
|
|
|
|
|
### 2. Clone vpm repository
|
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
$ git clone https://codeberg.org/oSoWoSo/vpm.git
|
2021-09-03 06:51:22 +02:00
|
|
|
|
|
|
|
### 3. Enter the cloned repo and install vpm
|
|
|
|
|
|
|
|
$ cd vpm
|
|
|
|
$ make install
|
|
|
|
|
|
|
|
### 3a. Remove vpm
|
|
|
|
|
|
|
|
If you want to remove vpm, just use make to remove it. Make sure you are in the cloned directory first, then run:
|
|
|
|
|
|
|
|
$ make uninstall
|
|
|
|
|
|
|
|
# ZOMG! PONIES!!111
|
|
|
|
|
|
|
|
Rainbows and unicorns, indeed. If you like colorized output, please see the
|
|
|
|
--color=true option, too! All vpm options try to have human readable and easy to
|
|
|
|
remember syntax, no --long-option-with-multiple-complex-words, no need to even
|
|
|
|
prefix arguments with --, vpm just tries to do its best it can to understand the
|
|
|
|
user (there are some command-line-switches, though, see vpm help).
|
|
|
|
|
|
|
|
Also vpm will ask for password if needed.
|
|
|
|
|
|
|
|
# License
|
|
|
|
|
|
|
|
vpm is released under the terms of the GNU General Public License,
|
|
|
|
Version 3. See the LICENSE file for further information.
|
|
|
|
|
|
|
|
```
|
|
|
|
Copyright (c) 2016: Armin Jenewein <vpm@m2m.pm>
|
|
|
|
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
GNU General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
```
|
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
# Authors
|
2021-09-03 06:51:22 +02:00
|
|
|
|
2021-10-06 09:17:29 +02:00
|
|
|
- https://github.com/netzverweigerer/vpm - vpm was written by Armin Jenewein <vpm@m2m.pm>
|
|
|
|
- https://github.com/bahamas10/vpm - forked by Dave Eddy <dave@daveeddy.com>
|
|
|
|
- https://codeberg.org/oSoWoSo/vpm - and this fork by zenobit <osowoso@protonmail.com>
|
2021-10-08 15:05:35 +02:00
|
|
|
|
|
|
|
repos mirrored at: github.com, gitlab.com and disroot.org more mirrors will come...
|