trophy

Trophy 🏆

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

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

go install github.com/taigrr/trophy/cmd/trophy@latest

Usage

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 -bg 0,0,0 model.glb    # Black background
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/taigrr/trophy/pkg/models"
    "github.com/taigrr/trophy/pkg/render"
    "github.com/taigrr/trophy/pkg/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

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

Benchmarks

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

Math (pkg/math3d)

Rendering (pkg/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

Built with Ultraviolet for terminal rendering.