openskp 0.2.0

Open-source SketchUp (.skp) binary file parser — extract geometry, metadata, layers, and materials

OpenSKP — Python Package

Open-source SketchUp (.skp) binary file parser. Extract geometry, metadata, layers, and materials from SketchUp files without requiring SketchUp itself.

Installation

pip install openskp

Or install from source:

git clone https://github.com/iamahsanmehmood/openskp.git
cd openskp/packages/python
pip install -e .

Quick Start

from openskp import SkpFile

# Parse an SKP file
skp = SkpFile.open("model.skp")
model = skp.parse()

# Inspect layers
for layer in model.layers:
    print(f"{layer.name}: rgb({layer.color_r}, {layer.color_g}, {layer.color_b})")

# Inspect definitions (component geometry)
for defn in model.definitions.values():
    print(f"{defn.name}: {len(defn.faces)} faces, {len(defn.vertices)} vertices")

# Inspect scene hierarchy
for inst in model.scene_hierarchy:
    print(f"  {inst.name} → definition #{inst.ref_idx}")

Exporting

from openskp.export import glb, obj, json_export

# Export to GLB (glTF 2.0 binary)
glb.export(model, "output.glb")

# Export to Wavefront OBJ
obj.export(model, "output.obj")

# Export metadata as JSON
meta = json_export.to_dict(model)
json_export.export(model, "output.json")

Package Structure

Module	Purpose
openskp.parser	TLV binary parser for SketchUp's internal format
openskp.model	Dataclasses for geometry, layers, materials
openskp.vff	VFF/ZIP container handling
openskp.geometry	Geometry extraction from parsed nodes
openskp.triangulator	3D planar polygon triangulation
openskp.materials	Material and layer XML parsing
openskp.metadata	Dynamic properties and scene hierarchy
openskp.transforms	3D matrix transforms and coordinate conversion
openskp.export	GLB, OBJ, and JSON exporters

Requirements

• Python ≥ 3.9
• NumPy ≥ 1.20
• Trimesh ≥ 3.0
• Shapely ≥ 1.8

License

MIT — see the root repository for full documentation and multi-language packages.