Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/codic12/worm
A dynamic, tag-based window manager written in Nim
https://github.com/codic12/worm
nim wm x11
Last synced: 11 days ago
JSON representation
A dynamic, tag-based window manager written in Nim
- Host: GitHub
- URL: https://github.com/codic12/worm
- Owner: codic12
- License: mit
- Created: 2021-10-01T01:49:00.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-31T00:29:23.000Z (5 months ago)
- Last Synced: 2024-08-01T22:54:21.195Z (3 months ago)
- Topics: nim, wm, x11
- Language: Nim
- Homepage:
- Size: 1.87 MB
- Stars: 707
- Watchers: 15
- Forks: 26
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-Awesome-Linux-Software - 
# Worm
Worm is a tiny, dynamic, tag-based window manager written in the Nim language.
It supports both a floating mode and master-stack tiling with gaps and struts.
Check out the [screenshots on the wiki](https://github.com/codic12/worm/wiki/Screenshots) for some examples of how it looks.
## Build / install
Install Nim >= 1.6.0, for example through Choosenim. Clone this repo and run
```
$ nimble build -d:release
```
And you should end up with two binaries; strip and use!
Alternatively, for users using Arch, you can use the AUR package worm-git.
```
$ yay -S worm-git
```
## Configuration
### Autostart
Worm will try to execute the file `~/.config/worm/rc` on startup.
Simply create it as a shell-script to execute your favorite applications with
worm.
(don't forget to make it executable).
An example can be found [here](/examples/rc).
### Keybindings
Worm does not have a built-in keyboard mapper, so you should use something like
[sxhkd](https://github.com/baskerville/sxhkd).
Please read [the docs](docs/wormc.md) to understand how wormc works before
writing your own sxhkdrc.
An example sxhkdrc can be found [here](/examples/sxhkdrc).
## License
Licensed under the MIT license. See the LICENSE file for more info.
## Credits
Thanks to [phisch](https://github.com/phisch) for making the logo!
Thanks to everyone else that's opened an issue, a PR, or just tried out worm.