/mist

The official command-line interface for the makedeb Package Repository

Primary LanguageRustGNU General Public License v3.0GPL-3.0

Mist

Latest deployment status MPR - mist MPR - mist-bin

This is the repository for Mist, the official command-line interface for the makedeb Package Repository.

Mist makes it easier for users to interact with the MPR in a variety of ways. Some of its most notable features include:

  • Functioning as a wrapper around APT, adding in MPR functionality such as:
    • The ability to install, upgrade, and remove both APT and MPR packages.
    • Automatic dependency resolution for packages from the MPR, as well as APT.
    • Searching and listing both APT and MPR packages.
  • Cloning packages from the MPR.
  • Listing comments for packages from the MPR.
  • Commenting packages from the MPR.

Installation

Users have a few options for installing Mist:

From the Prebuilt-MPR (Recommended)

This is the recommended way to install Mist. It avoids the need to compile any software, allows for automatic upgrades via APT (and Mist once it's installed), and gets you set up in just a couple of minutes.

First, set up the Prebuilt-MPR on your system, then just run the following to install Mist:

sudo apt install mist

You'll also need to have makedeb installed if it is not already.

From the MPR

You can also install Mist directly from the MPR if you'd prefer that.

From Source

To install from source, install mist from the MPR:

git clone 'https://mpr.makedeb.org/mist'
cd mist/
makedeb -si -H 'MPR-Package: yes'

If you omit -H 'MPR-Package: yes', Mist will be unable to update itself.

Mist currently requires the nightly version of the Rust compiler toolchain in order to build. To build it locally, it's recommended to use rustup, which will automatically manage and update the nightly toolchain on your local system. If preferred, rustup can be installed from the MPR or the Prebuilt-MPR.

From a Binary

To install Mist from a prebuilt binary, install the mist-bin package:

git clone 'https://mpr.makedeb.org/mist-bin'
cd mist/
makedeb -si

Contributing

If there's something you want added/fixed in Mist, feel free to open a pull request. There aren't many guidelines on what you should do quite yet, so just submit your changes and we can figure out what to do from there!