xdeb-install

xdeb-install

Simple tool to automatically download, convert, and install DEB packages on Void Linux via the awesome xdeb tool. Basically just a wrapper to automate the process.

Installation

There are three ways you can install the tool:

• using XBPS
• using Go
• manually downloading a release binary

You can install xdeb using xdeb-install later, see Help Page.

XBPS

Before you continue reading this section, read up on https://docs.voidlinux.org/xbps/repositories/custom.html. You have been warned.

Since my PR over at void-linux/void-packages didn't make it, you can't install the tool using any official XBPS repositories.

To work around that problem, I created my own unofficial XBPS repository at https://thetredev.github.io/voidlinux-repository. See https://github.com/thetredev/voidlinux-repository for instructions on how to install it to your system.

Afterwards, you can execute xbps-install xdeb-install to install the tool.

Notes:

• All binary architectures for release 1.0.1 are available: x86_64, i686, aarch64

Using Go

If you have Go installed, simply execute:

go install github.com/thetredev/xdeb-install

As long as the GOPATH is within your PATH, that's it.

Manually

Head over to the releases page and download a release binary. Then move it to some place within your PATH, like /usr/local/bin.

Help Page

$ xdeb-install -h
NAME:
   xdeb-install - Automation wrapper for the xdeb utility

USAGE:
   xdeb-install [global options] command [command options] [arguments...]

DESCRIPTION:
   Simple tool to automatically download, convert, and install DEB packages via the awesome xdeb tool.
   Basically just a wrapper to automate the process.

COMMANDS:
   xdeb           installs the xdeb utility to the system along with its dependencies
   repository, r  install a package from an remote repository
   search, s      search remote repositories for a package
   sync           sync remote repositories
   url, u         install a package from a URL directly
   file, f        install a package from a local DEB file
   clean, c       cleanup temporary xdeb context root path, optionally the repository lists as well
   help, h        Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --options value, -o value  override XDEB_OPTS, '-i' will be removed if provided (default: "-Sde")
   --temp value, -t value     temporary xdeb context root path (default: "/tmp/xdeb")
   --help, -h                 show help

Sync package repositories

To sync package repositories, type:

$ xdeb-install sync
Syncing lists: https://raw.githubusercontent.com/thetredev/xdeb-install-repositories/v1.0.0/repositories/x86_64/lists.yaml
[xdeb-install] Syncing repository debian.org/contrib @ bookworm
[xdeb-install] Syncing repository debian.org/main @ bookworm
[xdeb-install] Syncing repository debian.org/non-free @ bookworm
[xdeb-install] Syncing repository debian.org/non-free-firmware @ bookworm
...
[xdeb-install] Syncing repository microsoft.com/vscode.yaml @ current
[xdeb-install] Syncing repository google.com/google-chrome.yaml @ current
[xdeb-install] Finished syncing: ~/.config/xdeb-install/repositories/x86_64

You can also filter the providers to sync, like so:

$ xdeb-install sync ubuntu.com
[xdeb-install] Syncing lists: https://raw.githubusercontent.com/thetredev/xdeb-install-repositories/v1.0.0/repositories/x86_64/lists.yaml
[xdeb-install] Syncing repository ubuntu.com/restricted @ bionic
[xdeb-install] Syncing repository ubuntu.com/restricted @ focal
[xdeb-install] Syncing repository ubuntu.com/multiverse @ focal
[xdeb-install] Syncing repository ubuntu.com/multiverse @ bionic
[xdeb-install] Syncing repository ubuntu.com/restricted @ jammy
[xdeb-install] Syncing repository ubuntu.com/multiverse @ jammy
[xdeb-install] Syncing repository ubuntu.com/main @ focal
[xdeb-install] Syncing repository ubuntu.com/main @ bionic
[xdeb-install] Syncing repository ubuntu.com/main @ jammy
[xdeb-install] Syncing repository ubuntu.com/universe @ bionic
[xdeb-install] Syncing repository ubuntu.com/universe @ focal
[xdeb-install] Syncing repository ubuntu.com/universe @ jammy
[xdeb-install] Finished syncing: ~/.config/xdeb-install/repositories/x86_64

The package repository lists are stored at $XDG_CONFIG_HOME/xdeb-install/repositories/<arch>, where $XDG_CONFIG_HOME typically translates to $HOME/.config.

Supported repositories

See https://github.com/thetredev/xdeb-install-repositories for details.

Install DEB packages from remote repositories

To install speedcrunch, for example, type:

$ xdeb-install repository speedcrunch

This will install the most recent version of the package from the first provider and distribution it can find.

You can also specify the provider and distribution, for example debian.org and bookworm, respectively:

$ xdeb-install repository --provider debian.org --distribution bookworm speedcrunch

Install DEB packages directly from a URL

Let's stay with the speedcrunch example:

$ xdeb-install url http://ftp.debian.org/debian/pool/main/s/speedcrunch/speedcrunch_0.12.0-6_amd64.deb

Install DEB packages from a local DEB file

First, obviously download a DEB file from a remote location. Let's stay it's stored at $HOME/Downloads/speedcrunch.deb:

$ xdeb-install file $HOME/Downloads/speedcrunch.deb

Search for a DEB package

You can search for a specific package by its name, let's stay with speedcrunch:

$ xdeb-install search speedcrunch
[xdeb-install] Looking for package speedcrunch via provider * and distribution * ...
debian.org/main
  distribution: bookworm
  version: 0.12.0-6
  url: http://ftp.debian.org/debian/pool/main/s/speedcrunch/speedcrunch_0.12.0-6_amd64.deb
  sha256: a306a478bdf923ad1206a1a76fdc1b2d6a745939663419b360febfa6350e96b6

debian.org/main
  distribution: sid
  version: 0.12.0-6
  url: http://ftp.debian.org/debian/pool/main/s/speedcrunch/speedcrunch_0.12.0-6_amd64.deb
  sha256: a306a478bdf923ad1206a1a76fdc1b2d6a745939663419b360febfa6350e96b6

debian.org/main
  distribution: testing
  version: 0.12.0-6
  url: http://ftp.debian.org/debian/pool/main/s/speedcrunch/speedcrunch_0.12.0-6_amd64.deb
  sha256: a306a478bdf923ad1206a1a76fdc1b2d6a745939663419b360febfa6350e96b6

debian.org/main
  distribution: bullseye
  version: 0.12.0-5
  url: http://ftp.debian.org/debian/pool/main/s/speedcrunch/speedcrunch_0.12.0-5_amd64.deb
  sha256: 0c108597debfbc47e6eb384cfff5539627d0f0652202a63f82aa3c3e8f56aa5c

debian.org/main
  distribution: buster
  version: 0.12.0-4
  url: http://ftp.debian.org/debian/pool/main/s/speedcrunch/speedcrunch_0.12.0-4_amd64.deb
  sha256: 8681da5ca651a6a7f5abb479c673d33ce3525212e34a2a33afcec7ad75c28aea

Filtering search results is also supported via --provider <provider> [--distribution <distribution>]:

$ xdeb-install search --provider ubuntu.com --distribution bionic speedcrunch
[xdeb-install] Looking for package speedcrunch via provider ubuntu.com and distribution bionic ...
ubuntu.com/universe
  distribution: bionic
  version: 0.12.0-3
  url: http://archive.ubuntu.com/ubuntu/pool/universe/s/speedcrunch/speedcrunch_0.12.0-3_amd64.deb
  sha256: 0206f112ac503393c984088817488aa21589c1c5f16f67df8d8836612f27f810