Easily execute arbitrary AppleScript code on OS X through NodeJS.
Last updated 8 years ago .
Original npm · Tarball · package.json
$ cnpm install applescript 
SYNC missed versions from official npm registry.


A high-level way to execute AppleScript code through NodeJS, and retrieve the result as a native JavaScript object. Underneath the hood, this module is just a simple wrapper around the OS X osascript command.


AppleScripts are the only way to communicate and interact with certain external OS X processes, for example iTunes.

Easy Install

$ npm install applescript


  • Mac (or Hackintosh) running OS X (tested with Snow Leopard)
  • NodeJS (v0.2.0 or newer)


The node-applescript module provides execString and execFile functions to easily execute AppleScript commands and buffer the output into a calback.

var applescript = require('applescript');

// Very basic AppleScript command. Returns the song name of each
// currently selected track in iTunes as an 'Array' of 'String's.
var script = 'tell application "iTunes" to get name of selection';

applescript.execString(script, function(err, rtn) {
  if (err) {
    // Something went wrong!
  if (Array.isArray(rtn)) {
    rtn.forEach(function(songName) {

execFile works the exact same way, except you pass the path of the AppleScript (*.applescript) file as the first argument instead of the command itself, and you may pass an optional Array of String arguments to send to the applescript file.


The node-applescript module is licensed under the MIT license, of course!

Current Tags

  • 1.0.0                                ...           latest (6 years ago)

4 Versions

  • 1.0.0                                ...           6 years ago
  • 0.2.1                                ...           8 years ago
  • 0.2.0                                ...           8 years ago
  • 0.1.0                                ...           8 years ago
Maintainers (1)
Today 27
This Week 111
This Month 133
Last Day 18
Last Week 175
Last Month 912
Dependencies (0)
Dev Dependencies (0)

Copyright 2014 - 2016 © |