vbm/README.md

### Changed name from vpm to vbm

# vbm - An XBPS package management helper for vb aka Void GNU/Linux
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.

# better then screenshots

vbm...

[![asciicast](https://asciinema.org/a/476068.svg)](https://asciinema.org/a/476068)

# 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

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 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` 
### (optional - needed for xcheckrestart functions)

    $ 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/vbm'
- 'https://gitlab.com/linux15/void/vbm'
- 'https://git.disroot.org/oSoWoSo/vbm'
- more mirrors will come...