# directory_list_tray

**Repository Path**: joeloon/directory_list_tray

## Basic Information

- **Project Name**: directory_list_tray
- **Description**: 常驻托盘的目录列表程序，起到目录收藏夹的作用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 目录列表托盘程序

一个轻量级的 Windows 系统托盘应用，用于快速访问常用目录。

## 功能特点

- 📂 **快速访问**: 通过系统托盘菜单快速打开常用目录
- 📁 **层级显示**: 支持通过缩进显示目录层级关系
- 🔄 **热重载**: 双击托盘图标或点击菜单项重新加载配置
- ⚠️ **路径检测**: 自动检测路径是否存在，不存在的路径显示为灰色
- 📝 **配置编辑**: 一键打开配置文件进行编辑

## 使用方法

### 1. 运行程序

直接运行 `directory_list_tray.exe`，程序会自动最小化到系统托盘。

### 2. 配置文件

在程序所在目录创建 `config.txt` 文件，格式如下：

```txt
# 这是注释行，以 # 开头
# 支持两种格式：

# 格式1：直接写目录路径
D:\Projects\MyApp

# 格式2：自定义显示名称 [显示名称](目录路径)
[我的项目](D:\Projects\MyApp)

# 支持层级缩进（空格或Tab）
  D:\Projects\MyApp\src
    D:\Projects\MyApp\src\components
  D:\Projects\MyApp\docs
```

### 3. 操作说明

| 操作 | 效果 |
|------|------|
| 左键单击托盘图标 | 显示菜单 |
| 右键单击托盘图标 | 显示菜单 |
| 双击托盘图标 | 重新加载配置 |
| 点击菜单项 | 打开对应目录 |

## 配置文件格式说明

### 基本语法

- **注释行**: 以 `#` 开头的行为注释，不会被解析
- **空行**: 空行或纯空白行将被忽略
- **缩进**: 使用空格或 Tab 进行缩进，Tab 会自动转换为 4 个空格对齐

### 两种配置格式

#### 格式一：直接路径

```txt
D:\Projects\MyApp
```

显示名称为路径本身，点击打开该目录。

#### 格式二：自定义显示名称

```txt
[我的项目](D:\Projects\MyApp)
```

显示名称为括号内的文字，点击打开括号中的路径。

### 层级显示示例

```txt
# 一级目录
D:\Projects

# 二级目录（缩进2个空格）
  D:\Projects\App1
  D:\Projects\App2

# 三级目录（缩进4个空格）
    D:\Projects\App1\src
```

## 编译方法

### 环境要求

- MinGW (GCC for Windows)
- 支持 Windows API

### 编译命令

使用提供的批处理脚本编译：

```bash
build_with_icon.bat
```

或手动编译：

```bash
# 编译资源文件
windres resource.rc -o resource.o

# 编译主程序
gcc -o directory_list_tray.exe main.c resource.o -luser32 -lshell32

# 清理临时文件
del resource.o
```

## 文件结构

```
directory_list_tray/
├── main.c           # 主程序源码
├── resource.rc      # 资源文件（图标）
├── icon_dirlist.ico # 托盘图标
├── config.txt       # 配置文件（需手动创建）
├── config.txt.example # 配置示例
├── build_with_icon.bat # 编译脚本
├── 程序说明.md       # 中文说明
├── 设置-开机自动启动.reg    # 开机自启注册表文件
├── 设置-取消开机自动启动.reg # 取消开机自启注册表文件
└── directory_list_tray.exe # 编译后的可执行文件
```

## 注意事项

1. 程序使用单实例运行，再次启动会显示已有实例的菜单
2. 配置文件必须位于程序所在目录，命名为 `config.txt`
3. 路径不存在时，菜单项显示为灰色且不可点击
4. 双击托盘图标可快速重新加载配置，无需打开菜单

## 许可证

本项目采用 **MIT License** 开源协议。

### MIT License 摘要

MIT 许可证是一种宽松的开源许可证，允许你：

- ✅ 自由使用、复制、修改和分发软件
- ✅ 将软件用于商业目的
- ✅ 将修改后的代码作为闭源软件发布

**唯一要求**：在所有副本或实质性部分中保留原始版权声明和许可声明。

### 完整许可文本

```
MIT License

Copyright (c) 2026 Directory List Tray App

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```