1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
# sxwm (*The (truly) Simple Xorg Window Manager*)
Performance greater than DWM, and easier to config than i3wm
<a href="https://user-images.githubusercontent.com/username/sxwm-screen1.jpg"><img src="https://user-images.githubusercontent.com/username/sxwm-screen1.jpg" width="45%" align="right"></a>
Here we have a **minimal**, **tiling**, and **configurable** window manager.
- **Tiling & Floating**: Seamlessly switch between layouts.
- **Workspaces**: Workspaces work with your bar.
- **Bars work too**: BAR BAR BAR?! Why not try [sxbar](https://github.com/uint23/sxbar)
- **Lightweight**: Single C file plus a small header and config.
- **Easy Config**: All settings in `config`.
- **SUPER Fast**: Sometimes **2M** sometimes **4M**, idk but still destroys DWM
- **BEST WM**: Basically DWM on roids (and without the elitism).
<br>
<a href="TODO"><img src="TODO" width="45%" align="right"></a>
- **Master-Stack**: Use the DWM native and super productive layout.
- **Keyboard-driven**: Full coverage via `MOD` + keys.
- **Mouse Support**: Focus under cursor, move & resize with modifiers.
- **Zero Dependencies**: Only requires `libX11`.
- **Compiles on a Toaster**: As long as it has a decently modern compiler.
<br clear="right">
---
## Default Configuration
All options reside in `config` (which is just a header-file) with clear comments.
Keybindings are also easy to understand and quick to implement.
No more bindsym or... *\*shudders\** C code...
```c
CMD(terminal, "st");
CMD(browser, "firefox");
static const Binding binds[] =
{
/*————< MODIFIER(S) >< KEY >—————< FUNCTION >——*/
/*———————< Here are your functions calls >————— — */
CALL(MOD|SHIFT, e, quit),
CALL(MOD|SHIFT, q, close_focused),
CALL(MOD, j, focus_next),
CALL(MOD, k, focus_prev),
CALL(MOD|SHIFT, j, move_master_next),
CALL(MOD|SHIFT, k, move_master_prev),
CALL(MOD, equal, inc_gaps),
CALL(MOD, minus, dec_gaps),
CALL(MOD, space, toggle_floating),
CALL(MOD|SHIFT, space, toggle_floating_global),
.....
```
---
## Default Keybindings
**Window Management**
| Combo | Action |
| ---------------------------- | ------------------------- |
| `Mouse` | Focus under cursor |
| `MOD` + `Left Mouse` | Move window by mouse |
| `MOD` + `Right Mouse` | Resize window by mouse |
| `MOD` + `j` / `k` | Focus next / previous |
| `MOD` + `Shift` + `j` / `k` | Move in master stack |
| `MOD` + `Space` | Toggle floating |
| `MOD` + `Shift` + `Space` | Toggle all floating |
| `MOD` + `=` / `-` | Inc/Dec gaps |
| `MOD` + `f` | Fullscreen toggle |
| `MOD` + `c` | Center window |
| `MOD` + `q` | Close focused window |
| `MOD` + `1-9` | Switch workspace 1–9 |
| `MOD` + `Shift` + `1-9` | Move window to WS 1–9 |
**Programs**
| Combo | Action | Programs (by default) |
| -------------------- | ---------- | --------- |
| `MOD` + `Return` | Terminal | `st` |
| `MOD` + `b` | Browser | `firefox` |
---
## Dependencies
- `libX11` (Xorg client library)
- GCC / Clang & Make
---
## Makefile Targets
Below are the available `make` targets for streamlining common tasks:
| Target | Description |
| ---------------- | ------------------------------------------------------------------- |
| `make` or `make all` | Compile the source files into the `sxwm` binary. |
| `make clean` | Remove object files (`*.o`) and build artifacts. |
| `make install` | Install `sxwm` to `$(PREFIX)/bin` (default `/usr/local/bin`). |
| `make uninstall` | Remove the installed binary from `$(PREFIX)/bin`. |
| `make clean-install` | Runs `make clean` then `make install`. |
> You can override the install directory by specifying `PREFIX` or `DESTDIR`, for example:
> ```sh
> make install PREFIX=$HOME/.local
> ```
---
## Installation
1. **Clone repository**
```bash
git clone https://github.com/uint23/sxwm.git
cd sxwm
```
2. **Build**
```bash
make
```
3. **Install**
```bash
sudo make clean-install
```
4. **Run**
Add to `~/.xinitrc`:
```sh
exec sxwm
```
---
## Thanks & Inspiration
- [dwm](https://dwm.suckless.org) - Tiling & source code
- [i3](https://i3wm.org) - Making configuring easy
- [sowm](https://github.com/dylanaraps/sowm) - README inspo :)
- [tinywm](http://incise.org/tinywm.html) - idk, just cool to see how a wm works
---
<p align="center">
<em>Contributions welcome! Open issues or submit PRs.</em>
</p>
|
