objcurses v2.0.0

objcurses v2.0.0

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.0.0

• feat: added animation speed control, initial zoom setting, and fps stabilization

This release introduces breaking changes and is not fully compatible with the previous CLI argument structure.

---

Downloads

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

---

Installation

Using .deb package (Debian-based systems)

sudo dpkg -i objcurses-2.0.0-linux.deb

To uninstall:

sudo dpkg -r objcurses

Using .tar.gz archive (Manual installation)

tar -xzvf objcurses-2.0.0-linux.tar.gz
cd objcurses-2.0.0-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 -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.