awesome

C/C++ 2025-08-10

读书我

关于awesome

awesome是X的高度可配置的下一代框架窗口管理器。

建筑和安装

提取dist tarball或克隆存储库后,运行:

make
sudo make install

这会

  1. ./build中创建一个构建目录,
  2. 运行cmake
  3. 构建awesome
  4. 将其安装到默认的前缀路径/usr/local

另外,您可以生成.deb.rpm软件包,以便于安装管理:

awesome-x.y.z.deb # or sudo rpm -Uvh awesome -x.y.z.rpm">
make package

sudo dpkg -i awesome -x.y.z.deb
# or
sudo rpm -Uvh awesome -x.y.z.rpm

高级选项和测试

可以在此处找到依赖项,更高级的构建选项以及有关如何使用测试套件的说明的完整列表。

将当前的Git Master安装作为包装收据

Arch Linux Aur

awesome-git makepkg -fsri">
sudo pacman -S --needed base-devel git
git clone https://aur.**a*rchlinux.org/awesome-git.git
cd awesome -git
makepkg -fsri

基于Debian

awesome git clone https://gith*u*b.co*m/awesomewm/ awesome cd awesome make package cd build sudo apt install ./*.deb">
sudo apt build-dep awesome
git clone https://gith*u*b.co*m/awesomewm/ awesome
cd awesome
make package
cd build
sudo apt install ./ * .deb

跑步awesome

您可以直接从显示经理中选择awesome 。如果没有,您可以将以下行添加到.xinitrc中,以使用startx.xsession启动awesome ,以使用您的Display Manager启动awesome :

 exec awesome

为了awesome到特定显示器,请确保正确设置了DISPLAY环境变量,例如:

DISPLAY=foo.bar:1 exec awesome

(这将开始显示出awesome启动:1 。)

配置

awesome的配置是通过创建$XDG_CONFIG_HOME/ awesome /rc.lua文件来完成的,通常是~/.config/ awesome /rc.lua

源中提供了一个名为awesome rc.lua的示例配置。

故障排除

在大多数系统上,任何由awesome打印的消息(包括警告和错误)都写给~/.xsession-errors

如果awesome未启动或配置文件未产生所需的结果,则用户应检查此文件以深入了解该问题。

调试技巧

您可以这样称呼gdb awesome

DISPLAY=:2 gdb awesome

然后在gdb中设置任何参数并运行它:

 (gdb) set args --replace
(gdb) run

问问题

IRC

您可以在OFTC IRC网络上的# awesome频道中加入我们。

IRC Webchat

堆栈溢出

您可以在Stack Overflow上提出问题。

reddit

我们也有一个awesome子雷迪特,您可以在其中分享您的作品并提出问题。

报告问题

请报告您在我们的Bugtracker上可能发现的任何问题。

贡献代码

您可以在GitHub存储库上提交拉动请求。请阅读有关任何编码,文档或补丁指南的贡献指南。

地位

文档

在线文档可在此处提供。

执照

该项目已根据GNU通用公共许可证V2或更高版本获得许可。您可以通过(v2或v3)在线阅读。

下载源码

通过命令行克隆项目:

git clone https://github.com/awesomeWM/awesome.git