# refind-installer-workspace

**Repository Path**: zinface/refind-installer-workspace

## Basic Information

- **Project Name**: refind-installer-workspace
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# rEFInd Custom Workspace

[rEFInd](http://www.rodsbooks.com/refind/) 是一个开源的 UEFI 启动管理器，支持扫描引导项、加载主题、自定义字体等。本项目提供一个工作区，让你在本地修改配置、主题、图标和字体，通过 QEMU 即时预览，满意后再部署到真实 EFI 分区。

## 快速开始

```bash
# 1. 挂载你的 EFI 分区到工作区
sudo mount --bind /boot/efi/ mount/boot/efi

# 2. 运行 QEMU 预览（首次会自动安装 rEFInd）
./start.sh
```

> `mount/boot/efi` 是工作区挂载点，`.gitignore` 已忽略其内容，不会提交你的 EFI 分区数据。

## 工作区结构

```
refind-custome/
├── refind.conf          # rEFInd 主配置（编辑此文件）
├── themes/              # 主题目录
│   ├── dm/
│   ├── rEFInd/
│   ├── rEFInd-glassy/
│   └── rEFInd-minimal/
├── icons/               # 自定义系统图标
├── fonts/               # 自定义字体（.png 位图字体）
├── mount/boot/efi/      # EFI 分区挂载点（勿手动编辑）
└── start.sh             # 启动 QEMU 预览
```

## 定制指南

### 1. 修改配置

编辑 `refind.conf`，常用配置：

```conf
timeout 10                     # 启动菜单超时
resolution auto                # 分辨率
font liberation-mono-regular-14.png  # 字体

# 加载主题（取消注释即可启用）
include themes/dm/theme.conf
# include themes/rEFInd-minimal/theme.conf
```

### 2. 启用主题

```bash
# 在 refind.conf 中取消注释对应 include 行
include themes/dm/theme.conf
```

### 3. 添加自定义图标

rEFInd 通过 `os_<系统名>.png` 匹配系统图标，但部分发行版或特殊系统没有默认图标。`icons/` 目录用于补充这些缺失的图标，也可为同色系主题提供视觉区分的定制图标。

图标尺寸要求 `128x128`，使用 `convert.sh` 中的函数处理：

```bash
./convert.sh  # 批量转换预置图标
# 或单独调用：
convert_icon <输入.png> <输出.png>
```

### 4. 添加字体

将 `.png` 位图字体放入 `fonts/`，在 `refind.conf` 中通过 `font` 指令引用。

### 5. 预览

```bash
./start.sh
```

脚本会：
- 检查挂载点是否存在 EFI 目录
- 自动安装 rEFInd（如未安装）
- 同步 `refind.conf`、`fonts/`、`themes/`、`icons/` 到挂载点
- 启动 QEMU + OVMF 模拟 UEFI 环境

## 注意事项

`sudo mount --bind /boot/efi/ mount/boot/efi` 后，`start.sh` 的配置同步操作直接作用于你的真实 EFI 分区（bind mount 即是同一份数据）。不过修改范围仅限于 `mount/boot/efi/EFI/refind/` 目录，不会影响现有的 Windows 或其他 Linux 引导项。

## 依赖

- qemu-system-x86_64
- OVMF（UEFI 固件）
- 支持 UEFI 的 Linux 系统