-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme.txt
343 lines (206 loc) · 18 KB
/
readme.txt
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
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
dintwm
Tiling window "manager" for AmigaOS 3.1.x.
NOTE Dintwm is under rather heavy development, it is a hobby project and breakage may occur.
Changelog
- v0.6
- Fixed bug launching Dintwm from workbench introduced in v0.5
- Fixed bug when running without BAR TT enabled
- Add documentation on MagicMenu "Non Blocking" incompatibility
- v0.5
- Fix autotiling bug that prevented program launches from wb icons
- Add feature to tab through windows on current workspace
- Auto select first active window in workspace when changing workspace
- Auto select first active window when moving a window to other workspace
- Fix initial barwidth when launching LEFTGAP / RIGHTGAP TT.
- v0.4
- Make text items in bar configurable
- Make bar color items behave internally as text items
- Really fix off by one memleak bug
- Set better defaults for docmd (conline and newshell)
- Create hash of window title snips to keep track of them
- Much better window change tracking
- Window checking handled in subtask
- Closing windows always triggers retile
- Much lower CPU foot print
- Fix bug with tile mode in bar
- fbaserel no longer prodcues working binary, dropped
- v0.3 DUD RELEASE BUGS FOUND
- v0.2
- Add TT VWS_ON to enable virtual workspaces
- Add INFO_OFF TT to disable info boxes
- Disable tiling with POPKEY_TILE_OFF
- Ignore all WS shifting business when vws's are off
- Fix bug with text not fitting in info windows
- Quit if backdropped window is detected and vws's are on
- Don't show workspaces on bar if vws's are off
- Add version option to cli
- v0.1
- initial release
Building from source
Install crosscompiler:
https://github.com/bebbo/amiga-gcc
Cross-compilation on Linux for AmigaOS (requires bebbo's m68k-amigaos-gcc fork)
make all
Demo
Check demos on: https://github.com/RasmusEdgar/dintwm
Running dintwm as a commodity
Dintwm will ignore the workbench window and backdropped windows.
To run dintwm as a commodity:
1. Add the tooltypes you need to the included dintwm.info file. See Tooltype Options Table section.
2. Test it out using the following command: dintwm -C or simply run dintwm without options.
3. When done drag the dintwm icon file to wbstartup and dintwm should run after reboot.
4. Check its status in System->Tools->Commodities->Exchange, you can also kill dintwm from here.
5. Dintwm can be exited at any time with Ctrl+Lcommand+q (lcommand is also known as Left Amiga Modifier Key)
The tooltypes in the dintwm file could look like this:
POPKEY_TILE=rawkey control shift z
POPKEY_HGRID=rawkey control shift x
POPKEY_SPIRAL=rawkey control shift c
POPKEY_DWINDLE=rawkey control shift v
TOPGAP=30
EXCL_WTYPE_0=CX V2.3.0: Hot Key = <ctrl alt help>
Tooltype Options Table
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Tooltype Default Description Related Tooltype(s)
--------------------- ---------------------------------------------- ----------------------------------------------------------------------------------------- -----------------------------
POPKEY_TILE rawkey control lcommand t tile with master window layout TILE_FACT
POPKEY_HGRID rawkey control lcommand g grid layout NA
POPKEY_SPIRAL rawkey control lcommand f fibonacci variant layout NA
POPKEY_DWINDLE rawkey control lcommand d another fibonacci variant layout NA
POPKEY_SWITCHF rawkey control lcommand s flip through layouts forwards NA
POPKEY_SWITCHB rawkey control lcommand x flip through layouts backwards NA
POPKEY_INCTOPGAP rawkey control lcommand cursor_up increase topgap while running GAP_CHANGE_VALUE
POPKEY_INCLEFTGAP rawkey control lcommand cursor_left increase leftgap while running GAP_CHANGE_VALUE
POPKEY_INCRIGHTGAP rawkey control lcommand cursor_right increase rightgap while running GAP_CHANGE_VALUE
POPKEY_DECTOPGAP rawkey control shift cursor_up decrease topgap while running GAP_CHANGE_VALUE
POPKEY_DECBOTTOMGAP rawkey control shift cursor_down decrease bottomgap while running GAP_CHANGE_VALUE
POPKEY_DECLEFTGAP rawkey control shift cursor_left decrease leftgap while running GAP_CHANGE_VALUE
POPKEY_DECRIGHTGAP rawkey control shift cursor_right decrease rightgap while running GAP_CHANGE_VALUE
POPKEY_INCALLGAPS rawkey control lcommand numeric_pad + increase all gaps while running GAP_CHANGE_VALUE
POPKEY_DECALLGAPS rawkey control lcommand numeric_pad -- (double dash to escape special function of dash) decrease all gaps while running GAP_CHANGE_VALUE
POPKEY_CMD_0..9 spawns custom commands rawkey control lcommand 0..9 CMD_0..9, CONLINE_0..9
POPKEY_WS_0..5 change to virtual workspace rawkey control lcommand numpad 0..5 POPKEY_CWS_0..5
POPKEY_CWS_0..5 move active window to virtual workspace rawkey control shift numpad 0..5 POPKEY_CWS_0..5
POPKEY_TAB_NEXT rawkey control lcommand tab tabs through windows on current workspace NA
POPKEY_CXM_EXIT rawkey control lcommand q exits commodity NA
POPKEY_TILE_OFF rawkey control lcommand o disables tiling globally NA
TOPGAP 0 sets the top gap of the screen NA
BOTTOMGAP 0 sets a bottom gap NA
LEFTGAP 0 sets a left gap NA
RIGHTGAP 0 sets a right gap NA
GAP_CHANGE_VALUE 20 sets the increment/decrement value for gap adjustment *GAP
DEFAULT_TOPGAP TRUE set automatically calculated gap NA
CMD_0..9 NewShell sets custom commands to spawn, like a shell or a program CONLINE_0..9
CONLINE_0..9 CON:0/0/550/350/Dintwm Shell/AUTO/CLOSE/WAIT sets custom conline for the matching CMD_0..9 CMD_0..9
EXCL_WTYPE_0..9 empty excludes windows based on window->Title deactivates INCL_WTYPE_0..9
INCL_WTYPE_0..9 empty includes windows based on window->Title deactivates EXCL_WTYPE_0..9
AUTO empty enable auto tiling, all non-filtered new windows will be tiled AUTO_INTERVAL_DELAY
AUTO_INTERVAL_DELAY 1 Auto tile refresh rate, how often it checks for new windows. Set to 50 ticks per second AUTO
TILE_FACT 550 size factor of master window (val / 1000) in tiling function POPKEY_TILE
BAR empty Bar on or off BAR_*
BAR_BG_COL 3 (color 3 on palette) Dintwm bar bg color BAR
BAR_FPW_COL 1 Dintwm bar frontpen color BAR
BAR_BPW_COL 3 Dintwm bar backpen color BAR
BAR_FPCURW_COL 6 Dintwm bar active workspace color frontpen BAR
BAR_BPCURW_COL 3 Dintwm bar active workspace color backpen BAR
BAR_FPTM_COL 1 Dintwm bar tilemode frontpen color BAR
BAR_BPTM_COL 3 Dintwm bar tilemode backpen color BAR
BAR_FPTI_COL 1 Dintwm bar active window title frontpen color BAR
BAR_BPTI_COL 3 Dintwm bar active window title backpen color BAR
BAR_FPSEP_ONE_COL 1 Dintwm bar seperator one frontpen color BAR
BAR_BPSEP_ONE_COL 3 Dintwm bar seperator one backpen color BAR
BAR_FPSEP_TWO_COL 1 Dintwm bar seperator two frontpen color BAR
BAR_BPSEP_TWO_COL 3 Dintwm bar seperator two backpen color BAR
BAR_TEXT_WS0 WS0 Dintwm bar text for ws0 BAR
BAR_TEXT_WS1 WS1 Dintwm bar text for ws1 BAR
BAR_TEXT_WS2 WS2 Dintwm bar text for ws2 BAR
BAR_TEXT_WS3 WS3 Dintwm bar text for ws3 BAR
BAR_TEXT_WS4 WS4 Dintwm bar text for ws4 BAR
BAR_TEXT_WS5 WS5 Dintwm bar text for ws5 BAR
BAR_TEXT_TILE Tile Dintwm bar text for tile mode BAR
BAR_TEXT_GRID Grid Dintwm bar text for grid mode BAR
BAR_TEXT_DWINDLE FibD Dintwm bar text for dwindle mode BAR
BAR_TEXT_SPIRAL FibS Dintwm bar text for spiral mode BAR
BAR_TEXT_SEP_1 | Dintwm bar text for sepator one BAR
BAR_TEXT_SEP_2 | Dintwm bar text for sepator one BAR
BAR_HIDE_EMPTY empty Hide bar if workspace is empty BAR
INFO_OFF empty Supress info windows - not recommended NA
VWS_ON FALSE Enable virtual workspaces NA
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Features explained
Here is a short outline of the different features and their limitations.
Virtual workspaces
Creates layers of window sets, which could also be seen as virtual workspaces and change between them using the POPKEY_WS_0..5 hotkeys.
Move active window to another virtual workspace using the POPKEY_CWS_0..5 hotkeys.
Since virtual workspaces depend on moving windows to be the back of the window stack, using it with a backdropped Workbench window will not work.
To enable do not backdrop the workbench window and set tooltype VWS_ON=TRUE
Dintwm bar
The bar is at the moment only available in the bottom of the tiling area. It shows tilemode, active window title and indicates the current active workspace.
Default ToolTypes
The following tooltypes are enabled in info file by default:
- AUTO tiling is enabled
- VWS_ON i.e. virtual workspaces are enabled
- BAR is enabled
- DONOTWAIT is enabled to remove nag dialog box on some systems
- CMD_0 is set to Newshell by default <ctrl lcommand 0>
Known problems and workarounds:
MagicMenu
MagicMenu with "Non Blocking" enabled in combination with DintWM will dead lock/hang workbench. To use DintWM with MagicMenu, please disable "Non Blocking" in MagicMenu prefs.
Running dintwm from CLI
Again Dintwm will ignore the workbench window, backdropped windows and gimmezerozero windows.
Auto tile for obvious reasons does not work in this mode.
Virtual workspaces do not work either.
Open some windows.
Run to see available options:
dintwm -h
Try tiling them:
dintwm -t
With a gap for the workbench titlebar.
dintwm -g -u
With custom gaps all around:
dintwm -U 45 -B 45 -L 45 -R 45 -t
That is, you could basically set tiling to occur where ever you decide on the screen.
dintwm -U 320 -L 320 -t
It is of course possible to use something as FKey to bind the above commands to your own HotKeys and use Dintwm as a manual tiling utility.
Options are:
- -d: Fibonacci dwindle
- -g: Horizontal grid
- -t: Tile with left master
- -s: Fibonacci spiral
- <other arg> -u: Add workbench top bar gap
- <other arg> -U<int>: Add custom top gap
- <other arg> -B<int>: Add custom bottom gap
- <other arg> -L<int>: Add custom left gap
- <other arg> -R<int>: Add custom right gap
- -h: This message
TODO
- |DONE|Create an optional Dintwm commodity to enable hotkeys|DONE|
- |DONE|Make dintwm dynamical, by saving position of windows before tiling.|DONE| Dropped
- |DONE|Float -> Tile -> Float behaviour|DONE|
- |DONE|Enable auto tiling when new windows appear.|DONE|
- |DONE|Add leftgap, rightgap and bottomgap|DONE|
- |DONE|Virtual workspaces|DONE|
- |DONE|Add dintwm bar|DONE|
- |DONE|Stop commodity with hotkey|DONE|
- |DONE|Use github actions to build and package dintwm release|DONE|
- |DONE|Make static bar text fields configurable|DONE|
- |DONE|Implement dedicated dintwm screen|DONE| Dropped
- |DONE|Builtin dmenu like launcher|DONE| * See http://aminet.net/package/util/wb/tabexec *
- |DONE|Ensure AROS compatibility (works without bar atm)|DONE| Dropped ftb
Note on licensing
Some parts of the code (tile and fibonacci functions) are adapted from dwm, a DWM-LICENSE is therefore included.
Ketopt.h from https://github.com/attractivechaos/klib is licensed under the MIT/X11 license.
SAST Tools
Static analyzers used are: splint flawfinder cppcheck
Check out the Makefile on how this project uses them.
Memleak checker
This part I find difficult to check for when compiling for a m68k target (no valgrind).
Settled on fortify which helped me identify a memory leak.
It can be enabled by building the source with:
wget http://aminet.net/dev/c/fortify22.lha
lha x fortify22.lha -w=/tmp
cp /tmp/FORTIFY.CXX fortify.c
cp /tmp/UFORTIFY.H ufortify.h
cp /tmp/FORTIFY.H fortify.h
make strict=true fortify=true all
rm {uf,f}ortify*
When running the dintwm binary on AmigaOS, some memory allocation statistics will be displayed hopefully showing no memory leaks.