# Atomizr for Sublime Text
[](http://opensource.org/licenses/MIT)
[](https://github.com/idleberg/sublime-atomizr/releases)
[](https://packagecontrol.io/packages/Atomizr)
[](https://circleci.com/gh/idleberg/sublime-atomizr)
Convert Sublime Text completions into Atom (or Visual Studio Code) snippets, and vice versa.
Also available for [Atom](https://github.com/idleberg/atom-atomizr) and the [command line](https://github.com/idleberg/node-atomizr) (see the [comparison chart](https://gist.github.com/idleberg/db6833ee026d2cd7c043bba36733b701)).
## Installation
### Package Control
1. Make sure you already have [Package Control](https://packagecontrol.io/) installed
2. Choose *“Install Package”* from the Command Palette (Super+Shift+p)
3. Type *“Atomizr”* and press Enter
4. Repeat steps 2 and 3 to install *“Better CoffeeScript”*
With [auto_upgrade](http://wbond.net/sublime_packages/package_control/settings/) enabled, Package Control will keep all installed packages up-to-date!
### Manual installation
Since [package dependencies](https://packagecontrol.io/docs/dependencies) are handled by Package Control, manual installation is not advised! If you still want to install from source, you probably know what you are doing so we won’t cover that here.
## Usage
The [Command Palette](http://docs.sublimetext.info/en/latest/reference/command_palette.html) currently offers the following commands, each prefixed with “Atomizr”:
Action | Input | Output
-------------------------------------------|-------------------|----------------
Automatic conversion¹ | `CSON\|JSON\|XML` | `CSON\|JSON\|XML`
Convert Atom to Sublime Text | `CSON\|JSON` | `JSON`
Convert Atom to Visual Studio Code | `CSON\|JSON` | `JSON`
Convert Sublime Text to Atom² | `JSON\|XML` | `CSON\|JSON`
Convert Sublime Text to Visual Studio Code | `JSON\|XML` | `JSON`
Convert Visual Studio Code to Atom² | `JSON` | `CSON\|JSON`
Convert Visual Studio Code to Sublime Text | `JSON` | `JSON`
Toggle Atom format | `CSON\|JSON` | `JSON\|CSON`
Toggle Sublime Text format | `JSON\|XML` | `XML\|JSON`
¹⁾ converts Atom and Sublime Text only
²⁾ target syntax can be specified in the settings
**Note:** Since automatic conversion is based on scope, make sure the a supported CoffeeScript package is installed as well. Using [Better CoffeeScript](https://packagecontrol.io/packages/Better%20CoffeeScript) is recommended, though [CoffeeScript](https://packagecontrol.io/packages/CoffeeScript), [IcedCoffeeScript](https://packagecontrol.io/packages/IcedCoffeeScript) and [Mongoose CoffeeScript](https://packagecontrol.io/packages/Mongoose%20CoffeeScript) are also supported.
### Keyboard Shortcuts
*The following examples use the macOS keyboard shortcuts. On Linux or Windows use Ctrl+Alt as modifier key instead of Ctrl.*
Memorizing the keyboard shortcuts for conversion is easy. Just think of the A key for Atom, the S key for Sublime Text and the V key for Visual Studio Code:
Action | Mnemonic | Shortcut
-----------------------------------|----------|-----------------------------------------------------------
Atom to Sublime Text | “A to S” | Ctrl+A, Ctrl+S
Atom to Visual Studio Code | “A to V” | Ctrl+A, Ctrl+V
Sublime Text to Atom | “S to A” | Ctrl+S, Ctrl+A
Sublime Text to Visual Studio Code | “S to V” | Ctrl+S, Ctrl+V
Visual Studio Code to Atom | “V to A” | Ctrl+V, Ctrl+A
Visual Studio Code to Sublime Text | “V to S” | Ctrl+V, Ctrl+S
Atom to Atom | “A to A” | Ctrl+A, Ctrl+A
Sublime Text to Sublime Text | “S to S” | Ctrl+S, Ctrl+S
For automatic conversion, press Ctrl+C twice.
### Settings
Some of the default conversion settings can be modified from the *Package Settings* menu:
* Rename target files (`boolean`)
* Add or remove trailing tab-stops (`boolean`)
* Indentation level (`int`)
* Sort keys (`boolean`)
* Scope replacement rules (`array`)
* Atom snippet syntax format (`boolean`)
# License
This work is licensed under the [The MIT License](LICENSE).