{"id":16974336,"url":"https://github.com/Curve/aawmtt","last_synced_at":"2026-02-19T04:30:17.863Z","repository":{"id":174175869,"uuid":"617166261","full_name":"Curve/aawmtt","owner":"Curve","description":"Another AwesomeWM Testing Tool 🚀","archived":false,"fork":false,"pushed_at":"2024-12-10T23:27:28.000Z","size":2494,"stargazers_count":25,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-13T23:37:07.707Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Curve.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-03-21T20:33:53.000Z","updated_at":"2025-01-13T11:02:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"b7707359-5e48-4d82-ba8e-44b49c319555","html_url":"https://github.com/Curve/aawmtt","commit_stats":null,"previous_names":["curve/aawmtt"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Curve%2Faawmtt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Curve%2Faawmtt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Curve%2Faawmtt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Curve%2Faawmtt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Curve","download_url":"https://codeload.github.com/Curve/aawmtt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239838087,"owners_count":19705477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T01:06:16.028Z","updated_at":"2026-02-19T04:30:17.805Z","avatar_url":"https://github.com/Curve.png","language":"C++","funding_links":[],"categories":["Configuration Related"],"sub_categories":["Projects that Ease Configuration"],"readme":"\u003chr\u003e\n\n\u003cdiv align=\"center\"\u003e \n    \u003cimg src=\"./assets/logo.png\" /\u003e\n    \u003ch3\u003e\n        aawmtt\n    \u003c/h3\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e \n    Another AwesomeWM Testing Tool, written in C++20\n\u003c/p\u003e\n\n---\n\n## Features\n\n- Live Reload\n- Proper Display detection\n- Configurable Restart Mode\n\n## Why?\n\nThe original [awmtt](https://github.com/gmdfalk/awmtt) as well as [awmtt-ng](https://github.com/basaran/awmtt-ng) have several issues.\n\n1. awmtt-ng seems to have issues with detecting free displays and will straight up ignore the display passed through \"-D\".\n\n2. For me they both exit instantly when the config is a sym-link or somewhere else than in \"~/.config/awesome\".\n\n3. Better Live-Reload \n\n### Packages\n\n- [AUR](https://aur.archlinux.org/packages/aawmtt)\n\n### Dependencies\n\n- A C++20 Compiler *(Tested on Clang 15)*\n- Xephyr\n- Xlib\n\n### Installation\n\n```sh\nmkdir build \u0026\u0026 cd build\ncmake .. \u0026\u0026 cmake --build . --config Release\n```\n\n### Usage\n\n```\nUsage: \n    aawmtt \n    aawmtt [...]\n\nOptions:\n    -h --help                   Print usage\n    \n    -x --xephyr     \u003cpath\u003e      Explicitly specify xephyr path \n    --xephyr-args   \u003cargs\u003e      Arguments used to invoke xephyr (Default: \"-ac -br -noreset\")\n    \n    -a --awesome    \u003cpath\u003e      Explicitly specify awesome path\n    --awesome-args  \u003cargs\u003e      Additional awesome arguments (e.g. \"--screen off\")\n    \n    -c --config     \u003cpath\u003e      Location of the awesome config to use (Default: \"~/.config/awesome/rc.lua\")\n    -w --watch      \u003cpath\u003e      Directory to watch for changes (Default: Parent directory of config)\n    -m --mode       \u003cenum\u003e      Awesome restart strategy [\"r\" = restart, \"s\" = SIGHUP] (Default: \"s\")\n    \n    -s --size       \u003cstring\u003e    Xephyr window size (Default: \"1920x1080\")\n    -d --display    \u003cnumber\u003e    X11 Display to use (Default: Free Display)\n    \n    --no-reload                 Disable automatic reload\n    --no-recursive              Disable recursive directory watch\n```\n\n### Screenshots\n\n![screenshot](assets/screenshot.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCurve%2Faawmtt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCurve%2Faawmtt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCurve%2Faawmtt/lists"}