UmbrelCore

A modern GUI frontend for the Arch Linux package manager (pacman) built with Rust and Iced.

Features

• 🔍 Package Search - Search for packages across official repositories and AUR
• 📦 Package Management - Install, remove, and manage packages with a clean interface
• 🔄 System Updates - Check for and install system and AUR updates
• 🎨 Flatpak Support - Manage Flatpak applications
• 🗄️ Repository Management - View and manage pacman repositories
• 🖥️ Kernel Management - Install and manage Linux kernels with automatic NVIDIA driver support
• 🛠️ Maintenance Tools - Cache cleanup, orphan removal, database maintenance, and more
• 🌓 Theme Support - Light and dark mode with instant switching

Installation

From Source

1. Clone the repository:

git clone https://github.com/ryzendew/UmbrelCore.git
cd UmbrelCore

2. Build the project:

cargo build --release

3. Run the application:

cargo run --release

Or run the binary directly:

./target/release/umbrelcore

System Installation (Optional)

To install system-wide:

cargo build --release
sudo cp target/release/umbrelcore /usr/local/bin/
sudo cp resources/desktop/umbrelcore.desktop /usr/local/share/applications/

Usage

Package Management

1. Search Tab: Search for packages by name, filter by repository or status
2. Installed Tab: View and manage installed packages
3. System Update Tab: Check for and install system and AUR updates
4. Flatpak Tab: Search, install, and manage Flatpak applications
5. Repository Tab: View and manage pacman repositories
6. Kernel Tab: Install and manage Linux kernels
7. Maintenance Tab: Perform system maintenance tasks

Keyboard Shortcuts

• Ctrl+Q - Quit application
• Theme toggle button - Switch between light and dark mode

Architecture

• Core (src/core/): Package management logic using pacman commands
• GUI (src/gui/): Iced-based user interface
• UI Components (src/ui/): Reusable UI components and theming
• Async Operations: Tokio-based async operations for non-blocking UI

Development

Building

cargo build

Running in Debug Mode

cargo run

Project Structure

.
├── src/
│   ├── core/          # Core package management logic
│   ├── gui/           # GUI components and windows
│   ├── ui/            # UI components and theming
│   └── main.rs        # Application entry point
├── Cargo.toml         # Rust dependencies
├── resources/         # Icons and desktop files
└── README.md          # This file

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details

Acknowledgments

• Built with Iced GUI framework
• Uses Material Symbols for icons
• Inspired by modern package manager GUIs