Paneler

Footbag or soccer ball panel generation tool. This program takes an obj file with some shape in it, projects it onto a sphere, then flattens it to figure out the panel shapes.

Some features that I plan to add soon:

• Support for shapes with curved edges
• Shape generation

Examples

---

Usage

# Install
uv sync

# List available shapes
uv run python main.py --list

# Generate cutting patterns
uv run python main.py icosahedron


# With custom size and seam allowance
uv run python main.py icosahedron --radius 5.0 --seam-allowance 0.2 --output my_ball.pdf

# With 3D visualization
uv run python main.py icosahedron --save-viz shape.html

Available Shapes

All shapes are loaded from .obj files in the shapes/ directory.

Included Shapes

• tetrahedron - 4 triangular faces
• cube - 6 square faces
• octahedron - 8 triangular faces
• dodecahedron - 12 pentagonal faces
• icosahedron - 20 triangular faces
• pyramid - 6 triangular faces
• cube-diag - Cube with diagonals
• truncated_icosahedron - 32 faces (classic soccer ball, procedurally generated)

Add Your Own

Add .obj files to the shapes/ directory - they'll automatically appear in --list. See shapes/README.md for details.