新手必看：wmutils/core核心工具详解，轻松上手窗口操作

新手必看：wmutils/core核心工具详解，轻松上手窗口操作

【免费下载链接】coreSet of window manipulation tools项目地址: https://gitcode.com/gh_mirrors/core106/core

wmutils/core是一套专为X窗口系统设计的轻量级窗口管理工具集，它提供了简单而强大的窗口操作功能。对于Linux和Unix用户来说，掌握这些窗口操作工具可以极大地提升工作效率，让你像专业开发者一样轻松操控窗口布局。本文将为你详细介绍wmutils/core的16个核心工具，帮助你快速上手窗口管理技巧。

📦 快速安装与配置指南

一键安装步骤

首先，你需要从仓库克隆项目源码：

git clone https://gitcode.com/gh_mirrors/core106/core cd core

然后进行编译和安装：

make sudo make install

如果你想要自定义安装路径，可以使用以下命令：

make PREFIX=/usr/local install

依赖检查与配置

wmutils/core的唯一依赖是XCB库，在大多数Linux发行版中都已预装。如果需要手动安装，可以使用以下命令：

• Ubuntu/Debian:sudo apt-get install libxcb1 libxcb-util0-dev
• Fedora/RHEL:sudo dnf install libxcb-devel
• Arch Linux:sudo pacman -S libxcb

🔧 核心工具功能详解

窗口信息获取工具

这些工具帮助你获取窗口的状态信息，是窗口操作的基础：

pfw - 打印当前焦点窗口

$ pfw 0x02000001

这个简单的命令返回当前获得焦点的窗口ID，是很多自动化脚本的起点。

wattr - 获取窗口属性

$ wattr whxy 0x02000001 800 600 100 200

wattr工具可以查询窗口的宽度、高度、X坐标、Y坐标等属性，支持多种参数组合。

lsw - 列出所有窗口

$ lsw 0x02000001 0x02000002 0x02000003

lsw会列出当前屏幕上的所有窗口ID，配合其他工具可以实现批量操作。

窗口位置控制工具

这些工具让你精确控制窗口的位置和大小：

wtp - 窗口传送

$ wtp 100 200 800 600 0x02000001

wtp可以将窗口"传送"到指定位置，并调整到指定大小，参数依次为：X坐标、Y坐标、宽度、高度、窗口ID。

wmv - 窗口移动

$ wmv 50 30 0x02000001

wmv相对移动窗口，参数为：X偏移量、Y偏移量、窗口ID。

wrs - 窗口调整大小

$ wrs 100 50 0x02000001

wrs调整窗口大小，参数为：宽度增量、高度增量、窗口ID。

窗口管理工具

这些工具处理窗口的显示、隐藏和焦点控制：

mapw - 显示/隐藏窗口

$ mapw -u 0x02000001 # 隐藏窗口 $ mapw -m 0x02000001 # 显示窗口

wtf - 窗口焦点设置

$ wtf 0x02000001

wtf将焦点切换到指定窗口，是窗口切换的利器。

killw - 关闭窗口

$ killw 0x02000001

killw关闭指定窗口，支持批量操作。

🎯 实用场景与脚本示例

场景一：窗口居中显示

这是一个非常实用的脚本，可以将当前焦点窗口居中显示：

#!/bin/bash # 获取当前焦点窗口 WID=$(pfw) # 获取窗口尺寸 WW=$(wattr w $WID) WH=$(wattr h $WID) # 获取屏幕尺寸 ROOT=$(lsw -r) SW=$(wattr w $ROOT) SH=$(wattr h $ROOT) # 计算居中位置并移动窗口 wtp $(((SW - WW)/2)) $(((SH - WH)/2)) $WW $WH $WID

场景二：平铺窗口布局

实现简单的两栏平铺布局：

#!/bin/bash # 获取所有窗口列表 WINDOWS=($(lsw)) # 获取屏幕尺寸 ROOT=$(lsw -r) SW=$(wattr w $ROOT) SH=$(wattr h $ROOT) # 计算每个窗口的位置和大小 COUNT=${#WINDOWS[@]} WIDTH=$((SW / COUNT)) for i in "${!WINDOWS[@]}"; do X=$((i * WIDTH)) wtp $X 0 $WIDTH $SH ${WINDOWS[$i]} done

场景三：窗口快速切换

创建快捷键快速切换窗口：

#!/bin/bash # 获取当前焦点窗口 CURRENT=$(pfw) # 获取所有窗口 WINDOWS=($(lsw)) # 查找下一个窗口 FOUND=0 for WINDOW in "${WINDOWS[@]}"; do if [ $FOUND -eq 1 ]; then wtf $WINDOW exit 0 fi if [ "$WINDOW" = "$CURRENT" ]; then FOUND=1 fi done # 如果当前是最后一个窗口，切换到第一个 if [ ${#WINDOWS[@]} -gt 0 ]; then wtf ${WINDOWS[0]} fi

