open-external

Open files and directories in external programs. Useful for files that cannot be viewed in Pulsar or require specialized applications.

Features

External open: Launch files with system default programs.
Show in folder: Reveal files in system file manager.
Service: Register custom handlers for file types.

Installation

To install open-external search for open-external in the Install pane of the Pulsar settings or run ppm install open-external. Alternatively, you can run ppm install asiloisad/pulsar-open-external to install a package directly from the GitHub repository.

Commands

Commands available in atom-workspace:

open-external:toggle: Alt+U quick switch.

Commands available in atom-text-editor:not([mini]), .image-view, .image-editor, .pdf-viewer:

open-external:open: Alt+F12 open active file in external program,
open-external:show: Ctrl+F12 show active file in file manager.

Commands available in .tree-view:

open-external:toggle: E quick switch.
open-external:open: Alt+F12 open selected items in external programs,
open-external:show: Ctrl+F12 show selected items in file manager.

Provided Service `open-external`

Allows other packages to register custom handlers for opening files externally. This enables packages to override the default file opening behavior for specific file types, implement custom file viewers or launchers, and integrate with specialized applications.

In your package.json:

{
  "consumedServices": {
    "open-external": {
      "versions": {
        "^1.0.0": "consumeOpenExternalService"
      }
    }
  }
}

In your main module:

module.exports = {
  consumeOpenExternalService(service) {
    return service.registerHandler({
      priority: 10,

      openExternal(filePath) {
        if (!filePath.endsWith('.myext')) return null;
        // Custom opening logic
        console.log('Opening', filePath);
        return true;
      }
    });
  }
}

registerHandler(handler): registers a custom handler for file operations. Returns a Disposable. Handler properties: priority (required, higher = called first), openExternal(filePath) (optional, return null to pass to next handler), showInFolder(filePath) (optional, return null to pass to next handler).
openExternal(filePath): opens a file externally, passing through registered handlers.
showInFolder(filePath): shows a file in the system file manager, passing through registered handlers.

Contributing