.CSM file extension

To open .CSM files on Windows, identify the source: if it came from ESP/OpenCSM, open it in a text editor (e.g., Notepad) to confirm it is readable ASCII statements.

To open a .CSM file, first confirm which workflow created it: OpenCSM/ESP .csm files open as editable ASCII text and are loaded by OpenCSM/ESP tools, while Character Studio .csm files are imported into motion/animation tools that support that format. If you are unsure, open it in a text editor first—OpenCSM/ESP .csm files are readable text.

Last updated: April 30, 2026 · Reviewed by Julian Stricker

Open on your device

Choose your operating system for a dedicated step-by-step opening guide.

How to open .CSM files

Use these platform-specific instructions to open .CSM files safely.

Windows

  1. Identify the source: if it came from ESP/OpenCSM, open it in a text editor (e.g., Notepad) to confirm it is readable ASCII statements.
  2. OpenCSM/ESP workflow: load the .csm using an OpenCSM/ESP tool or application that supports OpenCSM scripts (the OpenCSM API supports loading via ocsmLoad).
  3. Character Studio workflow: import the .csm in the Character Studio/3ds Max workflow that expects optical tracking marker data (use the same pipeline that produced the file).
Full Windows guide

Mac

  1. Open the file in a text editor (e.g., TextEdit in plain-text mode) to check whether it is readable OpenCSM/ESP script text.
  2. If it is an OpenCSM/ESP script, open/load it with your OpenCSM/ESP environment or toolchain that supports .csm scripts.
  3. If it appears to be motion/marker data from a Character Studio workflow, transfer it to the workstation/app used in that pipeline and import it there.
Full Mac guide

Linux

  1. Open the .csm in a text editor (e.g., gedit, Kate, Vim) to confirm whether it is plain ASCII OpenCSM/ESP script text.
  2. For OpenCSM/ESP files, load the .csm from an OpenCSM/ESP-capable environment (OpenCSM provides load/save support for .csm via its API).
  3. If it is not readable text and you suspect a Character Studio marker file, move it to the animation workstation that supports that import workflow.
Full Linux guide

iOS

  1. Use the Files app to open the .csm in a text viewer/editor to see if it is readable script text; for actual use (loading into OpenCSM/ESP or importing marker data), you will typically need to transfer it to a desktop workflow.
Full iOS guide

Android

  1. Open the .csm in a text editor app to check whether it is readable OpenCSM/ESP script text; for full use, transfer it to a desktop OpenCSM/ESP or animation pipeline tool that supports the specific .csm variant.
Full Android guide

Security notes

  • Treat .CSM files as untrusted input when they come from outside your organization: OpenCSM/ESP .csm files are scripts/configurations that may drive complex geometry operations in the parser and toolchain, so only load them in trusted modeling environments.
  • Because .csm is ambiguous, verify the file’s origin before opening: motion/marker data and modeling scripts can be handled by different applications, and opening in the wrong tool can lead to confusing prompts or import errors.
  • Prefer opening unknown .csm files in a plain-text viewer first; OpenCSM/ESP .csm files should be readable ASCII text, which helps detect unexpected binary content or incorrect file type.

Recommended antivirus software

Scan files before opening them. These antivirus tools help protect against malware and viruses.

We may earn a commission when you use affiliate links. This supports our free file extension guides.

Can't open this file?

These are the most common causes and fixes when .CSM files fail to open.

Common reasons

  • The .CSM file opens as unreadable characters
  • No application recognizes the .CSM extension
  • The file has .CSM but appears to be chemistry-related

Fix steps

  1. Confirm the file’s origin (ESP/OpenCSM vs motion/animation pipeline) and open it in a plain-text editor to test readability.
  2. If it is not readable text, try importing it in the application/workflow that produced it (e.g., Character Studio marker import pipeline).
  3. If the source should be OpenCSM/ESP, re-download or re-export the file to rule out corruption or incorrect transfer mode.

What is a .CSM file?

In the OpenCSM/ESP context, a .CSM file is a statement-based configuration/script written in the OpenCSM “CSM language” and stored as plain ASCII text. OpenCSM provides API functions to load and save these .csm files (e.g., ocsmLoad and ocsmSave), indicating they are a native, first-class format for that modeling workflow. Separately, some sources use .csm for motion/gesture marker data associated with Character Studio (a 3ds Max plug-in).

Background

In engineering and geometry modeling, .csm is widely documented as the OpenCSM/ESP configuration language file: it is plain ASCII text and consists of statements that define geometry and related parameters. This makes it easy to version-control, diff, and edit by hand, while still being consumable by OpenCSM/ESP tools and APIs.

Common MIME types: chemical/x-csml

Further reading

Authoritative resources for more details on the .CSM format.

Common .CSM issues

The .CSM file opens as unreadable characters

OpenCSM/ESP .csm files are plain ASCII text; if you see mostly gibberish, the file may be a different .csm variant (e.g., motion/marker data) or the file may be corrupted.

  1. Confirm the file’s origin (ESP/OpenCSM vs motion/animation pipeline) and open it in a plain-text editor to test readability.
  2. If it is not readable text, try importing it in the application/workflow that produced it (e.g., Character Studio marker import pipeline).
  3. If the source should be OpenCSM/ESP, re-download or re-export the file to rule out corruption or incorrect transfer mode.

No application recognizes the .CSM extension

Because .csm is used by multiple domains and is not a universally associated desktop format, your OS may not have a default app association.

  1. Open it with a text editor first; OpenCSM/ESP scripts should be readable ASCII statements.
  2. If it is an OpenCSM/ESP script, use an OpenCSM/ESP-capable toolchain to load it (OpenCSM supports reading .csm via ocsmLoad).
  3. If it is from a motion-capture/animation workflow, use the same software pipeline that generated it (Character Studio marker data import).

The file has .CSM but appears to be chemistry-related

Some MIME databases map .csm/.csml to the Chemical Style Markup Language MIME type (chemical/x-csml), which can cause misclassification and incorrect app suggestions.

  1. Do not rely on the OS “type” label alone; inspect the contents in a text editor to determine whether it looks like OpenCSM/ESP statements or something else.
  2. If your desktop environment mis-associates the file, manually choose the correct application based on the producing workflow.
  3. If you manage file associations on Linux desktops, be aware that shared-mime-info entries may map .csm to chemical/x-csml.

FAQ

How can I tell if my .CSM is an OpenCSM/ESP file?

OpenCSM/ESP .csm files are plain ASCII text and contain statement-based commands from the OpenCSM “CSM language.” If it is readable as text and looks like a modeling script, it is likely the OpenCSM/ESP type.

Why does my system label .CSM as a chemical file type (chemical/x-csml)?

Some MIME databases and lists map .csm (and .csml) to the MIME type chemical/x-csml (Chemical Style Markup Language). This can affect file associations even if your .csm is actually an OpenCSM/ESP script or a motion/marker file.

Can I convert a .CSM file by renaming the extension?

No. Renaming does not change the underlying format. Use the exporting/saving features of the software that created it, or load it in the correct tool and export to the desired format if supported.

Are all .CSM files the same format?

No. The extension is used by at least two unrelated domains: OpenCSM/ESP plain-text modeling scripts and Character Studio optical tracking marker data. Always choose software based on the source and intended use.

Similar file extensions

Compare related formats in the same category to find the right tool faster.