index.md - sites - public wiki contents of suckless.org
 (HTM) git clone git://git.suckless.org/sites
 (DIR) Log
 (DIR) Files
 (DIR) Refs
       ---
       index.md (1332B)
       ---
            1 cropwindows
            2 ===========
            3 
            4 Description
            5 -----------
            6 Create cropped views of existing windows to display only part of them,
            7 typically to reclaim screen space from badly framed videos or programs and
            8 websites with terrible designs.
            9 
           10 Usage
           11 -----
           12 Look at the changes made to `config.def.h`: pass `1` to `resizemouse` to create
           13 a cropped window and to `movemouse` to move the underlying window in the crop.
           14 
           15         { ClkClientWin, MODKEY|ShiftMask, Button1, movemouse,   {.i = 1} },
           16         { ClkClientWin, MODKEY|ShiftMask, Button3, resizemouse, {.i = 1} },
           17 
           18 Cropped windows are always in the floating state, use `togglefloating`
           19 (`mod-shift-space` by default) to uncrop and restore the underlying window to
           20 its original size and state.
           21 
           22 Download
           23 --------
           24 * [dwm-cropwindows-20170709-ceac8c9.diff](dwm-cropwindows-20170709-ceac8c9.diff)
           25 
           26 Notes
           27 -----
           28 * tested with a limited set of clients and use-cases, some X11 events are
           29   probably not passed or handled correctly, report bugs if you see any,
           30 * known bug: if you crop a window at the same time another window is unmapped,
           31   there is a chance that dwm will lose control of the window you are cropping
           32   and your only option will be to kill it (this is a pain to fix properly),
           33 * improvements: investigate `xextproto/shape` for non-rectangular crops!
           34 
           35 Authors
           36 -------
           37 * Ivan Delalande <colona@ycc.fr>