# AppleScript for Visual Studio Code [![The MIT License](https://flat.badgen.net/badge/license/MIT/orange)](http://opensource.org/licenses/MIT) [![GitHub](https://flat.badgen.net/github/release/idleberg/vscode-applescript)](https://github.com/idleberg/vscode-applescript/releases) [![Visual Studio Marketplace](https://vsmarketplacebadge.apphb.com/installs-short/idleberg.applescript.svg?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=idleberg.applescript) [![Travis](https://flat.badgen.net/travis/idleberg/vscode-applescript)](https://travis-ci.org/idleberg/vscode-applescript) [![David](https://flat.badgen.net/david/dev/idleberg/vscode-applescript)](https://david-dm.org/idleberg/vscode-applescript?type=dev) Language syntax, snippets and build system for AppleScript and JavaScript for Automation ![Screenshot](https://raw.githubusercontent.com/idleberg/vscode-applescript/master/images/screenshot.png) *Screenshot of AppleScript in Visual Studio Code with [Hopscotch](https://marketplace.visualstudio.com/items?itemName=idleberg.hopscotch) theme* ## Installation ### Extension Marketplace Click the Extensions icon in the activity bar and search for *idleberg.applescript*. With shell commands installed, you can use the following command to install the extension: ```bash $ code --install-extension idleberg.applescript ``` ### Packaged Extension Download the package extension from the the [release page](https://github.com/idleberg/vscode-applescript/releases) and install it from the command-line: ```bash $ code --install-extension applescript-*.vsix ``` ### Clone Repository Change to your Visual Studio Code extensions directory: ```bash # Windows $ cd %USERPROFILE%\.vscode\extensions # Linux & macOS $ cd ~/.vscode/extensions/ ``` Clone repository as `applescript`: ```bash $ git clone https://github.com/idleberg/vscode-applescript applescript ``` ## Usage ### Building On macOS, you can make use of the following build commands through the [command-palette](https://code.visualstudio.com/docs/editor/codebasics#_command-palette): * AppleScript: Run Script – Shift+Alt+R * AppleScript: Compile Script – Shift+Alt+B * AppleScript: Compile Script bundle * AppleScript: Compile Application * JXA: Run Script – Shift+Alt+R * JXA: Compile Script – Shift+Alt+B * JXA: Compile Script bundle * JXA: Compile Application ### Settings You can tweak the defaults for this package, `osacompile` and `osascript` in the package settings. Setting | Default | Description ---------------------------|----------|------------ `showNotifications` | `true` | Show build notifications indicating success or failure `alwaysShowOutput` | `false` | Specify whether to show the output panel on errors only or on each build `defaultBuildTask` | `script` | Specify the default build task when creating a new task file `osacompile.executeOnly` | `false` | Save the resulting script as execute-only `osacompile.stayOpen` | `false` | Stay open after run handler `osacompile.startupScreen` | `false` | Show startup-screen `osascript.outputStyle` | - | The flags argument is a string consisting of any of the modifier characters `e`, `h`, `o`, and `s` #### File Encoding The default character encoding for AppleScript text files is [Mac Roman](https://www.wikiwand.com/en/Mac_OS_Roman). If you wish to change this, you can do so in the package settings. **Example:** ```json { "[applescript]": { "files.encoding": "utf8" } } ``` ## License This work is licensed under [The MIT License](https://opensource.org/licenses/MIT) ## Donate You are welcome to support this project using [Flattr](https://flattr.com/submit/auto?user_id=idleberg&url=https://github.com/idleberg/vscode-applescript) or Bitcoin `17CXJuPsmhuTzFV2k4RKYwpEHVjskJktRd`