An open API service indexing awesome lists of open source software.

https://github.com/dturovskiy/deusapps-obj-importer-lite

Geometry-only Wavefront OBJ importer for SketchUp, optimized for Blender workflows.
https://github.com/dturovskiy/deusapps-obj-importer-lite

3d architecture blender blender-workflow geometry importer obj obj-importer ruby sketch-plugin sketchup sketchup-extensions wavefront-obj

Last synced: 12 days ago
JSON representation

Geometry-only Wavefront OBJ importer for SketchUp, optimized for Blender workflows.

Awesome Lists containing this project

README

          

# DeusApps OBJ Importer Lite

**DeusApps OBJ Importer Lite** is a geometry-only Wavefront OBJ importer for SketchUp, optimized for Blender-to-SketchUp workflows.

It imports standard `.obj` files into SketchUp as clean, editable geometry. Blender is the primary tested workflow, but the importer can also be used with OBJ files exported from other 3D tools.

Materials and textures are intentionally ignored to avoid broken material assignments and keep imported models predictable.

![Toolbar icons](assets/toolbar_icons_preview.png)

## Features

- Import Wavefront OBJ geometry into SketchUp
- Optimized for Blender-exported OBJ files
- Geometry-only import
- Materials and textures are intentionally ignored
- Blender meters to SketchUp inches scale default
- Orientation presets for common Blender-to-SketchUp axis issues
- Architectural clean import mode
- Smooth Curves import mode for cylinders, pipes, columns, and rounded objects
- Clean Selected Geometry tool
- Safer face creation
- Quad repair
- Short-edge cleanup
- Collinear vertex cleanup
- Edge softening and smoothing
- DeusApps toolbar with command-specific icons

## Scope

This extension does not read `.blend` files directly and does not export `.skp` files from Blender.

It works inside SketchUp and imports Wavefront `.obj` geometry. The Blender workflow is recommended because Blender can export clean OBJ files with modifiers applied.

## Screenshots

| Menu and toolbar | Import options |
|---|---|
| ![Menu and toolbar](assets/screenshots/01_01_menu_toolbar_940x470.png) | ![Import dialog](assets/screenshots/02_02_import_dialog_940x470.png) |

## Recommended Blender export settings

Use:

- **Format:** Wavefront OBJ
- **Selection Only:** ON
- **Apply Modifiers:** ON
- **Write Materials:** OFF

## Installation

### From Extension Warehouse

Install from the SketchUp Extension Warehouse once the extension is approved.

### Manual RBZ install

1. Download the latest `.rbz` from the [Releases](../../releases) page.
2. In SketchUp, open **Window → Extension Manager**.
3. Click **Install Extension**.
4. Select the downloaded `.rbz`.
5. Restart SketchUp if the toolbar does not appear.

## Usage

In SketchUp:

```text
Extensions → DeusApps Blender OBJ Importer Lite
```

Available commands:

```text
Import Blender OBJ...
Import Blender OBJ - Smooth Curves...
Clean Selected Geometry...
Quick Help
About
```

For most architectural models, start with:

```text
Import Blender OBJ...
```

For cylinders, pipes, columns, and rounded parts, use:

```text
Import Blender OBJ - Smooth Curves...
```

After import, select the imported model/group and run:

```text
Clean Selected Geometry...
```

## Orientation notes

Single-axis flips are mirrors. If a model appears upside down, use an orientation preset such as:

```text
Rotate 180 around X
Rotate 180 around Y
```

For the tested Blender-to-SketchUp workflow, **Direct XYZ** or **Rotate 180 around Y** are usually the first presets to try.

## Building the RBZ

From the repo root:

```bash
python scripts/build_rbz.py
```

The RBZ will be created in:

```text
dist/deusapps_blender_obj_importer_lite_v1_0_2_extension_warehouse.rbz
```

The generated RBZ contains the Extension Warehouse-compatible structure:

```text
deusapps_blender_obj_importer_lite.rb
deusapps_blender_obj_importer_lite/
```

## License

This Lite edition is freeware/source-available. See [LICENSE](LICENSE.md).

You may install and use the Lite extension free of charge for personal and commercial SketchUp projects. You may redistribute the original, unmodified RBZ package. You may not sell, repackage, rebrand, or distribute modified versions without written permission from DeusApps.

## Developer

Developed by **DeusApps**.