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