XDG-OPEN(1)

  .SH "NAME" xdg-open - opens a file or URL in the user's preferred application
  .SH "SYNOPSIS"
    .HP u
      xdg-open
       {
         | file
         | URL
      }

    .HP u
      xdg-open
       {
         | --help
         | --manual
         | --version
      }

  .SH "DESCRIPTION"

    .PP xdg-open opens a file or URL in the user's preferred application. If a URL is provided the URL will be opened in the user's preferred web browser. If a file is provided the file will be opened in the preferred application for files of that type. xdg-open supports file, ftp, http and https URLs.
    .PP xdg-open is for use inside a desktop session only. It is not recommended to use xdg-open as root.

  .SH "OPTIONS"

      .PP --help

          Show command synopsis.

          .RE
          .PP --manual

              Show this manual page.

              .RE
              .PP --version

                      Show the xdg-utils version information.

                  .RE

              .SH "EXIT CODES"

                .PP An exit code of 0 indicates success while a non-zero exit code indicates failure. The following failure codes can be returned:

                  .PP 1

                      Error in command line syntax.

                      .RE
                      .PP 2

                          One of the files passed on the command line did not exist.

                          .RE
                          .PP 3

                              A required tool could not be found.

                              .RE
                              .PP 4

                                  The action failed.

                                  .RE

                              .SH "SEE ALSO"

                                .PP xdg-mime(1), xdg-settings(1), MIME applications associations specification[1]

                              .SH "EXAMPLES"

                                .PP
                                xdg-open 'http://www.freedesktop.org/'

                            Opens the freedesktop.org website in the user's default browser.
                                .PP
                                xdg-open /tmp/foobar.png

                            Opens the PNG image file /tmp/foobar.png in the user's default image viewing application.

AUTHORS

Kevin Krammer
    Author.

Jeremy White
    Author.

COPYRIGHT
Copyright © 2006

NOTES

1.  MIME applications associations specification
    http://www.freedesktop.org/wiki/Specifications/mime-apps-spec/