XDG-FILE-DIALOG(1)

NAME
xdg-file-dialog - command line tool for providing file and directory selection dialogs

SYNOPSIS

xdg-file-dialog openfilename [--title TITLE] [FILENAME]

xdg-file-dialog openfilenamelist [--title TITLE] [FILENAME]

xdg-file-dialog savefilename [--title TITLE] [FILENAME]

xdg-file-dialog directory [--title TITLE] [DIRNAME]

xdg-file-dialog {--help | --manual | --version}

DESCRIPTION

The xdg-file-dialog program can be used to let the native file selection dialog handle file and directory input.

xdg-file-dialog is for use inside a desktop session only. It is not recommended to use xdg-file-dialog as root.

COMMANDS

openfilename
    Returns the filename with path for a file to read from. FILENAME can optionally be used to specify path and filename of a preselection.

openfilenamelist
    Returns one or more filenames with path for files to read from, each on a new line. FILENAME can optionally be used to specify path and filename of a preselection.

savefilename
    Returns the filename with path for file to write to. FILENAME can optionally be used to specify path and filename of a preselection.

directory
    Returns the path for an exsiting directory. DIRNAME can optionally be used to specify a path of a preselection.

OPTIONS

--title TITLE
    Sets the dialog's title (caption) to the specified text.

--help
    Show command synopsis.

--manual
    Show this manualpage.

--version
    Show the xdg-utils version information.

EXIT CODES

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

1   Error in command line syntax.

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

3   A required tool could not be found.

4   The action failed.

EXAMPLES

xdg-file-dialog savefilename /tmp/foobar.png
 Asks for a save file name starting in directory /tmp and suggesting foobar.png as the filename

xdg-file-dialog directory --title "Select a target folder" /tmp
 Asks for a directory name starting in directory /tmp using the text "Select a target folder" as the dialog's title/caption.

AUTHOR
Kevin Krammer.