ratcrate-tui
| Crates.io | ratcrate-tui |
| lib.rs | ratcrate-tui |
| version | 0.1.0 |
| created_at | 2025-12-21 07:08:33.387986+00 |
| updated_at | 2025-12-21 07:08:33.387986+00 |
| description | Discover and manage ratatui terminal applications |
| homepage | |
| repository | https://github.com/ratcrate/ratcrate-tui |
| max_upload_size | |
| id | 1997629 |
| size | 141,337 |
Rakesh Venkat (rvbug)
documentation
README
🦀 ratcrate-tui: Ratatui Ecosystem Crate Discoverer
ratcrate-tui is a fast, terminal-based user interface (TUI) for exploring crates within the Ratatui ecosystem. Find core libraries, popular community packages, view stats, and get install commands—all without leaving your terminal.
It is built with Rust, leveraging the power of ratatui for the interface and crossterm for terminal interaction.
This is the 3rd tool in the Ratatui ecosystem.
Try out
- Web version Ratcrate
- CLI version ratcrate-cli
✨ Demo
✨ Features
- Fast Crate Listing: Browse all known Ratatui ecosystem crates.
- Detailed Views: See descriptions, version, downloads, links, and categories for any selected crate.
- Intelligent Caching: Caches data locally to ensure near-instantaneous load times after the first run.
- Powerful Filtering & Search:
- Filter by core libraries vs. community packages.
- Search by name or description.
- Pre-defined lists: Top (by downloads), Recent (by weekly downloads), and Newest crates.
- TUI-First Design: Intuitive, Vim-like navigation (
j/k/g/G/Ctrl+d/Ctrl+u). - Statistics View: See aggregate stats on total downloads, core/community distribution, and the top 5 crates.
⬇️ Installation
Prerequisites
You need to have the latest stable Rust toolchain installed. You can install it using rustup:
curl --proto '=https' --tlsv1.2 -sSf [https://sh.rustup.rs](https://sh.rustup.rs) | sh
From Crates.io (Recommended)
Once the project is published to Crates.io, you can install it directly with cargo:
$> cargo install ratcrates
Homebrew
$> brew install rvbug/tap/ratcrate-tui
From Source
Clone the repository and build it yourself:
$> git clone [https://github.com/rvbug/ratcrates.git](https://github.com/rvbug/ratcrates.git)
$> cd ratcrates
$> cargo install --path .
🚀 Usage
Simply run the command in your terminal:
$> ratcrate-tui
⌨️ Controls & Commands
The TUI operates in two main modes: Normal (Navigation) and Command (Input).
⌨️ Controls
Normal Mode (Default)
| Keybind | Action |
|---|---|
j / ↓ |
Move selection down |
k / ↑ |
Move selection up |
Ctrl+d |
Page down (jump 10 lines) |
Ctrl+u |
Page up (jump 10 lines) |
g |
Go to the top of the list |
G |
Go to the bottom of the list |
TAB |
Toggle Statistics view (View::Stats) |
? |
Toggle Help view (View::Help) |
: |
Enter Command mode |
/ |
Enter Command mode with a pre-typed :search prefix |
q |
Quit the application |
⌨️ Commands
| command | description | example |
|---|---|---|
:q :quit |
Quit the application | :quit |
:all |
Show all available crates (resets filters). | :all |
:core |
Show all available crates (resets filters). | :core |
:top [N] |
Show the top N crates by total downloads. (Default: 10) | :top 5 |
:recent [N] |
Show the top N crates by weekly (recent) downloads. | :recent 20 |
:new [N] |
Show the N newest crates (by creation date). | :new 20 |
:search <query> |
Search crate names and descriptions for a query. | :search terminal |
/<query> |
Shortcut for search (automatically prepends :search). |
/player |
Future Plans
-
Icon & beautification
-
Add Banner via
qbannerlibrary
Support
If you find my projects helpful or want to support my research and open-source work:
