dungeon

Autohide top-edge drag-and-drop source for X11. Inspired by dragon, but renders as a thin list of files at the top of the screen that hides itself with only a 2px highlighted sliver visible. Move the pointer to the top edge to reveal it; drag any row out to drop the entire file list elsewhere.

Source-only — dungeon does not act as a drop target.

Why

dragon works well but its window competes with everything else on screen. dungeon solves that by being almost invisible until you need it: a single coloured pixel-line at the very top of the screen marks where to hover.

Build

make
make install              # installs to ~/.local/bin
make PREFIX=/usr/local install

Requires GTK+ 3 and Xlib.

Usage

dungeon FILE [FILE ...]
ls *.pdf | dungeon -I

Options:

flag	meaning
-I, --stdin	read filenames from stdin (one per line)
-k, --keep	stay open after a drop (default: exit)
-v, --verbose	log to stderr
-h, --help	show help

Controls: hover top edge to reveal, drag any row to drag all entries, middle-click to quit.

Configuration

Optional config at ~/.config/dungeon/config (or $XDG_CONFIG_HOME/dungeon/config). All keys are optional; the example file config.example shows the defaults.

background    = #292b2c
text          = #eeeeec
highlight     = #0074a6
font          = PragmataPro

width         = 380
row_height    = 22
peek_height   = 2
hide_delay_ms = 250

How "always on top" works

dungeon uses a GTK_WINDOW_POPUP toplevel, which is override-redirect on X11. The window manager doesn't manage it, so it cannot stack any other window above it. A 500 ms XRaiseWindow tick keeps dungeon above other override-redirect surfaces (popups, menus, tooltips).

This is X11-only.

License

MIT — see LICENSE.