Argus is a custom "Control Center" and documentation hub for Linux "ricers" (specifically Hyprland/Fedora). It serves as an onboarding dashboard to help you remember keybindings, view cheat sheets, and manage your system configuration after time away.
Built with Tauri v2, Angular 18+, and Angular Material.
- Documentation Hub: Renders local Markdown files (
welcome.md,cheatsheet.md) for easy editing. - Keybinding Visualizer: Searchable table of your custom Hyprland shortcuts.
- Extensible: Ready to add system management scripts via Rust.
- Rust & Cargo (
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh) - Node.js & npm
- Linux build tools:
sudo dnf install glib2-devel gobject-introspection-devel pango-devel \ gdk-pixbuf2-devel atk-devel gtk3-devel webkit2gtk4.1-devel \ libappindicator-gtk3-devel librsvg2-devel openssl-devel cairo-devel \ libsoup3-devel
Start the development server (Angular + Rust):
npm run tauri devCreate an optimized release binary:
npm run tauri buildThe output binary will be located at: src-tauri/target/release/bundle/deb/ (or similar depending on packaging).
src/: Angular frontend code.src/assets/: Location for your localkeybindings.jsonand markdown docs.
src-tauri/: Rust backend code.src-tauri/src/lib.rs: Custom commands (e.g., file reading).
- Dynamic docs explorer: Rust
list_docscommand plus Angular services now scan~/.config/argus/docs, categorize files by subfolder, and keep the sidenav/search automatically in sync when new markdown files are added. - Document search/nav refresh: Search dialog builds its index from the same dynamic data, and the sidenav groups are generated at runtime with fallback entries such as Keybindings.
- TOC parity with VitePress: The “On This Page” component now uses IntersectionObserver + smooth scrolling, giving section highlighting and anchor jumps that match modern doc sites.
- UX polish: Default Tauri window opens at 1280×900 with sensible minimums; heading styles include
scroll-margin-topso anchor jumps account for the sticky layout.