OpenSCAD User Manual/Using an external Editor with OpenSCAD
Why use an external editor[edit | edit source]
Many people prefer to use a certain editor. They are used to the feature set and know the keybindings. OpenSCADs editor is functional and simple but might lack features people know from other editors. Moreover, external editor allows to use different monitors for editing and preview.
How to use an external editor[edit | edit source]
OpenSCAD is able to check for changes of files and automatically recompile if a file change occurs. To use this feature enable "Design->Automatic Reload and Preview"
Once the feature is activated, just load the scad file within OpenSCAD as usual ("File->Open.."). After that, open the scad file in your favorite editor too. Edit and work on the scad file within the external editor. Whenever the file is saved to disk (from within the external editor), OpenSCAD recognizes the file change and automatically recompiles accordingly.
The internal editor can be hidden by minimizing the frame with the mouse or by selecting "View->Hide editor".
Support of external editors[edit | edit source]
In principle all editors can be used. Some even have extensions/modes to provide features for OpenSCAD.
- Atom: There is a Language OpenSCAD package for Atom that provides highlighting and snippets.
- Emacs: OpenSCAD provides an emacs mode for OpenSCAD files. Use the link or install via emacs package management (ELPA) with the MELPA repository.
- Geany: cobra18t provides a Geany syntax file for OpenSCAD. See Instructions tab in Thingiverse to install it.
- Gedit: Andy Turner provides a Gedit syntax file for OpenSCAD.
- IntelliJ: has an 'OpenSCAD Language Support' plugin.
- Kate: nerd256 provides a kate syntax file for OpenSCAD. See Instructions tab in Thingiverse to install it. You could create also a kate External tool to open OpenSCAD with the current file with script
- Notepad++: TheHeadlessSourceMan provides a Notepad++ syntax file for OpenSCAD. See Instructions tab in Thingiverse to install it.
- OpenSCADitor: OpenSCAD-dedicated editor
- Sublime: Syntax highlighting and Customizer support
- Textmate: Syntax highlighting and Customizer support
- VIM: vim.org provides a VIM syntax file for OpenSCAD.
- Visual Studio Code: Free, open-source code editor Install the scad extension for syntax highlighting
Additional benefits[edit | edit source]
Besides using your editor of choice, these solutions enable the flexible usage of multi-monitor set-ups. One can have one monitor set up to depict the 3D object on the entire screen and a second monitor for the editor and other tools.