File: README

package info (click to toggle)
dragbox 0.4.0-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, lenny, squeeze, wheezy
  • size: 448 kB
  • ctags: 196
  • sloc: python: 1,088; sh: 709; makefile: 45
file content (82 lines) | stat: -rw-r--r-- 3,076 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
SUMMARY
==============
Use: Drag items from the command line, and more  
Website: http://users.student.lth.se/f04us/wiki/dragbox/  
By Ulrik Sverdrup <ulrik.sverdrup@gmail.com>, released under GPLv2+

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

For detailed command line instructions, please read the included man page.

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

INSTALLATION
==============
Dragbox requires Python v2.4 and the following python modules: pygtk, gtk,
gtk.glade, gnomevfs, gnome, gconf, dbus. On Debian,
installing the packages python-glade2 and python-gnome2 should be enough.

Installation from source is simple, just the usual:

    ./configure
    make
    make install

There might be a problem with finding the way to the installed Python
package. Dragbox uses a script to do some manual searching if needed, and
this should work; if not, investigate the use of PYTHONPATH. There is one
limitation: If you install using DESTDIR, --bindir has to be "inside"
--prefix, otherwise Dragbox won't find the way to its .glade datafiles.

MAINTAINERS
==============
Gitweb: http://repo.or.cz/w/dragbox.git

To build dragbox from a git checkout

     ./autogen.sh
     # then use ./configure and make etc as ususal

To build the distributable source tarball from a clean checkout:

     ./autogen.sh; ./configure; make distcheck

CREDITS
==============
Dragbox is licensed under the GNU GPL version 2 (or later)  
See http://www.gnu.org/copyleft/gpl.html

By Ulrik Sverdrup 2006-2008  
ulrik.sverdrup@gmail.com  
http://users.student.lth.se/f04us/
(old: http://www.student.lu.se/~cif04usv/ )

 vim: tw=76 ft=mkd