trophy

Trophy 🏆

Terminal 3D Model Viewer - View OBJ, GLB, and STL files directly in your terminal, ansipixels port + improvements.

Features

• OBJ, GLB & STL Support - Load standard 3D model formats
• Embedded Textures - Automatically extracts and applies GLB textures
• Interactive Controls - Rotate, zoom, and spin models with mouse/keyboard
• Software Rendering - No GPU required, works over SSH
• Springy Physics - Smooth, satisfying rotation with momentum

Installation

See the binary releases or

From source/with go:

go install github.com/ansipixels/trophy@latest

Or on mac

brew install ansipixels/tap/trophy

Or even with docker (slower than native though)

docker run -ti ghcr.io/ansipixels/trophy # default Trophy model demo
# Or
docker run -v `pwd`:/data -ti ghcr.io/ansipixels/trophy ./yourmodel.glb

On windows with powershell, you probably need to set COLORTERM if not already to get the 24 bit images instead of mono:

$env:COLORTERM = 'truecolor'

Usage

trophy help                   # See all the options and flags
trophy -ls                    # list the res:* embedded models
trophy res:teapot.stl         # Run the viewer for the Teapot embedded model
trophy                        # Run the viewer for the Trophy embedded model
trophy model.glb              # View a GLB model
trophy model.obj              # View an OBJ model
trophy model.stl              # View an STL model
trophy -texture tex.png model.obj  # Apply custom texture
trophy -fps 60 model.glb      # Higher framerate

Controls

Lighting

Press L to enter lighting mode and drag to reposition the light source in real-time:

Library Usage

Trophy's rendering packages can be used as a library:

import (
    "github.com/ansipixels/trophy/models"
    "github.com/ansipixels/trophy/render"
    "github.com/ansipixels/trophy/math3d"
)

// Load a model
mesh, texture, _ := models.LoadGLBWithTexture("model.glb")

// Create renderer
fb := render.NewFramebuffer(320, 200)
camera := render.NewCamera()
rasterizer := render.NewRasterizer(camera, fb)

// Render (uses optimized edge-function rasterizer)
rasterizer.DrawMeshTexturedOpt(mesh, transform, texture, lightDir)

Packages

• math3d - 3D math (Vec2, Vec3, Vec4, Mat4)
• models - Model loaders (OBJ, GLB/GLTF, STL)
• render - Software rasterizer, camera, textures

Benchmarks

Run with go test -bench=. -benchmem ./...

Math (math3d)

Rendering (render)

Culling Performance

The optimized rasterizer (*Opt variants) uses incremental edge functions instead of per-pixel barycentric recomputation, yielding ~18% speedup on triangles and ~50% speedup on full mesh rendering.

Benchmarks run on AMD EPYC 7642 48-Core, linux/amd64

Credits

The (Awesome!) original github.com/taigrr/trophy was built with ultraviolet for terminal rendering.

This is the Ansipixels TUI version which 30% smaller binary and has faster/more stable FPS and I believe clearer/simpler main loop code.