# freenote

**Repository Path**: maccliu/freenote

## Basic Information

- **Project Name**: freenote
- **Description**: 随手记
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-11
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FreeNote - 随手记录工具

一个简单实用的Python Tkinter文本记录工具，支持快速记录文本和Markdown内容。

## 功能特点

- 🚀 **快速记录** - 简洁的界面，专注于内容记录
- 📝 **自动命名** - 按照 `MMDD_hhmmss.txt/md` 格式自动命名文件
- ⚙️ **灵活配置** - 可自定义保存目录和默认格式
- 🎯 **格式支持** - 支持保存为 `.txt` 或 `.md` 格式
- ⌨️ **快捷键** - `Ctrl+S` 保存，`Ctrl+N` 清空

## 安装运行

### 环境要求

- Python 3.6+
- Tkinter (通常随Python安装)

### 运行程序

```bash
python freenote.py
```

## 使用说明

### 基本操作

1. 启动程序后，在文本区域输入内容
2. 在工具栏中：
   - 设置保存目录（可直接编辑或点击【选择】浏览）
   - 编辑文件名（支持模板变量，点击【模板】查看帮助）
   - 选择保存格式（txt 或 md）
3. 点击"保存"按钮或按 `Ctrl+S`
4. 保存时模板变量会自动替换为实际时间，文件保存到指定目录

### 配置设置

- 点击"设置"按钮可以：
  - 设置默认文件格式
  - 其他选项配置
- 保存目录和文件名模板可直接在工具栏修改
- **自动保存配置** - 目录框或文件名框失去焦点时自动保存到配置文件
- 配置保存在 `freenote.ini` 文件中

### 文件命名规则

支持使用模板变量自动生成文件名：

#### 模板变量
- `<YYYY>` - 四位年份 (如: 2024)
- `<MM>` - 两位月份 (如: 12)
- `<DD>` - 两位日期 (如: 25)
- `<hh>` - 两位小时 (如: 14)
- `<mm>` - 两位分钟 (如: 30)
- `<ss>` - 两位秒数 (如: 22)

#### 示例模板
- `<MM><DD>_<hh><mm><ss>.txt` → `1225_143022.txt`
- `note_<YYYY><MM><DD>.md` → `note_20241225.md`
- `<YYYY>年<MM>月<DD>日笔记.txt` → `2024年12月25日笔记.txt`

点击工具栏的"模板"按钮可查看帮助信息。

## 配置文件

`freenote.ini` 采用INI格式：

```ini
[settings]
directory = ./notes                     # 保存目录
filename = <MM><DD>_<hh><mm><ss>.txt   # 文件名模板
format = txt                           # 默认格式 (txt/md)
```

## 快捷键

- `Ctrl+S` - 保存当前内容

## 项目结构

```
freenote/
├── freenote.py          # 主程序
├── freenote.ini         # 配置文件
├── notes/              # 默认笔记目录
└── README.md           # 说明文档
```

## 特性说明

### 界面布局

- **工具栏** - 目录框【选择】/ 文件名框【模板】/ 格式选择 / 保存按钮
  - 目录框和文件名框可缩放，比例为1:2
  - 可直接编辑保存目录和文件名
  - 点击【选择】按钮可浏览选择目录
  - 点击【模板】按钮查看模板变量帮助
- **编辑区** - 多行文本编辑器，支持滚动
- **状态栏** - 显示保存路径和文件统计

### 安全特性

- 保存前检查内容是否为空
- 保存后询问是否清空当前内容
- 清空前确认操作
- 目录和文件名模板自动保存到配置文件
- 目录创建失败时自动恢复原设置

### 扩展性

代码结构清晰，易于扩展：

- 可添加更多文件格式支持
- 可实现自动保存功能
- 可添加搜索和历史记录功能

## 许可证

MIT License