External Opener

Work in Progress

This guide is under development. Check back soon!

Overview

Hermes provides cross-platform methods to open URLs in the default browser, open files in their default applications, and reveal files in the native file manager.

Quick Reference

// Open a URL in the default browser
HermesApplication.OpenUrl("https://example.com");

// Open a file in its default application
HermesApplication.OpenFile("/path/to/document.pdf");

// Open a directory in the file manager
HermesApplication.OpenFile("/path/to/folder");

// Reveal a file in the file manager (Explorer, Finder, etc.)
HermesApplication.RevealInFileManager("/path/to/file.txt");

API

OpenUrl(string url)

Opens a URL in the default browser. Only http:// and https:// schemes are allowed.

HermesApplication.OpenUrl("https://docs.mythetech.com");

Throws ArgumentException if the URL uses a disallowed scheme.

OpenFile(string path)

Opens a file in its default application, or a directory in the native file manager.

HermesApplication.OpenFile("/path/to/image.png");   // Opens in image viewer
HermesApplication.OpenFile("/path/to/folder");        // Opens in Finder/Explorer

Throws FileNotFoundException if the path does not exist.

RevealInFileManager(string path)

Reveals a file or directory in the platform's native file manager.

HermesApplication.RevealInFileManager("/path/to/file.txt");

Platform	File Behavior	Directory Behavior
Windows	Opens Explorer with file selected	Opens Explorer to directory
macOS	Opens Finder with file selected	Opens Finder to directory
Linux	Opens parent directory (no file selection)	Opens directory

Coming Soon

• Custom URL scheme support
• Mailto support