.TH "dragbox" "1" "" "" ""
.SH "NAME"
dragbox \- Command line drag-and-drop tool for Gnome.
.SH "SYNOPSIS"
\fBdragbox\fR [\-naxpu0] [\-\-get | \-\-list] [\-\-name id] [item ...]
.SH "DESCRIPTION"
Dragbox is a tool for connecting the command line with the desktop
environment. It summons a drag handle in a window when you are managing
files or text in the shell, connecting the different workspaces -- desktop
and command line.

Dragbox can take items on the command line or from a pipe and put on its
shelf. The inverse is also possible: dragged-to items can be output to the
shell. It is possible to have more than one instance running, and put items
on or get items from any of them.

Right-click in the window to open a context menu or access the preferences
window. Clicking an item copies it to the clipboard (files can be opened as
an option).
.SH "OPTIONS"
.TP 
\fB\-f, \-\-file\fR  \fIfile\fR
Add \fIfile\fR to the dragbox and report an error if it does not exist.
.TP 
\fB\-t, \-\-text\fR  \fI"snippet"\fR
Add \fIsnippet\fR to the dragbox as text. This is needed explicitly if you
want to treat an existing path as text.
.TP 
\fB\-n, \-\-no\-fork\fR
Do not fork after launch. This implies \-\-write\-on\-exit. The program will
not be able to communicate with other instances of itself.
.TP
\fB\-\-get\fR
Query a running instance for its contents, output and exit. This respects
settings affecting output format. Note that \-\-get takes no arguments; use
\-\-name to specify which shelf to get.
.TP
\fB\-m, \-\-name\fR  \fIname\fR
Use shelf identifier \fIname\fR. This can be used to have multiple dragboxes
(shelves) available.
.TP
\fB\-\-list\fR
List running instances.
.TP
\fB\-\-window\-title\fR  \fItitle\fR
Set window title to \fItitle\fR. This will only have effect when the window is
first created.
.TP 
Output settings
.TP
\fB\-a, \-\-write\-async\fR
Output dragged-to items to standard output as they are received.
.TP
\fB\-x, \-\-write\-on\-exit\fR
Output contents of the dragbox to standard output at exit.
.TP
\fB\-p, \-\-paths\fR
Use absolute paths when outputing files. This is default.
.TP
\fB\-u, \-\-uris\fR
Use URIs when outputing files.
.TP
\fB\-0, \-\-null\-terminate\fR
Separate dragged-in items' output with \\0, not \\n. This is useful together
with \fBxargs \-0\fR
.TP
The following are generic options
.TP 
\fB\-h, \-\-help\fR
Displays usage information and exits.
.TP 
\fB\-v, \-\-version\fR
Displays version information and exits.

.SH "EXAMPLES"
.TP
\fBdragbox\fR . file1.txt
Adds the current directory and file1.txt to the currently running dragbox,
or creates a new one. If file1.txt does not exist, its name is added as
text.
.TP
\fBdragbox \-t\fR "Dragbox is cool"
Adds a text snippet to the currently running dragbox, or creates a new one.
.TP
\fBdragbox \-\-get \-0 | xargs \-0 tar cfz\fR backup.tar.gz
Get current items and pipe to xargs to create a tarball. Note that this
simple command will have problems if contents include text items.
.TP
\fBdragbox \-\-name\fR remember .
Put the current directory on a shelf called "remember"

.SH "TIPS AND TRICKS"
Dragging in gnome works very well, but there are some hidden tricks that can
make some things easier.

Pressing modifier keys can switch between different types of drags; dragging
a file to nautilus normally copies it, but you can hold shift to move it, or
shift-ctrl to make a symlink.

You can drag from any window without activating it by holding the altgr or
super key when you drag. This is often very useful.

You can bring up a minimized or obscured window while dragging by hovering
momentarily over it's button in the window list (in the gnome-panel)

Just like minimized windows, you can switch workspaces while dragging if you
hover over the workspaces switcher for a short while.

If you selected something in a window and focus another window, it looks
like the selection disappeared. In many cases it's still there, you can try
to drag it without focusing the window (see above)

Type escape while dragging to cancel the drag

.SH "ACCESSING DRAGBOX"
Dragbox needs an X session to run and display its shelves.  However, to access
dragbox shelves from non-graphical sessions, all you need is to make sure
dragbox knows which X session to connect to. It might be enough to define the
DISPLAY variable.

.SH "AUTHOR"
dragbox was written by  Ulrik Sverdrup <ulrik.sverdrup@gmail.com>