https://github.com/Curve/aawmtt
Another AwesomeWM Testing Tool 🚀
https://github.com/Curve/aawmtt
Last synced: 4 months ago
JSON representation
Another AwesomeWM Testing Tool 🚀
- Host: GitHub
- URL: https://github.com/Curve/aawmtt
- Owner: Curve
- Created: 2023-03-21T20:33:53.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-12-10T23:27:28.000Z (6 months ago)
- Last Synced: 2025-02-13T23:37:07.707Z (4 months ago)
- Language: C++
- Size: 2.38 MB
- Stars: 25
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-awesomewm-modules-widgets-and-libraries - aawmtt
- awesome-awesomewm-modules-widgets-and-libraries - aawmtt
README
aawmtt
Another AwesomeWM Testing Tool, written in C++20
---
## Features
- Live Reload
- Proper Display detection
- Configurable Restart Mode
## Why?
The original [awmtt](https://github.com/gmdfalk/awmtt) as well as [awmtt-ng](https://github.com/basaran/awmtt-ng) have several issues.
1. awmtt-ng seems to have issues with detecting free displays and will straight up ignore the display passed through "-D".
2. For me they both exit instantly when the config is a sym-link or somewhere else than in "~/.config/awesome".
3. Better Live-Reload
### Packages
- [AUR](https://aur.archlinux.org/packages/aawmtt)
### Dependencies
- A C++20 Compiler *(Tested on Clang 15)*
- Xephyr
- Xlib
### Installation
```sh
mkdir build && cd build
cmake .. && cmake --build . --config Release
```
### Usage
```
Usage:
aawmtt
aawmtt [...]
Options:
-h --help Print usage
-x --xephyr Explicitly specify xephyr path
--xephyr-args Arguments used to invoke xephyr (Default: "-ac -br -noreset")
-a --awesome Explicitly specify awesome path
--awesome-args Additional awesome arguments (e.g. "--screen off")
-c --config Location of the awesome config to use (Default: "~/.config/awesome/rc.lua")
-w --watch Directory to watch for changes (Default: Parent directory of config)
-m --mode Awesome restart strategy ["r" = restart, "s" = SIGHUP] (Default: "s")
-s --size Xephyr window size (Default: "1920x1080")
-d --display X11 Display to use (Default: Free Display)
--no-reload Disable automatic reload
--no-recursive Disable recursive directory watch
```
### Screenshots
