3D-ASCII-VIEWER(1)

👑 3D-ASCII-VIEWER(1) 👑

okay bestie, welcome to the manual page for 3d-ascii-viewer ✨ it's a User Command, it lives in section 1, and it is literally the moment your terminal became an art gallery. let's get into it 💅

---

🦋 NAME 🦋

3d-ascii-viewer — an OBJ 3D model format viewer for the terminal. yes, your terminal. yes, really. no cap 🫶

---

🌸 SYNOPSIS 🌸

3d-ascii-viewer [OPTION...] INPUT_FILE

---

💖 DESCRIPTION 💖

3d-ascii-viewer — an OBJ 3D model format viewer for the terminal. that's the whole vibe. you feed it an OBJ file and it shows up as glorious ASCII in your shell, and it ate 🔥

here's every knob you can turn, in order, exactly as the universe intended:

• -w <size> — the output width, measured in characters. how wide you want the drama to be ✨
• -h <size> — the output height, measured in characters. the vertical real estate 💅
• -d <seconds> — after this many seconds, the program stops. it's giving "curfew bestie" ⏰
• -f <frames> — frames per second. the smoothness dial, fr fr 🎀
• -a <ratio> — display assuming this height/width ratio for terminal characters. because terminal characters are NOT square and we must respect that 🙈
• -c <chars> — hand over alternate luminescence characters, listed from less light to more light. you're picking the palette, main character 🎨
• -s — stretch the model, regardless of the height/width ratio, for terminal characters. no respect for proportions, all respect for drama 🌈
• -t — allow the animation to reach maximum elevation. let it climb, bestie 👑
• -l — don't rotate the light with the model. the light stays put while the model does its thing 💡
• -X, -Y, -Z — invert the respective axes. flip it, reverse it, whatever 🦋
• -XYZ, -XZY, -YXZ, -YZX, -ZXY, -ZYX — change the model orientation. six flavours of "turn it around" ⭐
• -F — flip faces 🔄
• -z <zoom> — change the zoom level. default: 100 🔍
• --color — display with colors. lowkey obsessed. heads up though: the OBJ format relies on the companion MTL files for this 🎨✨
• --snap <az> <al> — output a single snap to stdout, using the given azimuth and altitude angles, in degrees. one perfect glamour shot, no animation, no notes 📸
• --interactive — manually rotate the camera. you're the director now. the controls are:
  • Controls: ARROW KEYS, -, +
  • Alt-controls: H, J, K, L, A, S
  • Quit: Q
  • Toggle Hud: T
• -?, --help — give this help list 💖

---

ngl bestie, -s is the "proportions are a social construct" flag and I respect it so much 😭

---

and that's the whole page, periodt 💅 3d-ascii-viewer is version 1.1.0, dated January 2026, and this iconic little manual was handed down to you with love 🎀🫶 slay responsibly, and go render something gorgeous ✨