sites

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

index.md (1651B)


      1 autopage
      2 ========
      3 
      4 Description
      5 -----------
      6 The `autopage` patch for dwm adds configurable per-layout client page
      7 capacity with automatic "paging" to overflow clients to the next tag.
      8 Rule-assigned and manually moved clients are protected from autopaging while
      9 empty slots are filled by eligible autopaged clients from the neighboring tag.
     10 
     11 The behavior of `autopage` can be configured in config.def.h
     12 ```
     13     
     14 static const Layout layouts[] = {
     15 	/* symbol     arrange 	page capacity  follow*/
     16 	{ "[T]=",     tile,			0,			0 },    /* unlimited clients per tag */
     17 	{ "[A]=",     tile,			3,			0 },    /* 3 clients allowed per tag */
     18 	{ "[AF]=",    tile,			4,			1 },    /* 4 clients allowed per tag and follow autopagedclients */
     19 	{ "[F]",      NULL,			0,			0 },    /* no layout function means floating behavior */
     20 	{ "[M]",      monocle,		0,			0 },	/* unlimited clients per tag */
     21 };
     22 
     23 ```
     24 The example only shows customization of the tiled layout, but the autopager
     25 is not layout dependent.  It can work on just about any layout except for
     26 "floating" because I wrote it so that floating windows are not autopage
     27 candidates. 
     28 
     29 
     30 As clients are closed, autopaged clients are pulled from subsequent tags to fill
     31 empty slots left by the closed clients. Rule-assigned and manually moved
     32 clients are still protected and will not change position.
     33 
     34 Behavior
     35 --------
     36 
     37 capacity = 3
     38 Tag 1: C1 C2 C3
     39 Tag 2: C4 C5 C6
     40 Tag 3: C7 C8 C9
     41 Tag 4: C10 C11 C12
     42 
     43 (close client 4)
     44 
     45 Tag 1: C1 C2 C3
     46 Tag 2: C5 C6 C7
     47 Tag 3: C8 C9 C10
     48 Tag 4: C11 C12 
     49 
     50 Download
     51 --------
     52 * [dwm-autopage-6.8.diff](dwm-autopage-6.8.diff)
     53   (2026-08-21)
     54 
     55 Author
     56 ------
     57 * [Mike L.](mike868711@gmail.com)
     58 
     59