blog4.html (15791B)
1 2 <!DOCTYPE html> 3 <html lang="en"> 4 <head> 5 <meta name="viewport" content="width=device-width, initial-scale=1" /> 6 <meta charset="utf-8" /> 7 <title>DWM - Less is More!</title> 8 <link rel="stylesheet" href="template.css" /> 9 <link rel="alternate" href="atom.xml" type="application/atom+xml" title="Atom Feed" /> 10 <link rel="apple-touch-icon" sizes="180x180" href="../assets/images/apple-touch-icon.png" /> 11 <link rel="icon" type="image/png" sizes="32x32" href="../assets/images/favicon-32x32.png" /> 12 <link rel="icon" type="image/png" sizes="16x16" href="../assets/images/favicon-16x16.png" /> 13 <link rel="manifest" href="../assets/images/site.webmanifest" /> 14 </head> 15 <body> 16 <header> 17 <h1><a href="./">cowmonk's random blogs</a></h1> 18 <nav class="sblg-nav"> 19 <span class="prevnext sblg-prev-has"> 20 <a href="blog5.html"><-newer</a> 21 </span> 22 <span class="prevnext sblg-next-has"> 23 <a href="blog3.html">older-></a> 24 </span> 25 </nav> 26 </header> 27 <section> 28 <h3 style="color:yellow">DWM - Less is More!</h3> 29 <p> 30 <q>A quick guide into THE suckless tiling window manager! Including patching!</q> 31 </p> 32 <p> 33 Published by 34 <span class="name">cowmonk</span> 35 on 36 <time datetime="2025-05-06">2025-05-06</time> 37 </p> 38 <article data-sblg-article="1" data-sblg-tags="guide suckless tutorial"> 39 <header> 40 <h2>DWM - Less is More!</h2> 41 <aside>A quick guide into THE suckless tiling window manager! Including patching!</aside> 42 <address>cowmonk</address> 43 <time datetime="2025-05-06">2025-05-06</time> 44 </header> 45 <p>A lot of people when they move into linux will learn of the magic of tiling window managers. </p> 46 <p>Generally, 47 they are curious, and some find it as a waste of time, others die by it. 48 And people will even wonder why in the hell someone would take the time to configure one of these things.</p> 49 <p>However, I’m not here to debate whether or not it’s a waste of time, or if it’s worth it. I’m here to help out people who have heard of <a href="https://dwm.suckless.org/">dwm</a> and want to try it out. 50 Whether you’ve heard it from a friend, a youtuber, a random, or whomever, people at first find dwm as a scary thing that’s <strong>IMPOSSIBLE</strong> to configure.</p> 51 <p>But fret not! For your neighborhood suckless shill is here to help!</p> 52 <h2 id="prerequisites">Prerequisites</h2> 53 <p>Before you start going ham on the configuring/ricing, this isn’t your average joe i3, Hyprland, or whatever. 54 You’ve probably heard that dwm is a “compile from source” configuration, and this just means that 55 every change you’re going to make has to be compiled all over again.</p> 56 <p>“Woah, woah, woah!” you might be saying. “Compile? Like C code? H4x0r like stuff?”</p> 57 <p>Yep, that’s the ticket! But don’t let it scare you off. It’s simpler than it sounds. Think of it like baking a cake. 58 You have a recipe (<strong>config.h</strong>), you mix your ingredients (the source code and your changes), and then you bake it (<strong>make</strong>). 59 Each time you want a different flavor (a new feature or keybinding), you tweak the recipe and bake it again. 60 You will need to kill dwm and re-run it again since the binary that runs is loaded in memory, it doesn’t change in real time.</p> 61 <p>A common misconception is an over exaggeration on how tedious the reconfiguration is. Whilst it can be a bit annoying, 62 especially in the beginning when you are getting it tailored towards your preferences, it’s definitely overblown. 63 See, once you have a working system, there isn’t a need to keep on configuring onwards, a necessary process I would say.</p> 64 <p>So, what do you actually <em>need</em>?</p> 65 <h1 id="a-c-compiler"><strong>A C Compiler:</strong></h1> 66 <p>Most likely, you’ll want <code>gcc</code>. It’s the most common C compiler everyone gets.</p> 67 <p>If you’re on a Debian-based system (like Mint), you can usually get this and other essential tools by installing <code>build-essential</code>.</p> 68 <div class="terminal-output"> 69 <pre><code class="language-bash">$ sudo apt install build-essential</code></pre> 70 </div> 71 <p>For Arch users (for the “I use Arch btw” furries):</p> 72 <div class="terminal-output"> 73 <pre><code class="language-bash">$ sudo pacman -S base-devel</code></pre> 74 </div> 75 <p>And for Fedora folks:</p> 76 <div class="terminal-output"> 77 <pre><code class="language-bash">$ sudo dnf group install "Development Tools" "Development Libraries"</code></pre> 78 </div> 79 <h1 id="make"><strong>Make:</strong></h1> 80 <p>This is a build automation tool that will, well, “<em>make</em>” dwm for you. It usually comes with the <code>build-essential</code> or <code>base-devel</code> packages.</p> 81 <h1 id="libx11-development-files"><strong>LibX11 development files:</strong></h1> 82 <p>DWM interacts with the X Window System, so you’ll need the development headers for it. Often called something like <code>libx11-dev</code> or <code>libX11-devel</code>.</p> 83 <p>Debian:</p> 84 <div class="terminal-output"> 85 <pre><code class="language-bash">$ sudo apt install libx11-dev libxft-dev libxinerama-dev</code></pre> 86 </div> 87 <p>Arch:</p> 88 <div class="terminal-output"> 89 <pre><code class="language-bash">$ sudo pacman -S libx11 libxft libxinerama</code></pre> 90 </div> 91 <p>Fedora:</p> 92 <div class="terminal-output"> 93 <pre><code class="language-bash">$ sudo dnf install libX11-devel libXft-devel libXinerama-devel</code></pre> 94 </div> 95 <p><em>(Note: <code>libxft-dev</code> is for font rendering and <code>libxinerama-dev</code> is handy for multi-monitor setups, which you’ll probably want later on!)</em></p> 96 <p>Got all that? Sweet!</p> 97 <h2 id="getting-the-goods-the-source-code">Getting the Goods (The Source Code!)</h2> 98 <p>Alright, let’s grab the dwm source code. The suckless crew hosts their code on their own git server. 99 However I recommend personally to get their official <a href="https://dl.suckless.org/dwm/dwm-6.5.tar.gz">tarball releases</a> (this links to the latest of the time of writing this: 6.5) their <a href="https://dwm.suckless.org/">page</a>.</p> 100 <ol> 101 <li>Save the source code to where you want to keep it. A common spot is something like ~/.config/ or ~/.local/suckless/, just anywhere to hide it out of sight.</li> 102 103 <li>Unextract it</li> 104 105 <li>Open your terminal & navigate to that directory (using cd and stuff)</li> 106 </ol> 107 <p>Take a peek. You’ll see a bunch of <code>.c</code> files, a <code>Makefile</code>, and the golden goose: <strong>config.def.h</strong>.</p> 108 <h2 id="the-infamous-">The Infamous <code>config.h</code></h2> 109 <p>This is where the magic happens, folks. <code>config.def.h</code> is the <em>default</em> configuration. You’re not supposed to edit this directly. Instead, you copy it to <code>config.h</code>:</p> 110 <div class="terminal-output"> 111 <pre><code class="language-bash">$ cp config.def.h config.h</code></pre> 112 </div> 113 <p>Now, config.h is <strong>your</strong> personal configuration file. Open it up with your favorite text editor. You’ll see C arrays defining your keys, your tags, your fonts, your colors. 114 It might look a bit intimidating at first, but it’s surprisingly straightforward.</p> 115 <p>For now, don’t change anything. Let’s just get it built!</p> 116 <h2 id="the-first-bake-compiling-dwm">The First Bake: Compiling DWM</h2> 117 <p>Still in your dwm directory? Good. Time to compile! 118 This is the part that sounds scary but is usually super simple thanks to the Makefile.</p> 119 <p>To compile and install it system-wide:</p> 120 <div class="terminal-output"> 121 <pre><code class="language-bash">$ sudo make clean install</code></pre> 122 </div> 123 <p>Or, if you prefer not to install it system-wide immediately yet (which is a good idea for testing):</p> 124 <div class="terminal-output"> 125 <pre><code class="language-bash">$ make</code></pre> 126 </div> 127 <p>If all your prerequisites were met, this should complete without errors. You’ll now have a dwm executable file in the directory (and runnable in your terminal if 128 you ran the system wide installation)!</p> 129 <p>To run dwm, you’ll typically need to configure your .xinitrc file to launch it. 130 For example, you could add this line to your ~/.xinitrc:</p> 131 <div class="terminal-output"> 132 <pre><code class="language-bash">exec dwm</code></pre> 133 </div> 134 <p>For the people who run a Display Manager which is more likely (i.e gdm, sddm, lightdm, etc.). You’ll need to create a .desktop file. 135 This file basically has the information and stuff for the thing to see and run it. You’ll need to create one in the /usr/share/xsessions/. 136 And here’s an example <strong>dwm.desktop</strong> for reference:</p> 137 <p>/usr/share/xsessions/dwm.desktop:</p> 138 <div class="terminal-output"> 139 <pre><code class="language-bash">[Destop Entry] 140 Encoding=UTF-8 141 Name=dwm 142 Comment=Dynamic window manager 143 Exec=dwm 144 Icon=dwm 145 Type=XSession 146 </code></pre> 147 </div> 148 <p>The default keybinding for the Terminal is <em>Alt+Shift+Return</em>. Any other keybindings can be found in config.h, it shouldn’t be hard to 149 understand the giant struct declaration. Comments left by the suckless team are your friends! Read them!</p> 150 <h2 id="uh-oh-its-plain-time-for-patches">Uh Oh, It’s Plain! Time for Patches!</h2> 151 <p>“Okay,” you say, “this is cool and all, but it’s a bit… barebones. My buddy’s dwm has gaps, a cool status bar, and fancy tag names!”</p> 152 <p>Aha! You’ve stumbled upon the next layer of the suckless philosophy: patching.</p> 153 <p>Instead of bloating the core dwm code with every feature under the sun, the suckless community maintains a collection of <a href="https://dwm.suckless.org/patches/">patches</a>. 154 These are .diff files that you apply to your source code to add specific functionalities.</p> 155 <p style="margin: 0 auto; text-align: left; padding: 1em;"> Want gaps between windows? There's a patch for that.<br/> 156 Want clickable status bar elements? Patch!<br/> 157 Want windows to swallow terminals? Patch!<br/> 158 Want your bar at the bottom? You guessed it, patch!<br/> 159 </p> 160 <p>This is where the “do it yourself” ethos really shines. You pick and choose exactly what you want. However it might be daunting for some people. 161 And unfortunately, many patches don’t really like to work together. If you want a nice dwm patching experience, I would use <a href="https://github.com/bakkeby/dwm-flexipatch">this one</a>, 162 he’s the same creator as <a href="https://github.com/bakkeby/st-flexipatch">st-flexipatch</a> and other “flexipatch” series. Basically, all you do is edit the <strong>patches.h</strong> file 163 and you can basically get all the patches you want without too much hassle.</p> 164 <p>For those who are the tinkers, continue on…</p> 165 <h2 id="how-to-patch-the-basics">How to Patch (The Basics)</h2> 166 <p>First of all, you’ll need to download the patch utility if you don’t have it. You can probably guess what it’ll be called when you install it using a 167 package manager. Once you’ve done that here are the general steps:</p> 168 <ol> 169 <li><p>Find a Patch: Head over to the dwm patches page. Find a patch you like. Let’s say you want the autostart patch, 170 which allows you to run commands automatically when dwm starts (I highly reccomend this especially if you’re running from a display manager!).</p></li> 171 <li><p>Download the Patch: Download the .diff file for the patch. Save it somewhere, perhaps in a patches subdirectory within your dwm source folder.</p></li> 172 <li><p>Apply the Patch: In your dwm source directory, use the patch command: </p></li> 173 </ol> 174 <div class="terminal-output"> 175 <pre><code class="language-bash">$ patch -Np1 -i /path/to/patchfile.diff</code></pre> 176 </div> 177 <ol start="4"> 178 <li><p>Resolve Conflicts (If Any): Sometimes, patches might conflict, especially if they modify the same lines of code or if you’re applying a patch meant 179 for an older version of dwm. This will result in .rej (rejected) files. You’ll need to manually edit the source files to resolve these conflicts, looking 180 at the .rej files to see what couldn’t be applied. This is the trickiest part, but it gets easier with practice. Start with simple, popular patches.</p></li> 181 <li><p>Recompile: After applying a patch (and resolving any conflicts), you need to recompile!</p></li> 182 </ol> 183 <div class="terminal-output"> 184 <pre><code class="language-bash">$ sudo make clean install</code></pre> 185 </div> 186 <p>And that’s the patching dance! It can be a bit fiddly, especially when patches conflict, but it gives you incredible control over your window manager. 187 Also, a quick note! Some patches might change the config.def.h, add these new changes to your config.h since they are default configs for the new patches.</p> 188 <h2 id="next-steps-the-suckless-mentality">Next Steps & The Suckless Mentality</h2> 189 <p>From here, the world is your oyster:</p> 190 <ul> 191 <li><strong>Explore config.h:</strong> Seriously, dive in. Change your mod key (Alt is default, many prefer the Super/Windows key, just change the MODKEY definition from Mod1Mask to Mod4Mask). 192 Change your fonts, colors, and tag names. Recompile after every change.</li> 193 <li><strong>Browse More Patches:</strong> Get those gaps (vanitygaps), add a systray, try different layouts (fibonacci, centeredmaster).</li> 194 <li><strong>Status Bar:</strong> Dwm’s status bar is typically populated by setting the root window’s name. You’ll often use a separate shell script or program (like slstatus or a custom script) 195 that periodically updates this. The autostart patch is great for launching such scripts. You can also decide to change out the bar to something like <a href="https://polybar.github.io/">polybar</a> or something.</li> 196 <li><strong>Embrace Simplicity:</strong> The core idea of suckless is to keep things simple and understandable. If a patch seems overly complex or breaks things too often, maybe it’s not for you. 197 The beauty is in building your ideal, minimal environment.</li> 198 </ul> 199 <p>Don’t be afraid to break things! If you mess up your config.h or a patch goes horribly wrong, you can always run a <em>patch -R -i file.patch</em>. And for the config.h, the config.def.h 200 will always be there as the default to save you.</p> 201 <p>It’s a journey, not a race. You’ll learn a bit about C, a bit about how window managers work, and a lot about what you really want from your desktop.</p> 202 <p>So go forth, compile, patch, and make dwm your own! It’s less about having a flashy setup (though you can certainly make it look nice) and more about having a tool that’s perfectly 203 tailored to you. Less is indeed more, especially when you’re the one deciding what that “less” consists of.</p> 204 <p>Happy Hacking!</p> 205 <p>– cowmonk</p> 206 </article> 207 <p class="tags"> 208 Tags: <span class="sblg-tag">guide</span><span class="sblg-tag">suckless</span><span class="sblg-tag">tutorial</span>. 209 </p> 210 </section> 211 <nav> 212 <span class="prevnext sblg-prev-has"> 213 <a href="blog5.html"><-newer</a> 214 </span> 215 <span class="prevnext sblg-next-has"> 216 <a href="blog3.html">older-></a> 217 </span> 218 </nav> 219 <footer> 220 <a href="https://www.vim.org/"><img src="https://cyber.dabamos.de/88x31/vim.vialle.love.anim.gif" alt="description" height="31" /></a> <img src="https://88x31.kate.pet/madeon_linux.gif" height="31" /> <img src="https://cyber.dabamos.de/88x31/javascript-zero.gif" height="31" /> 221 </footer> 222 </body> 223 </html>