| .\" ** You probably do not want to edit this file directly ** |
| .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). |
| .\" Instead of manually editing it, you probably should edit the DocBook XML |
| .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. |
| .TH "XDG\-OPEN" "1" "06/24/2007" "xdg\-utils 1.0" "" |
| .\" disable hyphenation |
| .nh |
| .\" disable justification (adjust text to left margin only) |
| .ad l |
| .SH "NAME" |
| xdg\-open \- opens a file or URL in the user's preferred application |
| .SH "SYNOPSIS" |
| .HP 9 |
| \fBxdg\-open\fR {\fB\fIfile\fR\fR \fB\fIURL\fR\fR} |
| .HP 9 |
| \fBxdg\-open\fR {\fB\-\-help\fR \fB\-\-manual\fR \fB\-\-version\fR} |
| .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" |
| .TP |
| \fB\-\-help\fR |
| Show command synopsis. |
| .TP |
| \fB\-\-manual\fR |
| Show this manualpage. |
| .TP |
| \fB\-\-version\fR |
| Show the xdg\-utils version information. |
| .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: |
| .TP |
| \fB1\fR |
| Error in command line syntax. |
| .TP |
| \fB2\fR |
| One of the files passed on the command line did not exist. |
| .TP |
| \fB3\fR |
| A required tool could not be found. |
| .TP |
| \fB4\fR |
| The action failed. |
| .SH "EXAMPLES" |
| .PP |
| .nf |
| xdg\-open 'http://www.freedesktop.org/' |
| .fi |
| .sp |
| Opens the Freedesktop.org website in the user's default browser |
| .PP |
| .nf |
| xdg\-open /tmp/foobar.png |
| .fi |
| .sp |
| Opens the PNG image file /tmp/foobar.png in the user's default image viewing application. |
| .SH "FILES" |
| .PP |
| \fI/usr/share/applications/defaults.list ~/.local/share/applications\fR |
| .SH "SEE ALSO" |
| .PP |
| \fBxdg-mime\fR(1), |
| .SH "AUTHOR" |
| Kevin Krammer, Jeremy White. |
| .br |
| <kevin.krammer@gmx.at> |
| .br |
| <jwhite@codeweavers.com> |
