artemtsitronov/ravioli

An almost-zero dependencies ASCII 3D OBJ viewer. Animations, and RGB-colored shading is supported.

Rust

6 commits

updated Sep 17, 2026

See the code

See what people are saying (2)

Newest first

Most points

Source	Message	Score	Date
	Ravioli is a 3D ASCII art preview that loads an .OBJ and spins it in your terminal (r/commandline) Hellow people! Sooo, this is a simple CLI tool to load OBJ files and preview them as ASCII art in the terminal with a nice animation. It's perfect for showcases, and... showcases. It has a textured(ASCII) mode and a solid(block glyph) one, and in both of those to add better lightning, it dims the…	9	Sep 17, 2026
	Ravioli is a simple CLI tool to preview 3D ASCII (r/rust) Soo, Ravioli came out, and it's an easy to use cli tool to preview 3d files in ascii format. It's perfect for rice showcases, and... probably something else. I hope. It only has two dependencies: clap for cli, and terminal-size to determine the window size. As lightning, it both uses ASCII…	27	Sep 17, 2026

README

ravioli

An ASCII 3D OBJ viewer. Animations, and RGB-colored shading is supported. The only external dependencies are clap for CLI parsing and terminal_size for live terminal sizing.

Features

OBJ mesh loading (vertices + n-gon faces, fan-triangulated)
Perspective projection with a software rasterizer (barycentric fill + z-buffer)
Two-light (key + fill) flat shading with true 24-bit RGB color
Backface culling
Solid or textured (ASCII ramp) render modes
Live terminal-resize support
Falls back to a built-in demo cube if no file is given

Install

cargo install ravioli

Usage

ravioli                              # spin the built-in demo cube
ravioli -O model.obj                 # spin your own mesh
ravioli -O model.obj -S 2.0          # faster rotation
ravioli -O model.obj -C 3.0          # camera further back
ravioli -O model.obj -M solid        # solid block glyphs
ravioli -O model.obj -R false        # disable live terminal-resize

Flag	Long form	Default	Description
`-O`	`--obj`	(built-in cube)	Path to an `.obj` file
`-S`	`--speed`	`1.0`	Rotation speed multiplier
`-C`	`--camera-distance`	`1.5`	Distance of the camera from the object
`-M`	`--mode`	`textured`	`solid` or `textured`
`-R`	`--resize`	`true`	Re-detect terminal size live while running

Contributors

artemtsitronov

6 commits

Similar repos

sharjith/ModelViewer-Qt5

atanunq/viu

Terminal image viewer with native support for iTerm and Kitty

3,277

David-OConnor/graphics

openrr/urdf-viz

visualize URDF/XACRO file, URDF Viewer works on Windows/MacOS/Linux

590

simeg/bash-cli-spinners

🌈 +80 Bash/Zsh spinners for scripts and terminal

buyukakyuz/protein-foldspace

Fast and efficient interactive 3D protein structure viewer

orangeduck/BVHView

A simple viewer for the .bvh animation file format written using raylib.

368

asny/three-d

2D/3D renderer - makes it simple to draw stuff across platforms (including web)

1,671

Languages

Rust

100.0%

artemtsitronov/ravioli

An almost-zero dependencies ASCII 3D OBJ viewer. Animations, and RGB-colored shading is supported.

Rust

6 commits

updated Sep 17, 2026

See the code

See what people are saying (2)

Newest first

Most points

Source	Message	Score	Date
	Ravioli is a 3D ASCII art preview that loads an .OBJ and spins it in your terminal (r/commandline) Hellow people! Sooo, this is a simple CLI tool to load OBJ files and preview them as ASCII art in the terminal with a nice animation. It's perfect for showcases, and... showcases. It has a textured(ASCII) mode and a solid(block glyph) one, and in both of those to add better lightning, it dims the…	9	Sep 17, 2026
	Ravioli is a simple CLI tool to preview 3D ASCII (r/rust) Soo, Ravioli came out, and it's an easy to use cli tool to preview 3d files in ascii format. It's perfect for rice showcases, and... probably something else. I hope. It only has two dependencies: clap for cli, and terminal-size to determine the window size. As lightning, it both uses ASCII…	27	Sep 17, 2026

README

ravioli

An ASCII 3D OBJ viewer. Animations, and RGB-colored shading is supported. The only external dependencies are clap for CLI parsing and terminal_size for live terminal sizing.

Features

OBJ mesh loading (vertices + n-gon faces, fan-triangulated)
Perspective projection with a software rasterizer (barycentric fill + z-buffer)
Two-light (key + fill) flat shading with true 24-bit RGB color
Backface culling
Solid or textured (ASCII ramp) render modes
Live terminal-resize support
Falls back to a built-in demo cube if no file is given

Install

cargo install ravioli

Usage

ravioli                              # spin the built-in demo cube
ravioli -O model.obj                 # spin your own mesh
ravioli -O model.obj -S 2.0          # faster rotation
ravioli -O model.obj -C 3.0          # camera further back
ravioli -O model.obj -M solid        # solid block glyphs
ravioli -O model.obj -R false        # disable live terminal-resize

Flag	Long form	Default	Description
`-O`	`--obj`	(built-in cube)	Path to an `.obj` file
`-S`	`--speed`	`1.0`	Rotation speed multiplier
`-C`	`--camera-distance`	`1.5`	Distance of the camera from the object
`-M`	`--mode`	`textured`	`solid` or `textured`
`-R`	`--resize`	`true`	Re-detect terminal size live while running

Similar repos

sharjith/ModelViewer-Qt5

atanunq/viu

Terminal image viewer with native support for iTerm and Kitty

3,277

David-OConnor/graphics

openrr/urdf-viz

visualize URDF/XACRO file, URDF Viewer works on Windows/MacOS/Linux

590

simeg/bash-cli-spinners

🌈 +80 Bash/Zsh spinners for scripts and terminal

buyukakyuz/protein-foldspace

Fast and efficient interactive 3D protein structure viewer

orangeduck/BVHView

A simple viewer for the .bvh animation file format written using raylib.

368

asny/three-d

2D/3D renderer - makes it simple to draw stuff across platforms (including web)

1,671

Contributors

artemtsitronov

6 commits

Languages

Rust

100.0%