objcurses v2.2.1

objcurses v2.2.1

objcurses is a minimalistic 3D object viewer that runs in your terminal using ncurses. It renders .obj models in real time using ASCII characters and a simple rendering pipeline. The project was built from scratch in modern C++20 using up-to-date best practices and a clean modular design, as a personal exploration of low-level graphics programming – without relying on external graphic engines or frameworks.

---

What's New in v2.2.1

• fix: arguments parsing
• feat: add color theme selection
• perf: improve rendering loop efficiency

---

Downloads

File	Description
objcurses-2.2.1-linux.tar.gz	Binary archive for manual installation
objcurses-2.2.1-linux.deb	Debian package for installation

---

Installation

Using .deb package (Debian-based systems)

sudo dpkg -i objcurses-2.2.1-linux.deb

To uninstall:

sudo dpkg -r objcurses

Using .tar.gz archive (Manual installation)

tar -xzvf objcurses-2.2.1-linux.tar.gz
cd objcurses-2.2.1-linux
sudo mv objcurses /usr/local/bin/
sudo chmod +x /usr/local/bin/objcurses

Verify installation:

objcurses --help

---

Usage Examples

objcurses file.obj                # basic
objcurses -c file.obj             # enable colors
objcurses -c transparent file.obj # set transparent color theme
objcurses -c -a -z 1.5 file.obj   # start animation with zoom 1.5 x
objcurses -c -a 10 file.obj       # start animation with speed 10.0 deg/s
objcurses -c --invert-z file.obj  # flip z axis if blender model 

Navigation:

←, h, a            Rotate left  
→, l, d            Rotate right  
↑, k, w            Rotate up  
↓, j, s            Rotate down  
+, i               Zoom in  
-, o               Zoom out  
Tab                Toggle HUD  
q                  Quit  

---

This release includes all features and is ready for use.