Ratty: A Bevy-Rendered Rust Terminal With a 3D Mode, a Spinning Rat Cursor and Its Own Graphics Protocol
A GPU-rendered terminal emulator with inline 3D graphics 🐀🧀
At a glance
- What is it?
- Ratty is a GPU-rendered terminal emulator written in Rust that can warp the terminal into 3D space and place inline 3D models in it. It needs a Bevy and wgpu compatible graphics stack, and its 3D objects depend on a protocol that only Ratty defines.
- Who is it for?
- Ratty is for people who want a terminal that doubles as a small 3D playground, and for developers who want to build Ratatui apps with inline models through its widget. It is a risky daily driver for anyone without a Bevy and wgpu compatible GPU stack, and its 3D features only pay off in programs written for Ratty's own protocol.
- Can I use it commercially?
- Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
- Is it still maintained?
- Yes. The repository last received commits 22 days ago.
- What is it written in?
- Mainly Rust, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 21, 2026, and from our analysis. They are not legal advice.
Star history
- orhun/ratty3,332 ★ · +86
| Repository | 2026-09-24 | 2026-11-21 |
|---|---|---|
| orhun/ratty | 3.2k | 3.3k |
86 Stars in the last 58 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
A GPU and graphics stack supported by Bevy and wgpu is a hard requirement
Ratty draws its terminal through the Bevy game engine and the wgpu graphics layer, and the installation notes put this first in the requirements: a GPU or graphics stack supported by Bevy and wgpu. The second requirement on the list is melted cheese, marked optional but recommended, which is a joke rather than a dependency.
The practical meaning is that Ratty is not a drop-in replacement on every machine where you open a shell. A minimal server over SSH, a container without graphics, or an old machine whose drivers wgpu does not support is outside what the README promises. The window comes from winit, and the Cargo manifest enables both the `wayland` and `x11` Bevy features, so a Linux desktop session on either display protocol is covered by the build configuration.
Because rendering is on the GPU, the terminal also carries the weight of a game engine, including a long Bevy dependency list in Cargo.toml. If you pick a terminal for low memory use or quick startup, check how Ratty behaves on your hardware first; the README makes no performance claims to rely on.
Five install routes, and the source build needs system libraries first
Ratty is packaged in several ways. From crates.io:
cargo install rattyOn Arch Linux it is in the extra repository:
sudo pacman -S rattyNix users can run it directly, and Nix packaging docs cover flake, NixOS and Home Manager usage:
nix run github:orhun/rattyPrebuilt binaries are on the GitHub releases page. Building from Git needs a Rust toolchain with Cargo plus development headers. On Debian or Ubuntu the README gives:
sudo apt-get update ; sudo apt-get install gcc pkgconf libfontconfig-dev libwayland-devFedora needs `gcc fontconfig-devel wayland-devel` through dnf, and Bazzite or Bluefin needs the same packages through `rpm-ostree` followed by a reboot. The final step is:
cargo install --git https://github.com/orhun/rattyThe split matters in practice. The crates.io and Git routes compile the whole Bevy stack on your machine, which takes time and the headers above. The Arch package and the binary releases skip that step but follow the maintainers' release timing, not the latest commit.
3D mode starts with Ctrl+Alt+Enter and offers orthographic, perspective and Mobius views
The feature that gives the project its reputation is 3D mode. The README introduces it with a question about what is behind the terminal and tells you to press Ctrl+Alt+Enter. In the key binding table, that combination toggles between 2D and orthographic 3D, Ctrl+Alt+P toggles perspective, and Ctrl+Alt+M toggles Mobius mode. Ctrl+Alt+Up and Ctrl+Alt+Down increase and decrease the warp.
Camera slots are bound to Ctrl+Alt+Shift plus a digit from 0 to 9. The extra Shift keeps slot 0 distinct from Ctrl+Alt+0, which resets the font size. Ordinary bindings are also listed: Ctrl+Shift+C and Ctrl+Shift+V for copy and paste, Alt+PageUp and Alt+PageDown for scrolling by page, and Ctrl+= and Ctrl+- for font size.
There is a compatibility note for custom configs. `ToggleOrtho3DMode` is the current action name for the orthographic 3D toggle, and the old `Toggle3DMode` remains as a backward-compatible alias. Camera slot actions are named `ActivateCameraSlot0` through `ActivateCameraSlot9`. A rename like this inside a pre-1.0 project is a reminder to re-read the key binding names after upgrading.
The cursor is a 3D model you must configure by copying a file into place
The default configuration file is config/ratty.toml in the repository, and you copy it to `$HOME/.config/ratty/ratty.toml` to customise it. The cursor section shows the shape of the options:
[cursor.model]
path = "CairoSpinyMouse.obj"
scale_factor = 6.0
brightness = 0.5
x_offset = 0.5
plane_offset = 18.0
visible = true
[cursor.animation]
spin_speed = 1.4
bob_speed = 2.2
bob_amplitude = 0.08The `path` setting accepts `.obj`, `.glb` and `.stl` assets. `scale_factor` scales the model relative to the terminal cell size, `brightness` adjusts the material, and `x_offset` shifts the model horizontally inside the cell. `plane_offset` pushes the cursor away from the warped terminal surface in 3D mode, and `visible` shows the custom model instead of only the terminal cursor.
The animation block controls spin speed, bob speed and bob amplitude. The consequence of a model cursor is that it is sized relative to a cell, so a very detailed asset or a poor scale factor can cover neighbouring text. Test a new model in both 2D and 3D mode, since the plane offset only matters when the terminal surface is warped.
Inline 3D objects need the Ratty Graphics Protocol, which only Ratty defines
Ratty uses its own protocol, the Ratty Graphics Protocol or RGP, to place inline 3D objects in terminal space. According to the README, RGP can register `.obj`, `.glb` and `.stl` assets by path, place them at terminal cell anchors, set animation, scale, colour and depth attributes, and control the camera for flat, orthographic, perspective and Mobius views. The specification lives in protocols/graphics.md.
For programmers there is a Ratatui widget called `ratatui-rgp` in the widget directory, which the Cargo manifest excludes from the main workspace. It exists for building your own terminal applications that involve inline 3D objects. Four examples use it: a big rat, a TempleOS-inspired document with editable text and embedded 3D objects, a split-pane drawing demo with a 2D canvas and live 3D preview, and an interactive Rubik's cube.
The limit is that RGP is a Ratty-specific protocol, so a program must be written to emit it. The 3D objects will not appear from ordinary command-line tools. Image support is separate: the README lists images through the Kitty Graphics Protocol, with a grumpy face in the feature list, which shows the author's own reservations about that protocol.
The dependency tree is built on Bevy 0.19 and a custom terminal stack
Cargo.toml shows how the terminal is assembled. The crate is at version 0.6.0 on Rust edition 2024, with `bevy` 0.19.0 and default features turned off in favour of an explicit list that includes bevy_gltf, bevy_pbr, bevy_text, bevy_winit, wayland, x11 and multi-threading. Terminal behaviour comes from `fux-vt` 0.4.1, `portable-pty` 0.8 and `bevy_terminal_ratatui` 0.8.1 with the system_fonts feature, and `ratatui` 0.30 sits on top. Model loading uses `tobj` for OBJ and `stl_io` for STL, and `arboard` handles the clipboard with Wayland data control.
A section of the manifest is labelled as an MCP control-plane binary, with `rmcp` and `tokio` among its dependencies. The README text available does not explain that component, so do not assume its behaviour. There is also an `examples/headless_snapshot.rs` file.
Two consequences follow. Every Bevy minor release can change the engine underneath, so building from Git may break when Bevy moves. And since the terminal parser is a separate crate, terminal compatibility questions about escape sequences are decided by that library, not by Ratty's own README claims.
Version 0.6.0 arrived in October 2026, and the project is pre-1.0
The release list shows v0.4.2 on 2026-06-15, v0.5.0 on 2026-07-05 and v0.6.0 on 2026-10-11, with the last push on 2026-10-31. That is a project moving through minor versions every few weeks, and the repository has a CHANGELOG.md and a cliff.toml for generating it. It is not archived, and it is licensed under MIT.
A pre-1.0 number is a warning. Configuration keys, action names and the protocol are free to change between minor versions, as the Toggle3DMode rename already shows. If you build an application on RGP or the ratatui-rgp widget, pin the Ratty version you test against and read the changelog before upgrading.
The README also leans on press and fun: it calls the project inspired by TempleOS, built with Rust and Ratatui, and links write-ups from The Register, It's FOSS, Fireship and MakeUseOf. Treat those as visibility, not as technical review. They do not replace running the terminal yourself on your own GPU and checking that your shell, fonts and multiplexer behave well.
Editorial conclusion
Ratty is for people who want a terminal that doubles as a small 3D playground, and for developers who want to build Ratatui apps with inline models through its widget. It is a risky daily driver for anyone without a Bevy and wgpu compatible GPU stack, and its 3D features only pay off in programs written for Ratty's own protocol. The project is pre-1.0 at v0.6.0.
Frequently asked questions
What is Ratty?
Ratty is a GPU-rendered terminal emulator written in Rust that supports inline 3D graphics. It is built with Bevy and Ratatui, inspired by TempleOS, and licensed under MIT.
How do I install the Ratty terminal?
Run cargo install ratty, or sudo pacman -S ratty on Arch Linux, or nix run github:orhun/ratty. Prebuilt binaries are also on the GitHub releases page.
How do I switch Ratty into 3D mode?
Press Ctrl+Alt+Enter to toggle between 2D and orthographic 3D. Ctrl+Alt+P toggles perspective and Ctrl+Alt+M toggles Mobius mode.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/orhun-ratty)Star history chart for your README
[](https://hysenlabs.com/projects/orhun-ratty)Was this useful?