AWMTT技术文档

1. 安装指南

适用于ArchLinux用户的安装

ArchLinux用户可以在AUR中找到awmtt。

对于Debian/Ubuntu的手动安装

请按照以下步骤进行安装：

sudo apt-get install xserver-xephyr
sudo wget -O /usr/bin/awmtt https://raw.githubusercontent.com/mikar/awmtt/master/awmtt.sh
sudo chmod a+x /usr/bin/awmtt

2. 项目使用说明

awmtt（AwesomeWM测试工具）是一个bash脚本，用于帮助您测试Awesome配置文件。它需要一个名为Xephyr的Xorg应用程序，该程序可以生成一个嵌套的xorg-server实例，允许您打开多个桌面环境或窗口管理器，如AwesomeWM。

使用示例

awmtt start (默认使用: -C $HOME/.config/awesome/rc.lua.test -D 1 -S 1024x640)
awmtt start -C /etc/xdg/awesome/rc.lua -D 3 -S 1280x800 -x -keybd ephyr,,,xkbmodel=pc105,xkblayout=de,xkbrules=evdev,xkboption=grp:alts_toogle
awmtt theme set zenburn -N

命令行参数

• start：通过Xephyr启动嵌套的Awesome
• stop：停止上一个Xephyr进程
  • all：停止所有Xephyr实例
• restart：重启所有Xephyr实例
• run <cmd>：在Xephyr实例中运行命令（通过-D指定实例）
• theme：通过以下子命令进行基本主题控制：
  • get：获取当前主题名称
  • set <theme>：设置主题为<theme>
  • list：列出可用主题
  • random：设置随机主题

选项

• -B|--binary <path>：指定awesome二进制文件的路径（用于测试自定义awesome构建）
• -C|--config <path>：指定配置文件
• -D|--display <int>：指定使用的显示（例如1）
• -N|--notest：不使用测试文件，而是使用实际的rc.lua（即$HOME/.config/awesome/rc.lua）
• -S|--size <size>：指定窗口大小
• -a|--aopt <opt>：传递选项给awesome二进制（例如--no-argb或--check）。可以重复使用。
• -x|--xopts <opts>：传递选项给xephyr二进制（例如-keybd ephyr,,,xkblayout=de）。需要放在最后。
• -h|--help：显示帮助文本并退出

3. 项目API使用文档

awmtt脚本不提供传统的API调用，但它通过命令行参数和选项提供了丰富的功能，允许用户以多种方式控制和配置其AwesomeWM环境。

4. 项目安装方式

请参考上述“安装指南”部分，根据您的操作系统选择合适的安装方式。对于ArchLinux用户，可以通过AUR进行安装。对于Debian/Ubuntu用户，需要进行手动安装，包括安装依赖和下载脚本文件。