.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
- 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.
- OpenCSM/ESP workflow: load the .csm using an OpenCSM/ESP tool or application that supports OpenCSM scripts (the OpenCSM API supports loading via ocsmLoad).
- 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).
Mac
- Open the file in a text editor (e.g., TextEdit in plain-text mode) to check whether it is readable OpenCSM/ESP script text.
- If it is an OpenCSM/ESP script, open/load it with your OpenCSM/ESP environment or toolchain that supports .csm scripts.
- 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.
Linux
- Open the .csm in a text editor (e.g., gedit, Kate, Vim) to confirm whether it is plain ASCII OpenCSM/ESP script text.
- For OpenCSM/ESP files, load the .csm from an OpenCSM/ESP-capable environment (OpenCSM provides load/save support for .csm via its API).
- 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.
iOS
- 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.
Android
- 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.
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.
Avast offers free and premium antivirus software that protects against viruses, malware, ransomware, and phishing. Scan files before opening them to ensure safety.
NortonNorton 360 delivers comprehensive antivirus protection, VPN, and identity theft monitoring. Scan files for threats before opening to keep your device secure.
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
- Confirm the file’s origin (ESP/OpenCSM vs motion/animation pipeline) and open it in a plain-text editor to test readability.
- If it is not readable text, try importing it in the application/workflow that produced it (e.g., Character Studio marker import pipeline).
- If the source should be OpenCSM/ESP, re-download or re-export the file to rule out corruption or incorrect transfer mode.
OS-specific troubleshooting
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.
- Engineering Sketch Pad (ESP) Training Session 4: CSM Language (PDF)
- OpenCSM: An Open-Source Constructive Solid (AIAA paper) (PDF)
- freedesktop.org Bugzilla: Chemical MIME-types database extension (chemical/x-csml for .csm/.csml)
- Chemical file format (Wikipedia) – Chemical Style Markup Language mapping
- List of motion and gesture file formats (Wikipedia) – CSM used by Character Studio marker data
- Debian Sources: mime.types entry mapping chemical/x-csml to csml and csm
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.
- Confirm the file’s origin (ESP/OpenCSM vs motion/animation pipeline) and open it in a plain-text editor to test readability.
- If it is not readable text, try importing it in the application/workflow that produced it (e.g., Character Studio marker import pipeline).
- 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.
- Open it with a text editor first; OpenCSM/ESP scripts should be readable ASCII statements.
- If it is an OpenCSM/ESP script, use an OpenCSM/ESP-capable toolchain to load it (OpenCSM supports reading .csm via ocsmLoad).
- 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.
- 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.
- If your desktop environment mis-associates the file, manually choose the correct application based on the producing workflow.
- 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.