# browsers

- Manual
- Standard library
- Index

Search:
Group by:

This module implements a simple proc for opening URLs with the user's default browser.

Unstable API.

# Imports

strutils, os, osproc

# Procs

    proc openDefaultBrowser(url: string) {...}{.raises: [Exception], tags: [ExecIOEffect,
        ReadEnvEffect, RootEffect].}

  opens `url` with the user's default browser. This does not block.

  Under Windows, `ShellExecute` is used. Under Mac OS X the `open` command is used. Under Unix, it is checked if `xdg-open` exists and used if it does. Otherwise the environment variable `BROWSER` is used to determine the default browser to use.

  This proc doesn't raise an exception on error, beware.

  Source Edit