sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (2714B)


      1 taggrid
      2 =======
      3 
      4 Description
      5 -----------
      6 This patch adds an ability to place tags in rows like in many other
      7 window managers like xfce ore OpenBox.
      8 
      9 Applying
     10 --------
     11 Patch uses drawtagmask flagset to show tags. Two flags can be applied to it:
     12 
     13   	#define DRAWCLASSICTAGS             1 << 0
     14  
     15 this will make patch to draw classic tags row;
     16 
     17   	#define DRAWTAGGRID                 1 << 1`
     18   
     19 this will make patch to draw the grid of tags like this:
     20 
     21 ![grid](taggrid.png)
     22 
     23 The patch defines `switchtag` function which handle global shortcuts to
     24 navigate in grid. This function accept unsigned int argument which represents
     25 flagset of next flags:
     26 
     27   	#define SWITCHTAG_UP                1 << 0
     28   	#define SWITCHTAG_DOWN              1 << 1
     29   	#define SWITCHTAG_LEFT              1 << 2
     30   	#define SWITCHTAG_RIGHT             1 << 3
     31 this four defines the direction of moving current tags;
     32 
     33   	#define SWITCHTAG_TOGGLETAG         1 << 4
     34   	#define SWITCHTAG_TAG               1 << 5
     35   	#define SWITCHTAG_VIEW              1 << 6
     36   	#define SWITCHTAG_TOGGLEVIEW        1 << 7
     37 
     38 this four defines the behaviour of switching. They will make `switchtag` work
     39 like according functions.
     40 
     41 Example
     42 -------
     43 Default config file defines nest:
     44 
     45 	{ MODKEY|ControlMask,           XK_Up,     switchtag,      { .ui = SWITCHTAG_UP     | SWITCHTAG_VIEW } },
     46 	{ MODKEY|ControlMask,           XK_Down,   switchtag,      { .ui = SWITCHTAG_DOWN   | SWITCHTAG_VIEW } },
     47 	{ MODKEY|ControlMask,           XK_Right,  switchtag,      { .ui = SWITCHTAG_RIGHT  | SWITCHTAG_VIEW } },
     48 	{ MODKEY|ControlMask,           XK_Left,   switchtag,      { .ui = SWITCHTAG_LEFT   | SWITCHTAG_VIEW } },
     49 
     50 this will simply move set of active tags in specified (`UP`, `DOWN`, `RIGHT` or `LEFT`) direction by pressing `ctrl+alt+ARROW`;
     51 
     52 	{ MODKEY|Mod4Mask,              XK_Up,     switchtag,      { .ui = SWITCHTAG_UP     | SWITCHTAG_TAG | SWITCHTAG_VIEW } },
     53 	{ MODKEY|Mod4Mask,              XK_Down,   switchtag,      { .ui = SWITCHTAG_DOWN   | SWITCHTAG_TAG | SWITCHTAG_VIEW } },
     54 	{ MODKEY|Mod4Mask,              XK_Right,  switchtag,      { .ui = SWITCHTAG_RIGHT  | SWITCHTAG_TAG | SWITCHTAG_VIEW } },
     55 	{ MODKEY|Mod4Mask,              XK_Left,   switchtag,      { .ui = SWITCHTAG_LEFT   | SWITCHTAG_TAG | SWITCHTAG_VIEW } },
     56 
     57 this will move active window in specified direction and perform the action, described above.
     58 
     59 Download
     60 --------
     61 * [dwm-6.1-taggrid.diff](dwm-6.1-taggrid.diff) (2014-02-16)
     62 * [dwm-6.2-taggrid.diff](dwm-6.2-taggrid.diff) (2019-08-13)
     63 
     64 Author
     65 ------
     66 * Yury Shvedov - [shved AT lvk DOT cs DOT msu DOT su](mailto:shved@lvk.cs.msu.su) (or [mestofel13 AT gmail DOT com](mailto:mestofel13@gmail.com)).
     67 * Miles Alan - m@milesalan.com (6.2 port)