Riverwm 项目使用教程

Riverwm 项目使用教程

riverwmRiver dotfiles. Catppuccin项目地址:https://gitcode.com/gh_mirrors/ri/riverwm

1. 项目的目录结构及介绍

riverwm/
├── bin/
│   ├── river
│   └── riverctl
├── doc/
│   ├── river.1
│   └── riverctl.1
├── include/
│   ├── river-protocols.h
│   └── river-util.h
├── protocol/
│   ├── river-control.xml
│   └── river-layout.xml
├── src/
│   ├── compositor.zig
│   ├── layout.zig
│   └── main.zig
├── LICENSE
├── README.md
└── river.svg

• bin/: 包含可执行文件 river 和 riverctl。
• doc/: 包含项目的文档文件，如 river.1 和 riverctl.1。
• include/: 包含头文件，如 river-protocols.h 和 river-util.h。
• protocol/: 包含 Wayland 协议文件，如 river-control.xml 和 river-layout.xml。
• src/: 包含源代码文件，如 compositor.zig、layout.zig 和 main.zig。
• LICENSE: 项目的许可证文件。
• README.md: 项目的介绍和说明文件。
• river.svg: 项目的图标文件。

2. 项目的启动文件介绍

项目的启动文件是 bin/river。这个文件是 Riverwm 的主程序，负责启动 Wayland 合成器并管理窗口布局。

3. 项目的配置文件介绍

Riverwm 的配置主要通过 bin/riverctl 工具进行。用户可以通过 riverctl 命令来设置各种配置，例如：

• 设置键绑定：

  riverctl map normal Super Return spawn alacritty
  

• 设置布局生成器：

  riverctl set-layout rivertile
  

• 配置输入设备：

  riverctl input "1234:5678:Keyboard" xkb-layout us
  

在启动时，Riverwm 会运行用户定义的初始化脚本，通常是 ~/.config/river/init，这个脚本会包含一系列 riverctl 命令来设置用户的配置。

#!/bin/sh

# 设置键绑定
riverctl map normal Super Return spawn alacritty

# 设置布局生成器
riverctl set-layout rivertile

# 配置输入设备
riverctl input "1234:5678:Keyboard" xkb-layout us

通过这些配置，用户可以自定义 Riverwm 的行为和外观。

riverwmRiver dotfiles. Catppuccin项目地址:https://gitcode.com/gh_mirrors/ri/riverwm