# @jscad/obj-deserializer > OBJ Deserializer for JSCAD Latest version **2.0.33** (published 2026-02-22) · MIT license · 0 weekly downloads ## Install ```sh npm install @jscad/obj-deserializer pnpm add @jscad/obj-deserializer yarn add @jscad/obj-deserializer bun add @jscad/obj-deserializer ``` ## Health **Score 50/100 (C)** — status: stable. Positive: no vulnerabilities; high maintenance score. Warnings: low downloads; no types; no esm support. ## Facts | | | |---|---| | Version | 2.0.33 | | Published | 2026-02-22 | | First published | 2017-05-03 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 2 | | Unpacked size | 29.8 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 3241 | | Maintainers | z3dev, mister-jscad, simon_clark, platypii | | Keywords | openjscad, jscad, import, deserializer, obj | ## Links - npm: https://www.npmjs.com/package/@jscad/obj-deserializer - Repository: https://github.com/jscad/OpenJSCAD.org - Homepage: https://openjscad.xyz/ - Issues: https://github.com/jscad/OpenJSCAD.org/issues - npm.io page: https://npm.io/package/@jscad/obj-deserializer ## Dependencies (2) - [@jscad/io-utils](https://npm.io/package/@jscad/io-utils.md) 2.0.33 - [@jscad/modeling](https://npm.io/package/@jscad/modeling.md) 2.13.0 ## Recent versions - 2.0.33 (latest) — 2026-02-22 - 3.0.7-alpha.0 (alpha) — 2026-08-02 - 1.0.0-alpha.f58d6f4e (pre-V2) — 2018-11-25 - 3.0.6-alpha.0 — 2026-06-28 - 3.0.5-alpha.0 — 2026-05-16 - 3.0.4-alpha.0 — 2026-04-12 - 2.0.32 — 2026-02-11 - 3.0.3-alpha.0 — 2026-01-18 - 2.0.31 — 2025-09-20 - 3.0.2-alpha.0 — 2025-09-06 - 3.0.1-alpha.0 — 2025-01-03 - 2.0.30 — 2024-12-29 - 2.0.29 — 2024-11-10 - 2.0.28 — 2024-10-06 - 2.0.27 — 2024-06-02 - … 47 more at https://npm.io/package/@jscad/obj-deserializer/versions ## README # @jscad/obj-deserializer > Deserializer for OBJ data to JSCAD geometries [![NPM version](https://badge.fury.io/js/%40jscad%2Fobj-deserializer.svg)](https://www.npmjs.com/package/@jscad/obj-deserializer) [![NPM downloads](https://img.shields.io/npm/dw/@jscad/obj-deserializer)](https://www.npmjs.com/package/@jscad/obj-deserializer) [![Build Status](https://travis-ci.org/jscad/OpenJSCAD.org.svg?branch=master)](https://travis-ci.org/jscad/OpenJSCAD.org) [![Stability](https://img.shields.io/badge/stability-stable-success)](https://github.com/emersion/stability-badges#stable) [![License](https://img.shields.io/github/license/jscad/OpenJSCAD.org)](https://github.com/jscad/OpenJSCAD.org/blob/master/LICENSE) [![User Group](https://img.shields.io/badge/maintained%20by-user%20group-blue)](https://openjscad.nodebb.com/) [![Lerna](https://img.shields.io/badge/maintained%20with-lerna-blue)](https://lerna.js.org/) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-blue)](https://standardjs.com) [![Backers](https://img.shields.io/opencollective/backers/openjscad)](https://opencollective.com/openjscad) [![Sponsors](https://img.shields.io/opencollective/sponsors/openjscad)](https://opencollective.com/openjscad) Open Collective ## Overview This deserializer converts raw OBJ formatted data (files) to JSCAD scripts or geometries. **NOTE: At this time, only ASCII OBJ files are supported. BINARY OBJ files are not supported.** This deserializer converts only what is supported by JSCAD libraries. Full document conversion is NOT supported, so don't even try. However, conversion of the following OBJ commands are possible: | OBJ Command | JSCAD Geometry | Notes | | --------------- | ------------ | ------ | | V | to geom3 | vertices of polygons | | F | to geom3 | indexes to polygon vertices | | G | to geom3 | grouping of V and F to create polygons and geometry | Also, if the 'USEMTL' (material) matches the name of a CSS3 color then the color is applied to the geometry. ## Table of Contents - [Installation](#installation) - [Usage](#usage) - [Contributing](#contributing) - [License](#license) ## Installation ``` npm install @jscad/obj-deserializer ``` ## Usage ```javascript const objDeserializer = require('@jscad/obj-deserializer') const rawData = fs.readFileSync('PATH/TO/file.obj') const geometries = objDeserializer.deserialize({output: 'geometry'}, rawData.toString()) ``` ## Contributing The various JSCAD packages and all source code are part of the JSCAD Organization, and maintained by a group of volunteers. We welcome and encourage anyone to pitch in but please take a moment to read the following guidelines. * If you want to submit a bug report please make sure to follow the [Reporting Issues](https://github.com/jscad/OpenJSCAD.org/wiki/Reporting-Issues) guide. Bug reports are accepted as [Issues](https://github.com/jscad/OpenJSCAD.org/issues/) via GitHub. * If you want to submit a change or a patch, please read the [Contributing Guide](../../CONTRIBUTING.md). New contributions are accepted as [Pull Requests](https://github.com/jscad/OpenJSCAD.org/pulls/) via GitHub. * We only accept bug reports and pull requests on **GitHub**. * If you have a question about how to use JSCAD, then please start a conversation at the [JSCAD User Group](https://openjscad.xyz/forum.html). You might find the answer in the [JSCAD User Guide](https://openjscad.xyz/guide.html). * If you have a change or new feature in mind, please start a conversation with the [Core Developers](https://openjscad.xyz/forum.html) and start contributing changes. Small Note: If editing this README, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification. ## License [The MIT License (MIT)](../../LICENSE) (unless specified otherwise) --- _Source: https://npm.io/package/@jscad/obj-deserializer · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._