📁 项目文件结构解析

了解项目结构有助于深入理解工具的实现原理：

core/ ├── pfw.c # 打印焦点窗口源码 ├── wattr.c # 窗口属性查询源码 ├── wtp.c # 窗口传送源码 ├── wmv.c # 窗口移动源码 ├── wrs.c # 窗口调整大小源码 ├── lsw.c # 列出窗口源码 ├── mapw.c # 显示/隐藏窗口源码 ├── wtf.c # 窗口焦点设置源码 ├── killw.c # 关闭窗口源码 ├── chwb.c # 修改窗口边框源码 ├── chwso.c # 修改窗口堆叠顺序源码 ├── ignw.c # 忽略/取消忽略窗口源码 ├── atomx.c # 修改窗口原子属性源码 ├── pdw.c # 打印装饰窗口源码 ├── slw.c # 交互式选择窗口源码 ├── wmp.c # 移动鼠标指针源码 ├── util.c # 通用工具函数 ├── util.h # 头文件 └── man/ # 手册页目录

🔍 高级技巧与最佳实践

1. 结合sxhkd创建快捷键

wmutils/core与sxhkd热键守护进程完美配合：

# ~/.config/sxhkd/sxhkdrc super + c wtp 0 0 50% 100% $(pfw) super + shift + c wtp 50% 0 50% 100% $(pfw) super + f wtp 0 0 100% 100% $(pfw)

2. 批量操作技巧

使用shell循环批量操作窗口：

# 将所有窗口最小化 for WINDOW in $(lsw); do mapw -u $WINDOW done # 将所有窗口边框设置为红色 for WINDOW in $(lsw); do chwb -c ff0000 $WINDOW done

3. 错误处理与调试

在脚本中添加错误检查：

#!/bin/bash set -e # 遇到错误立即退出 WID=$(pfw) if [ $? -ne 0 ]; then echo "无法获取焦点窗口" exit 1 fi # 检查窗口是否存在 if ! wattr $WID > /dev/null 2>&1; then echo "窗口不存在" exit 1 fi # 执行操作 wtp 100 100 800 600 $WID

🚀 性能优化建议

减少XCB调用次数

每个工具都会建立独立的XCB连接，频繁调用会影响性能。建议：

1. 批量操作：将多个操作合并到一个脚本中
2. 缓存结果：将频繁使用的窗口ID保存在变量中
3. 使用管道：通过管道传递窗口ID，避免重复获取

示例优化代码

#!/bin/bash # 优化前：多次调用pfw wtp 0 0 800 600 $(pfw) sleep 1 wmv 100 100 $(pfw) # 优化后：一次获取，多次使用 WID=$(pfw) wtp 0 0 800 600 $WID sleep 1 wmv 100 100 $WID

📚 学习资源与进阶路径

官方文档

每个工具都有详细的手册页，使用man命令查看：

man pfw man wattr man wtp

源码学习

如果你想深入了解实现原理，可以阅读源码文件：

• util.h - 通用工具函数头文件
• util.c - 通用工具函数实现
• wattr.c - 窗口属性查询实现

社区资源

• 官方IRC频道: #wmutils @irc.freenode.net
• 问题报告: 在项目仓库创建Issue
• 贡献代码: 提交Pull Request前请先创建Issue

💡 常见问题解答

Q: 为什么某些工具执行后没有效果？A: 确保你有正确的窗口权限，某些窗口管理器可能会限制对窗口的操作。

Q: 如何获取特定应用程序的窗口ID？A: 可以使用lsw配合grep过滤，或者使用slw交互式选择。

Q: 工具返回"focus not set"错误怎么办？A: 这表示当前没有获得焦点的窗口，尝试先点击一个窗口再执行命令。

Q: 如何调试脚本中的问题？A: 在脚本开头添加set -x可以显示执行的每一条命令。

🎉 总结

wmutils/core提供了一套简单而强大的窗口操作工具集，通过组合这些工具，你可以实现复杂的窗口管理功能。无论是简单的窗口居中，还是复杂的平铺布局，wmutils/core都能轻松应对。

记住这些核心工具：

• 信息获取: pfw, wattr, lsw
• 位置控制: wtp, wmv, wrs
• 窗口管理: mapw, wtf, killw

开始尝试编写你自己的窗口管理脚本吧！从简单的居中功能开始，逐步探索更复杂的布局方案。wmutils/core的简洁设计让窗口操作变得前所未有的简单和高效。🚀

【免费下载链接】coreSet of window manipulation tools项目地址: https://gitcode.com/gh_mirrors/core106/core