NX AppHub CLI |

Introduction

NX AppHub CLI is a lightweight command-line tool for managing and building applications in Nitrux.

Warning

NX AppHub CLI primarily targets Nitrux OS, and using this utility in other distributions may or may not work. Compatibility with other distributions is incidental, not intentional.

For more in-depth information about NX AppHub CLI, please see the Wiki.

Requirements

• Nitrux 5.0.0 and newer.

Note

To use nx-apphub-cli in previous versions of Nitrux use a container; see our tutorial on how to use Distrobox.

• Python 3.10 and newer.

Runtime Requirements

appstream
binutils
bubblewrap
file
firejail
fuse3
git
kf6-breeze-icon-theme || luv-icon-theme
libfuse2t64 || libfuse2 
patchelf
zstd

Installation

To install NX AppHub CLI we recommend using pipx.

Single-user

pipx install git+https://github.com/Nitrux/nx-apphub.git

Warning

pipx will install nx-apphub-cli to $HOME/.local/bin, run pipx ensurepath to add this directory to $PATH.

System-wide

sudo pipx install --global git+https://github.com/Nitrux/nx-apphub.git

Uninstallation

To uninstall NX AppHub CLI, do the following.

Single-user

pipx uninstall nx-apphub-cli

System-wide

sudo pipx uninstall --global nx-apphub-cli

Usage

To use NX AppHub CLI check the commands below.

• install→ Install one or more applications.
• remove → Remove one or more installed applications.
• update → Update one or more installed applications.
• downgrade → Downgrade one or more installed applications.
• search → Search for specific applications.
• show → Show installed applications.
• build → Build an AppImage from a local YAML file.
  • --appdir-lint → Optionally debug missing shared libraries in an AppImage.
• generate → Generate YAML template from package metadata.
  • --package → Specify package name.
  • --distro → Choose the distribution from which to get metadata.
  • --release → The release of the selected distribution.
  • --arch → Specify the target architecture.
  • --output → The file name of the generated YAML file.
  • --description-output → The file name of the generated metadata file.

Examples

nx-apphub-cli install inkscape

nx-apphub-cli remove fiery

nx-apphub-cli update nano

nx-apphub-cli downgrade mc

nx-apphub-cli search nano mc fiery

nx-apphub-cli show

nx-apphub-cli build app.yml 
  ↪ (debug) nx-apphub-cli build app.yml --appdir-lint squashfs-root/

nx-apphub-cli generate \
  --package mc \
  --distro debian \
  --release testing \
  --arch amd64 \
  --components main \
  --output mc.yml \
  --description-output app_description.md

Licensing

The license for this repository and its contents is BSD-3-Clause.

Issues

If you find problems with the contents of this repository, please create an issue and use the 🐞 Bug report template.

Submitting a bug report

Before submitting a bug, you should look at the existing bug reports to verify that no one has reported the bug already.

©2025 Nitrux Latinoamericana S.C.