table of contents
other versions
- jessie 0.4.0-1
dragbox(1) | dragbox(1) |
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"