Home

retch Wiki

Welcome to the retch wiki! retch is a fast, feature-rich system information fetcher written in Rust.

Documentation & Pages

• Continuous Performance Benchmarks — Historical performance tracking dashboard.
• Configuration & Theming — Customizing retch output fields, themes, and custom color overrides.
• Workspace Architecture — Explaining the modular multi-crate workspace layout.
• Development Setup — Setting up the development environment, prerequisites, and checking changes.

Project Overview

retch is designed to be highly responsive. It leverages Rust's concurrency model (std::thread::scope) to parallelize slow external system queries—such as GPU detection, package counting, IP resolution, and active network interface detection—preventing sequential execution blockages.

Key Features

• Parallelized Pipeline: Low latency fetching using scoped threads.
• Rich Graphics Support: Native Kitty, iTerm2, and Sixel graphical inline images, with smart fallback to Chafa (Unicode symbols) or colored ASCII art.
• Flexible Theming: Built-in themes (Catppuccin, Solarized, Neutral, Dark/Light) along with custom hex-color configuration overrides.
• Configuration: Seamless merging between command-line flags and configuration settings (~/.config/retch/config.toml).