Ustaller

Inspect and uninstall Linux apps from one place

A modern, native GNOME application for browsing installed applications and removing them cleanly — all from one place.

Features • Installation • Usage • Contributing • License

---

✨ Features

Unified Package Management

• 📦 Browse apps from Flatpak, Snap, and Debian/apt packages
• 🗑️ Uninstall packages with a single click
• 🧹 Automatically clean up configuration traces and leftover files
• 🔍 Search and filter installed applications
• 🎨 Native GNOME 45+ interface with libadwaita

Designed for Modern Linux

• Built with GTK 4 and libadwaita
• Follows GNOME Human Interface Guidelines
• Dark mode support
• Keyboard shortcuts
• Responsive layout

📸 Screenshots

Main Interface

App Details

Search & Filter

Preferences

Theme Support

🚀 Installation

Quick Install

Debian/Ubuntu (.deb)

# Download the latest release
wget https://github.com/ChloeVPin/ustaller/releases/latest/download/ustaller_0.1.0-1_all.deb

# Install
sudo dpkg -i ustaller_0.1.0-1_all.deb
sudo apt-get install -f  # Install dependencies if needed

Fedora/RHEL/openSUSE (.rpm)

# Download the latest release
wget https://github.com/ChloeVPin/ustaller/releases/latest/download/ustaller-0.1.0-1.noarch.rpm

# Install (Fedora)
sudo dnf install ustaller-0.1.0-1.noarch.rpm

# Or (RHEL/CentOS)
sudo rpm -i ustaller-0.1.0-1.noarch.rpm

AppImage (Universal)

# Download the latest release
wget https://github.com/ChloeVPin/ustaller/releases/latest/download/ustaller-0.1.0-x86_64.AppImage

# Make executable and run
chmod +x ustaller-0.1.0-x86_64.AppImage
./ustaller-0.1.0-x86_64.AppImage

Flatpak

# Build from source
./build/build-all.sh flatpak

# Install
flatpak install --user ustaller-0.1.0.flatpak

Snap

# Build from source
./build/build-all.sh snap

# Install
sudo snap install --dangerous ustaller_0.1.0_amd64.snap

Arch Linux (AUR)

# Using yay
yay -S ustaller

# Or build manually
cd arch
makepkg -si

Build from Source

Prerequisites

• gjs >= 1.70
• GTK 4 and development files
• libadwaita and development files
• GLib 2 development files
• polkit (for elevated operations)

Install Dependencies

Debian/Ubuntu:

sudo apt-get install gjs gir1.2-gtk-4.0 gir1.2-adw-1 gir1.2-glib-2.0 pkexec

Fedora:

sudo dnf install gjs gtk4 libadwaita glib2 polkit

Arch Linux:

sudo pacman -S gjs gtk4 libadwaita glib2 polkit

Build and Run

# Clone the repository
git clone https://github.com/ChloeVPin/ustaller.git
cd ustaller

# Run directly (development mode)
npm start

# Or build packages
./build/build-all.sh all

📖 Usage

Basic Usage

1. Launch Ustaller from your application menu or run ustaller in terminal
2. Browse installed apps in the sidebar
3. Search for specific apps using the search bar
4. Select an app to view details
5. Click Uninstall to remove the app and clean up traces

Keyboard Shortcuts

Shortcut	Action
Ctrl+Q	Quit
Ctrl+F	Focus search
Ctrl+,	Open preferences

Preferences

Access preferences from the menu button (☰) to:

• Switch between light/dark theme
• Filter package sources (Flatpak, Snap, Debian)
• Hide system applications

🏗️ Building Packages

Ustaller supports building packages for all major Linux distributions:

# Build all formats
./build/build-all.sh all

# Build specific format
./build/build-all.sh deb
./build/build-all.sh rpm
./build/build-all.sh appimage
./build/build-all.sh flatpak
./build/build-all.sh snap
./build/build-all.sh arch

Available Build Formats

Format	Command	Output
Debian	./build/build-all.sh deb	ustaller_*.deb
RPM	./build/build-all.sh rpm	ustaller-*.rpm
AppImage	./build/build-all.sh appimage	ustaller-*.AppImage
Flatpak	./build/build-all.sh flatpak	ustaller-*.flatpak
Snap	./build/build-all.sh snap	ustaller_*.snap
Arch	./build/build-all.sh arch	ustaller-*.pkg.tar.zst

🤝 Contributing

Contributions are welcome! Whether you're fixing bugs, improving documentation, or adding new features, your help is appreciated.

Please read our Contributing Guidelines before submitting.

Quick Start for Contributors

# Fork and clone
git clone https://github.com/YOUR_USERNAME/ustaller.git
cd ustaller

# Install dependencies
npm install

# Run in development mode
npm start

# Create a feature branch
git checkout -b feature/your-feature-name

# Make changes and test
# ...

# Submit a pull request

📜 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

🙏 Acknowledgments

• Built with GTK 4 and libadwaita
• Uses GJS for JavaScript bindings
• Icons follow the GNOME Icon Guidelines
• Inspired by the need for better package management on Linux

📬 Contact & Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Security: See SECURITY.md for vulnerability reporting

🌟 Star History

If you find Ustaller useful, consider giving it a star on GitHub! ⭐

---

Made with ❤️ for the Linux community

Report Bug · Request Feature