Skip to content
tinatsu-nomyPublic

About

A 3D Model viewer for VRM / FBX / PMX / PMD / OBJ / STL / DirectX .x. Built with egui + wgpu. Developed with AI (Claude Code, Codex, Gemini).

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

popone

日本語

A 3D viewer for VRM / FBX / PMX / PMD / OBJ / STL / DirectX .x files.

Download

Latest release: popone-v0.5.18.exe

All releases: Releases

Screenshots

Model Info Expression Morphs Wireframe Solid + Wire

Model: Alicia Solid — (C) DWANGO Co., Ltd. / Character Design: 黒星紅白

Disclaimer

  • The author assumes no responsibility for any issues arising from the use of this tool.
  • The user interface is localized in Japanese, English, and Chinese, following the OS language setting (can be overridden with the POPONE_LOCALE environment variable: ja / en / zh).

License

0BSD License — Free to use, modify, and redistribute without attribution.

Bundled third-party assets (fonts, etc.) are under their own licenses. See THIRD_PARTY_NOTICES.md for details.

Usage

See Usage for details.

Building from Source

Requires Rust (stable).

# CLI only (converts VRM / FBX / OBJ / STL / DirectX .x / UnityPackage / ZIP / 7z / RAR to PMX)
cargo build --release

# With viewer (3D viewer GUI)
cargo build --release --features viewer

On Windows, Windows SDK is recommended for embedding the exe icon (rc.exe). If not installed, the build will succeed but the exe will have no custom icon.

Dependencies

Core (CLI conversion)
Crate Purpose
gltf GLB/glTF 2.0 parser (with extensions feature)
serde / serde_json VRM extension JSON deserialization
glam 3D math (Vec3, Quat, Mat4)
byteorder PMX binary read/write (little-endian)
image Texture PNG/JPEG/BMP/TGA decode/encode
mikktspace MikkTSpace tangent vector generation (for normal maps)
encoding_rs PMD Shift_JIS text conversion
flate2 zlib compression/decompression
tar .unitypackage (tar.gz) extraction
zip ZIP archive extraction
sevenz-rust2 7z archive extraction
unrar RAR archive extraction (official UnRAR library)
tobj OBJ/MTL parser
toml TOML config parser
dunce UNC path simplification
tempfile Temporary file creation
clap CLI argument parser
anyhow / thiserror Error handling
log / fern / chrono / env_logger Logging
rayon Parallel iteration (UnityPackage asset processing)
pathdiff Relative path computation (MME .fx #include resolution)
rust-i18n / sys-locale UI localization (ja / en / zh) and OS locale detection
Viewer (viewer feature)
Crate Purpose
eframe egui + wgpu window framework
rfd Native file dialog
bytemuck Vertex/uniform Pod conversion
encase Uniform buffer serialization (glam integration)
pollster Async blocking executor
Dependency Licenses

Core

Crate License
gltf MIT OR Apache-2.0
serde / serde_json MIT OR Apache-2.0
glam MIT OR Apache-2.0
byteorder Unlicense OR MIT
image MIT OR Apache-2.0
mikktspace MIT OR Apache-2.0
encoding_rs MIT OR Apache-2.0
flate2 MIT OR Apache-2.0
tar MIT OR Apache-2.0
zip MIT
sevenz-rust2 Apache-2.0
unrar MIT OR Apache-2.0 (bindings) / UnRAR license (bundled UnRAR source; see THIRD_PARTY_NOTICES.md)
tobj MIT
clap MIT OR Apache-2.0
anyhow / thiserror MIT OR Apache-2.0
log / fern / chrono MIT (fern) / MIT OR Apache-2.0 (others)
toml MIT OR Apache-2.0
dunce CC0-1.0 OR MIT-0 OR Apache-2.0
tempfile MIT OR Apache-2.0
env_logger MIT OR Apache-2.0
rayon MIT OR Apache-2.0
pathdiff MIT OR Apache-2.0
rust-i18n MIT
sys-locale MIT OR Apache-2.0

Viewer

Crate License
eframe MIT OR Apache-2.0
rfd MIT
bytemuck Zlib OR Apache-2.0 OR MIT
encase MIT OR Apache-2.0
pollster MIT OR Apache-2.0

Trademarks & Acknowledgments

This software reads and converts the following file formats. All trademarks are the property of their respective owners.

  • VRM — 3D avatar format by VRM Consortium
  • FBX — FBX is a trademark of Autodesk, Inc.
  • glTF / GLB — glTF is a trademark of the Khronos Group Inc.
  • DirectX .x — DirectX is a trademark of Microsoft Corporation
  • PSD — Photoshop and PSD are trademarks of Adobe Inc.
  • PMX / PMD — Formats originating from MikuMikuDance (樋口M) and PMXEditor (極北P)
  • OBJ — Wavefront OBJ, originally by Wavefront Technologies
  • STL — Originally developed by 3D Systems for stereolithography

Shader References

This software detects and approximates the following shader technologies for PMX conversion:

About

A 3D Model viewer for VRM / FBX / PMX / PMD / OBJ / STL / DirectX .x. Built with egui + wgpu. Developed with AI (Claude Code, Codex, Gemini).

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages