AstraMarket

AstraMarket is a unified package manager providing both a graphical interface and a command-line interface for managing Flatpak, Pacman, AUR, AppImage, and custom package sources.

Requirements

• Qt 6 (Core, Gui, Quick, QuickControls2, ShaderTools, Concurrent, Network, DBus, Svg)
• CMake (>= 3.19)
• C++20 compiler
• Supported package managers: Flatpak, Pacman, paru/yay (optional for AUR)

Installation

Arch Linux / AUR

AstraMarket is available on the AUR:

# Release (builds from source)
paru -S astramarket
# or yay -S astramarket

# Precompiled binary (fast install)
paru -S astramarket-bin
# or yay -S astramarket-bin

# Latest git development
paru -S astramarket-git
# or yay -S astramarket-git

Manual Installation (From Source)

Build and install AstraMarket system-wide:

mkdir -p build
cmake -B build -S . -DCMAKE_BUILD_TYPE=Release
cmake --build build
sudo cmake --install build

This installs the astra binary to /usr/bin, the desktop launcher to /usr/share/applications/astra.desktop, and the application icon to /usr/share/icons/hicolor/scalable/apps/AstraMarket.svg.

Running the GUI

Launch the graphical marketplace interface:

./build/astra --gui

or:

./build/astra -g

Using the CLI

Search across enabled package sources:

astra search <query>
astra search <query> --source <Flatpak|Pacman|AUR|AppImage>

Install a package:

astra install <package-id>
astra install <package-id> --source <source>
astra install <package-id> --source Flatpak --scope <user|system>

Uninstall a package:

astra remove <package-id>
astra remove <package-id> --source <source>

List installed packages:

astra list

Check for updates:

astra update

View package details:

astra info <package-id>
astra info <package-id> --source <source>

List active package sources and plugins:

astra sources

Show help and all available commands:

astra --help

Plugins

For creating and installing custom package sources or scrapers, see PLUGINS.

Acknowledgements

• UI design language, tokens, and components adapted from Caelestia Shell.
• Material Design icons and shape specifications by Google.

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.