117 lines
4.0 KiB
Markdown
117 lines
4.0 KiB
Markdown
### Changed name from vpm to vbm so it can coexist with original, already in void repos...
|
|
# vbm - An XBPS package management helper for vb-linux and VoidLinux
|
|
version 1.4.1
|
|
|
|
`vbm` 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 vbm shouldn't be confused with
|
|
XBPS - vbm is just an addon helper tool for XBPS to make your life easier.
|
|
That's it.
|
|
|
|
# Screenshots
|
|
|
|
vbm...
|
|
|
|
![vbm](https://codeberg.org/oSoWoSo/vbm/raw/branch/main/screenshots/vbm.png)
|
|
|
|
vbm trying install package but...
|
|
|
|
![try](https://codeberg.org/oSoWoSo/vbm/raw/branch/main/screenshots/vbm2.png)
|
|
|
|
vbm automatic updating xbps while updating system...
|
|
|
|
![xbps](https://codeberg.org/oSoWoSo/vbm/raw/branch/main/screenshots/vbm3.png)
|
|
|
|
vbm installing package...
|
|
|
|
![xbps](https://codeberg.org/oSoWoSo/vbm/raw/branch/main/screenshots/vbm4.png)
|
|
|
|
# Motivation to write vbm
|
|
|
|
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 vbm
|
|
--show-translations so you even see the translations already when using vbm
|
|
help. It has been said that vbm will ease the transition from Debian's APT, and
|
|
some other user-friendly repository/package-managers.
|
|
|
|
# Dependencies
|
|
|
|
vbm requires BASH, the Bourne Again SHell, which should be installed by default
|
|
on a new VoidLinux system. You also will need git and xcheckrestart both provided
|
|
by xtools package to obtain a clone of the vbm GitHub repository.
|
|
(see "Installation" section, below).
|
|
|
|
Or you can just grab vbm and paste it anywhere in your system.
|
|
|
|
# Installation
|
|
|
|
### 1. Install xtools via `xbps-install`
|
|
### for xcheckrestart functions etc...
|
|
|
|
$ xbps-install -S xtools
|
|
|
|
### 2. Clone vbm repository
|
|
|
|
$ git clone https://codeberg.org/oSoWoSo/vbm.git
|
|
|
|
### 3. Enter the cloned repo and install vbm
|
|
|
|
$ cd vbm
|
|
$ chmod +x vbm
|
|
$ make install
|
|
|
|
### 3a. Remove vbm
|
|
|
|
If you want to remove vbm, 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 vbm 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 --, vbm just tries to do its best it can to understand the
|
|
user (there are some command-line-switches, though, see vbm help).
|
|
|
|
Also vbm will ask for password if needed.
|
|
|
|
# License
|
|
|
|
vbm 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/>.
|
|
```
|
|
|
|
# Authors
|
|
|
|
- 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/vbm - and this fork by zenobit <zen@osowoso.xyz>
|
|
|
|
# Mirrors
|
|
|
|
- repos mirrored at:
|
|
- 'https://github.com/oSoWoSo/vpm'
|
|
- 'https://gitlab.com/linux15/void/vpm'
|
|
- 'https://git.disroot.org/oSoWoSo/vpm'
|
|
- more mirrors will come...
|