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.
A relatively recent benefit is that many of the more powerful external editors can act as a client for an OpenSCAD language server, permitting IDE-style functionality such as inline error/warning displays, module/function documentation on hover, jump to module/function definition, find module/function references, code reformatting, etc. There are a handful of OpenSCAD language servers in various levels of development, currently the openscad-lsp language server provides the most features.
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
scad-modevia 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
- Neovim: An example configuration including basic linting and formatting is available via OpenSCAD in Neovim
- Notepad++: TheHeadlessSourceMan provides a Notepad++ syntax file for OpenSCAD. See Instructions tab in Thingiverse to install it.
- OpenSCADitor: OpenSCAD-dedicated editor
- Pulsar: Pulsar has the language-openscad package to provide highlighting and snippets.
- 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 "OpenSCAD-Language-Support" extension for auto-completion, highlighting and more language support
- VSCodium: (vscodium.com freely-licensed OSS distribution) has OpenSCAD extensions. Type "OpenSCAD" into the View > Extensions panel search box to find and install.
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.