xenial (1) dragbox.1.gz

Provided by: dragbox_0.4.0-1.1_all bug

NAME

       dragbox - Command line drag-and-drop tool for Gnome.

SYNOPSIS

       dragbox [-naxpu0] [--get | --list] [--name id] [item ...]

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).

OPTIONS

       -f, --file  file
              Add file to the dragbox and report an error if it does not exist.

       -t, --text  "snippet"
              Add snippet to the dragbox as text. This is needed explicitly if you want  to  treat  an  existing
              path as text.

       -n, --no-fork
              Do  not  fork  after  launch.  This  implies  --write-on-exit.  The  program  will  not be able to
              communicate with other instances of itself.

       --get  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.

       -m, --name  name
              Use shelf identifier name. This can be used to have multiple dragboxes (shelves) available.

       --list List running instances.

       --window-title  title
              Set window title to title. This will only have effect when the window is first created.

       Output settings

       -a, --write-async
              Output dragged-to items to standard output as they are received.

       -x, --write-on-exit
              Output contents of the dragbox to standard output at exit.

       -p, --paths
              Use absolute paths when outputing files. This is default.

       -u, --uris
              Use URIs when outputing files.

       -0, --null-terminate
              Separate dragged-in items' output with \0, not \n. This is useful together with xargs -0

       The following are generic options

       -h, --help
              Displays usage information and exits.

       -v, --version
              Displays version information and exits.

EXAMPLES

       dragbox . 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.

       dragbox -t "Dragbox is cool"
              Adds a text snippet to the currently running dragbox, or creates a new one.

       dragbox --get -0 | xargs -0 tar cfz 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.

       dragbox --name remember .
              Put the current directory on a shelf called "remember"

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

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.

AUTHOR

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

                                                                                                      dragbox(1)