Skip to content

iamcheyan/TWM

BranchesTags

Repository files navigation

TWM：Niri / Sway / labwc / i3 窗口管理器配置

这是一套支持 Niri / Sway / labwc / i3 的桌面配置。Wayland 窗口管理器共享 Waybar、Kitty、Mako、Wofi 和壁纸，窗口管理器配置彼此独立；i3 提供 X11 兼容环境。项目提供一键初始化脚本，完成软链接与字体准备。

一键配置

首次使用只需执行一次脚本，即可创建软链接并安装字体：

mkdir -p ~/.config/TWM
git clone https://github.com/iamcheyan/TWM.git ~/.config/TWM
cd ~/.config/TWM
chmod +x init.sh
./init.sh

脚本会自动备份已有配置并创建链接，Waybar 会根据 WM 自动加载对应配置：

  • ~/.config/waybar/niri/config.jsonc
  • ~/.config/waybar/sway/config.jsonc

依赖安装（按 WM 分开）

Wayland（Niri/Sway）使用 mako，i3（X11）使用 dunst。

Sway

Debian/Ubuntu：

sudo apt update
sudo apt install -y sway waybar kitty swaybg mako wofi fcitx5 \
  brightnessctl grim slurp wl-clipboard libnotify-bin

Fedora：

sudo dnf install -y sway waybar kitty swaybg mako wofi fcitx5 \
  brightnessctl grim slurp wl-clipboard libnotify

Arch：

sudo pacman -S --needed sway waybar kitty swaybg mako wofi fcitx5 \
  brightnessctl grim slurp wl-clipboard libnotify

i3

Debian/Ubuntu：

sudo apt update
sudo apt install -y i3 polybar rofi feh xterm dunst fcitx5 \
  maim xclip libnotify-bin x11-xserver-utils x11-xkb-utils

Fedora：

sudo dnf install -y i3 rofi feh xterm dunst fcitx5 \
  maim xclip libnotify polybar xrandr xorg-x11-xkb-utils

Arch：

sudo pacman -S --needed i3 rofi feh xterm dunst fcitx5 \
  maim xclip libnotify polybar xorg-xrandr xorg-setxkbmap

界面截图

TWM Desktop Screenshot 1

TWM Desktop Screenshot 2

目录结构

~/.config/TWM/
├── niri/                  # Niri 配置
│   └── config.kdl
├── sway/                  # Sway 配置
│   ├── config
│   └── README.md
├── labwc/                 # labwc 配置与 WSL 启动脚本
│   ├── rc.xml
│   ├── menu.xml
│   └── wsl-boot
├── i3/                    # i3 配置
│   └── config
├── polybar/               # Polybar 配置（i3 可选）
│   ├── config.ini
│   ├── launch.sh
│   └── scripts/
├── waybar/                # Waybar 配置（按 WM 区分）
│   ├── niri/config.jsonc
│   ├── sway/config.jsonc
│   └── style.css
├── kitty/                 # Kitty 终端配置
├── mako/                  # Mako 通知配置
├── wofi/                  # Wofi 启动器配置
├── background/            # 壁纸（默认 background.png，WSL 使用 windows11.jpg）
├── init.sh                # 一键初始化脚本（软链接 + 字体）
└── push.sh

通用模块（Niri / Sway 共用）

  • Waybar
  • Kitty
  • Mako
  • Wofi
  • 默认背景图片 background/background.png
  • WSL 环境背景图片 background/windows11.jpg
  • 通过 set-wallpaper 自动选择并启动壁纸
  • 初始化脚本 init.sh

软链接清单

脚本会在目标目录已有文件时自动备份，然后创建链接：

  • ~/.config/niri → ~/.config/TWM/niri
  • ~/.config/sway → ~/.config/TWM/sway
  • ~/.config/labwc → ~/.config/TWM/labwc
  • ~/.config/i3 → ~/.config/TWM/i3
  • ~/.config/waybar → ~/.config/TWM/waybar
  • ~/.config/kitty → ~/.config/TWM/kitty
  • ~/.config/mako → ~/.config/TWM/mako
  • ~/.config/wofi → ~/.config/TWM/wofi

labwc（WSL）

~/.config/labwc/wsl-boot
  • 桌面右键或 Alt + Space：主菜单
  • Alt + D：应用启动器
  • Alt + Return：终端
  • Alt + Q：关闭窗口
  • Alt + Left/Right：切换工作区
  • 点击 Waybar 左侧图标：应用启动器
  • 点击 Waybar 右侧电源图标：系统操作

Niri 使用方法

启动 Niri 后会自动拉起：

  • Waybar（~/.config/waybar/niri/config.jsonc）
  • swaybg（壁纸）
  • fcitx5
  • mako

Niri 快捷键

