# wezterm-config

**Repository Path**: wolfox/wezterm-config

## Basic Information

- **Project Name**: wezterm-config
- **Description**: wezterm的配置
- **Primary Language**: Lua
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WezTerm 配置文件

模块化的 WezTerm 终端配置文件，支持自定义外观、键位绑定、字体、背景图片等功能。

## 项目结构

```
wezterm-config/
├── wezterm.lua              # 主配置文件（入口）
├── AGENTS.md                # 架构文档
├── config/                  # 配置模块目录
│   ├── advanced.lua         # 高级配置（滚动等）
│   ├── appearance.lua       # 外观与配色方案
│   ├── background.lua       # 动态背景图片
│   ├── constants.lua        # 常量定义
│   ├── cursor.lua           # 光标样式
│   ├── events.lua           # 事件处理
│   ├── fonts.lua            # 字体配置
│   ├── hyperlink.lua        # 超链接规则
│   ├── keybindings.lua      # 键位绑定
│   ├── launch_menu.lua      # 启动菜单
│   ├── mouse.lua            # 鼠标配置
│   ├── shell.lua            # Shell 配置
│   ├── ssh_domains.lua      # SSH 域名配置
│   ├── tab_bar.lua          # 标签栏样式
│   ├── utils.lua            # 工具函数
│   └── window.lua           # 窗口配置
├── fonts/                   # 字体文件
│   └── MapleMono-NF-CN-Regular.ttf
└── images/                  # 背景图片
    └── *.jpg
```

## 功能特性

- **模块化配置** - 采用模块化设计，便于维护和扩展
- **动态背景** - 支持随机切换背景图片
- **自定义主题** - 多种配色方案可选
- **个性化键位** - 自定义快捷键绑定
- **SSH 域名管理** - 便捷的 SSH 连接配置
- **启动菜单** - 快速启动常用程序

## 安装

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/wolfox/wezterm-config.git ~/.config/wezterm
   ```

2. 或将文件复制到 WezTerm 配置目录：
   - Linux/macOS: `~/.config/wezterm/`
   - Windows: `%USERPROFILE%\.config\wezterm\`

3. 确保 `wezterm.lua` 链接或复制到配置目录的根目录

## 使用方法

配置文件会自动加载 `config/` 目录下的所有模块。如需自定义修改：

### 修改配色方案

编辑 `config/appearance.lua` 文件。

### 修改键位绑定

编辑 `config/keybindings.lua` 文件。

### 添加背景图片

将图片放入 `images/` 目录，配置会自动加载。

### 修改字体

编辑 `config/fonts.lua` 或在 `fonts/` 目录添加字体文件。

## 配置模块说明

| 模块 | 功能 |
|------|------|
| `advanced.lua` | 滚动条、警告等高级设置 |
| `appearance.lua` | 配色方案、透明度等外观设置 |
| `background.lua` | 背景图片轮播逻辑 |
| `cursor.lua` | 光标样式和闪烁设置 |
| `events.lua` | 窗口事件处理 |
| `fonts.lua` | 字体家族和大小 |
| `keybindings.lua` | 键盘快捷键 |
| `launch_menu.lua` | 右键启动菜单 |
| `mouse.lua` | 鼠标行为配置 |
| `shell.lua` | 默认 Shell 程序 |
| `ssh_domains.lua` | SSH 连接配置 |
| `tab_bar.lua` | 标签栏样式 |
| `utils.lua` | 跨平台工具函数 |
| `window.lua` | 窗口装饰和边距 |

## 依赖

- [WezTerm](https://wezterm.org/) - 终端模拟器
- 字体文件（已包含 Maple Mono NF CN）

## 许可证

本项目仅供个人学习和使用。

## 作者

- Developer: gtiders