Skip to content

Home

Jump to bottom
Firstp1ck edited this page Apr 17, 2026 · 13 revisions

Fast TUI for searching, inspecting, and queueing pacman/AUR packages on Arch Linux—keyboard-first, written in Rust.

Features

  • Security Scan for AUR Packages: Comprehensive security scanning workflow with multiple tools (ClamAV, Trivy, Semgrep, ShellCheck, VirusTotal, custom patterns, aur-sleuth) and detailed scan summaries
  • Extended News Mode: Comprehensive news feed with multiple sources (Arch news, security advisories, package updates with change detection, AUR comments), smart caching for offline access, background processing with automatic retries, streaming updates, AUR balance, filters (Arch/advisory/updates/comments/installed-only, age), search with history, bookmarks, read/unread tracking, and cached article bodies
  • Unified search: Fast results across official repos and the AUR
  • Keyboard‑first: Minimal keystrokes, Vim‑friendly navigation; mouse wheel moves the focused row in System Update, Repositories, Optional Deps, and the Updates available list when the pointer is over the modal
  • Configurable main layout: Reorder the vertical stack (results, search, details) and set per-band row limits in settings.conf (main_pane_order, vertical_* keys — see Configuration)
  • Queue & install: Space to add, Enter to confirm installs. Press S in the confirm dialog to scan AUR packages before installing
  • Always‑visible details: Open package links with a click
  • PKGBUILD preview: Toggle viewer; copy PKGBUILD with one click; per-package fetches do not block each other, and stale responses are dropped when you change rows
  • Persistent lists: Recent searches and Install list are saved
  • Installed‑only mode: Review and remove installed packages safely (configurable filter mode: leaf only or all explicit)
  • Package downgrade: Downgrade installed packages to previous versions using the downgrade tool
  • BlackArch (optional official repo): When the blackarch repository is already enabled in pacman, Pacsea indexes those packages with the other official repos, shows a BlackArch label, and provides a title-bar filter chip—same interaction pattern as EndeavourOS/CachyOS optional badges. Pacsea does not install or configure the BlackArch repo; you set that up yourself
  • Custom / third-party repositories (Linux): Define extra sync sources in ~/.config/pacsea/repos.conf, manage them from Options → Repositories, and apply a managed drop-in at /etc/pacman.d/pacsea-repos.conf. After a successful apply, Pacsea can walk you through foreign-package overlap when AUR-installed names also exist in the new repo. paru / yay installs use -S --aur for AUR-only queue items so helpers do not silently satisfy AUR picks from sync repos (e.g. Chaotic). See How to use Pacsea — Custom repositories
  • Distro-aware updates: Automatic detection and use of appropriate mirror tools for Manjaro, EndeavourOS, CachyOS, Artix, and standard Arch
  • Helpful tools: System update dialog with distro-aware mirror management and Arch News popup
  • AUR package voting (SSH): Vote/unvote AUR packages directly from search results with confirmation modal, live vote-state awareness, and guided SSH setup helper
  • Announcements: Version-specific and remote announcements shown at startup with clickable URLs and persistent read status
  • TUI Optional Deps: Install and verify recommended helper tools directly from a dedicated view with environment-aware defaults
  • Desktop integration: Application menu launcher and SVG icon (pacsea-bin / pacsea-git install them; the source tree ships them under data/ for manual or custom packaging)
  • Privilege setup assistants: Guided setup for sudo credential cache (sudoers drop-in guidance) and doas persist policy from startup tasks and Optional Deps
  • Long-run auth readiness warnings: One-time warnings before long operations when privilege settings may trigger mid-run re-authentication pauses
  • Preflight modal: Inspect dependencies, files, config conflicts, and optionally run AUR security scans before installs/removals. For Remove actions, review reverse dependencies and affected services
  • CLI Commands: Manage packages from the command line without launching the TUI (search, install, remove, update, list, news, clear cache)
  • Multi-language support: Available locales include en-US, de-DE, hu-HU (more coming soon)
  • Resilient configuration: On each start, migrates legacy single-file configs when needed and fills missing theme colors and settings keys from defaults so the TUI always has a complete theme—see Configuration

Installation

  • Stable (prebuilt): paru -S pacsea-bin or yay -S pacsea-bin
  • Latest (git): paru -S pacsea-git or yay -S pacsea-git
  • From source:
sudo pacman -S rustup && rustup default stable
git clone https://github.com/Firstp1ck/Pacsea
cd Pacsea
cargo run

Quick start

pacsea                 # Launch TUI
# Or use dry-run mode (no changes)
pacsea --dry-run
# Or use CLI commands (no TUI)
pacsea -s <query>      # Search packages
pacsea -i <package>    # Install packages
pacsea -u              # System update
  • TUI mode: Type to search, ↑/↓ to navigate, Space to queue, Enter to install
  • Press F1 or ? for the in‑app help and keybindings
  • For AUR packages: Press S in the confirm dialog to scan before installing
  • CLI mode: Use command-line flags to manage packages without the TUI (see How to use Pacsea)

Links

Documentation:

Clone this wiki locally