快捷键 功能
Super + Enter 打开 Kitty
Super + D 打开 Wofi
Super + Q 关闭窗口
Super + Ctrl + Alt + Shift + Q 退出 Niri
Super + Left/Right 焦点左/右列
Super + Shift + Left/Right 移动列到左/右（或显示器）
Super + F 全屏切换
Super + A Overview 模式
Super + Shift + H/L/K/J 调整窗口宽高 (-/+10%)
Super + 1..5 切换工作区 1..5
Super + Tab 下一个工作区
Super + Shift + Tab 上一个工作区
Alt + Tab 当前工作区窗口切换
Alt + Shift + Tab 反向切换
`Alt + `` 当前应用窗口切换
PrtSc 全屏截图到剪贴板
Alt + PrtSc 全屏截图保存到 Downloads
Shift + PrtSc 选区截图保存到 Downloads
Alt + A 选区截图到剪贴板

Sway 使用方法

启动 Sway 后会自动拉起：

  • Waybar（~/.config/waybar/sway/config.jsonc）
  • swaybg（壁纸）
  • fcitx5

窗口切换器脚本：sway/scripts/window_switcher.sh（Super + W）

WSL 测试

WSL 下只用于测试配置时，使用专用入口：

~/.config/sway/wsl-boot

这个入口单独加载 ~/.config/sway/config-wsl，不会影响普通 Sway 配置。首次启动会请求 sudo，卸载 WSLg 的只读 /tmp/.X11-unix，并以 1777 权限重新创建，让 Sway 启动自己的 Xwayland。随后会自动使用 ~/.config/waybar/sway-wsl/config.jsonc，跳过 WSL 中不可用的托盘、电源配置、RFKILL 网络检测和 fcitx/rime 启动。

WSL 配置把主修饰键从 Super 改为 Alt。为避开 Windows 全局快捷键，窗口切换改为 Ctrl+Tab / Ctrl+Shift+Tab，工作区前后切换改为 Alt+] / Alt+[.

Sway 内部窗口会显示标题栏。WSLg 外层窗口由 Windows 管理，可以使用 Win+Up 最大化，或使用 Win+Shift+Left/Right 移动到其他显示器。

Sway 快捷键

快捷键 功能
Super + Enter 打开 Kitty
Super + D 打开 Wofi
Super + W 窗口切换器
Super + Q 关闭窗口
Super + F 全屏切换
Alt + Tab 当前工作区窗口切换
Alt + Shift + Tab 反向切换
Super + Tab 下一个工作区
Super + Shift + Tab 上一个工作区
Super + H/J/K/L 焦点左/下/上/右
Super + ←/→/↑/↓ 移动窗口
Super + 1..0 切换工作区 1..0
Super + Shift + 1..0 移动窗口到工作区
PrtSc 全屏截图到剪贴板
Alt + PrtSc 全屏截图保存到 Downloads
Shift + PrtSc 选区截图保存到 Downloads
Alt + A 选区截图到剪贴板

Sway 模式快捷键

快捷键 功能
Super + M 进入移动模式（h/j/k/l 或方向键移动）
Super + R 进入调整大小模式（h/j/k/l，Shift 为大步）
Super + P 进入 Panel 模式（a/s 切换，x 关闭，f 全屏）
Super + T Tab 模式（h/l 切换，x 关闭，Tab 布局切换）
Super + A Workspace 模式（数字/字母切换，n/m 前后）

i3 使用方法

启动 i3 后会自动拉起：

  • polybar（替代 i3bar）
  • feh（壁纸）
  • fcitx5
  • dunst 注：i3 使用 xrandr 做缩放，数值是对 sway fractional scale 的近似，可按需微调。 首次使用可运行脚本自动选择输出与缩放，并写入本地配置：
~/.config/TWM/i3/scripts/setup-xrandr-scale.sh

i3 快捷键（与 Sway 尽量一致）

快捷键 功能
Super + Enter 打开 Kitty
Super + D 打开 rofi
Super + Q 关闭窗口
Super + F 全屏切换
Alt + Tab 当前工作区窗口切换
Alt + Shift + Tab 反向切换
Super + Tab 下一个工作区
Super + Shift + Tab 上一个工作区
Super + H/J/K/L 焦点左/下/上/右
Super + ←/→/↑/↓ 移动窗口
Super + 1..0 切换工作区 1..0
Super + Shift + 1..0 移动窗口到工作区
PrtSc 全屏截图到剪贴板
Alt + PrtSc 全屏截图保存到 Downloads
Shift + PrtSc 选区截图保存到 Downloads
Alt + A 选区截图到剪贴板

Polybar（尽量对齐 Waybar）

配置文件：~/.config/TWM/polybar/config.ini

启动示例：

polybar -c ~/.config/TWM/polybar/config.ini main

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

36 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages