Skip to content

An example shelljs-plugin to open a file with its default application

License

Notifications You must be signed in to change notification settings

shelljs/plugin-open

Repository files navigation

shelljs-plugin-open

GitHub Actions npm shelljs-plugin

A ShellJS plugin for the open() command to open a file (or URL) with its default application. This is largely based on opener.

This is designed to imitate the open command on macOS. Here's the equivalent commands for other systems:

  • macOS

    $ open file.txt # opens in a text editor
  • Linux

    $ xdg-open file.txt # opens in a text editor
  • Windows

    > start file.txt
    

Installation

$ npm install --save shelljs
$ npm install --save shelljs-plugin-open

Usage

ShellJS unofficially has the capacity for plugins (the API is likely to change a bit) since v0.7.1. Although we don't recommend developing for this yet, this plugin is designed to test that API, and we will adapt it along with changes to ShellJS up until official plugin support. To use this plugin, you must use exactly version v0.7.1 (although, eventually this will support v1.0.0+).

To use this plugin in your project, include it like so:

var shell = require('shelljs');
require('shelljs-plugin-open');

// Ex. usage:
shell.open('file.txt'); // the plugin is now available!

Supported systems

  • Linux (all variants)
  • macOS
  • Windows

This is supported for Node v0.11+

Writing plugins

If you're interested in taking a look at the current state of the plugin API, take a look at index.js. This has helpful comments explaining the necessary boilerplate for writing a plugin. For an example usage of the plugin, take a look at test/test.js.

About

An example shelljs-plugin to open a file with its default application

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published