What is the OGMO file format?
A file with the .ogmo extension is the project file created by OGMO Editor 3, a free, open-source level editor aimed at indie 2D game developers. It is stored as plain JSON, so it is readable and editable in any text editor.
The .ogmo file describes the project rather than the levels themselves. Inside you will find the project name, the OGMO version that created it, editor settings, default level dimensions, and the definitions of every layer, entity, and tileset the project uses. OGMO supports four layer kinds: Tile, Decal, Entity, and Grid. The project file also stores a levelPaths list that records which folders hold the project's level files.
The levels you actually draw are saved separately as .json files. A game reads the .ogmo project to understand the format, then loads those level files at runtime. OGMO Editor 3 was created by Maddy Thorson and contributors, is licensed under the permissive MIT license, and runs on Windows, macOS, and Linux.
Security & safety
RISK: LOWAn .ogmo file is plain JSON text with no executable code, macros, or embedded binaries, so opening it cannot by itself harm your system. The only real caution is that it points to level files by path and describes a game project, not that it carries any payload.
Format details
in a nutshellPrograms that open OGMO files
Windows3 apps
OGMO Editor 3
Open-source Open the .ogmo file with File > Open Project to load the project and edit its layers, entities, and tilesets. 
Visual Studio Code
Free Open the .ogmo file to read and hand-edit its JSON structure with syntax highlighting. 
macOS2 apps
OGMO Editor 3
Open-source Open the .ogmo project to edit its layer, entity, and tileset definitions. 
Linux2 apps
Any JSON viewer / text editor
Free Paste the .ogmo file contents into an online JSON viewer to inspect the project structure. Technical details
deep spec| Encoding | UTF-8 |
| Byte order | N/A (text) |
| Container | JSON object |
| Typical size | A few kilobytes to tens of kilobytes |
| Structure | A single top-level JSON object holding the project name, the OGMO version that created it, editor and level-size settings, and arrays of layer definitions, entity templates, and tileset definitions. A levelPaths array records the folders where the project's level files live. |
| Platforms | Windows, macOS, Linux |
| Notes | The .ogmo file is the project definition only. Actual level data is saved separately as .json files whose paths are listed in levelPaths. Older OGMO Editor releases used different project extensions (.oep for combined XML/JSON projects, and the now-removed .jogmo). OGMO Editor 3 is built with Haxe and OpenFL. |
| Layer Types | Tile, Decal, Entity, and Grid layers |
| Human Readable | Yes |
| Released | 2018 |
| Latest version | OGMO Editor 3.4 |
| Specification | ogmo-editor-3.github.io |
OGMO conversions
Community Q&A
asked by usersNo questions yet - be the first to ask about OGMO files.
