Skip to content

objcurses v1.4.1

Choose a tag to compare

@admtrv admtrv released this 22 May 22:16
· 6 commits to main since this release

objcurses v1.4.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 v1.4.1

  • fix(renderer): remove object centering along x axis
  • feat: add start animation feature
  • fix(object): rework start size
  • build(cmake): add install rules
  • docs(readme): add sample models photos

Downloads

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

Installation

Using .deb package (Debian-based systems)

sudo dpkg -i objcurses-1.4.1-linux.deb

To uninstall:

sudo dpkg -r objcurses

Using .tar.gz archive (Manual installation)

tar -xzvf objcurses-1.4.1-linux.tar.gz
cd objcurses-1.4.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 --light file.obj  # disable light rotation

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.