timetable2ics

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #typescript #android #machine-learning #rust #deep-learning #macos #java #awesome #cli #kubernetes

(★ 10)

LLM-powered tool transfer unstructured course table into .ics calendar files that can be imported into Apple, Google, Outlook, and other calendar apps.

timetable2ics 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 大学生课表转 ICS 日历工具

## 项目简介
本项目旨在帮助大学生将教务系统导出的课表文本，快速转换为可导入 Apple/Google/Outlook 等日历应用的 `.ics` 文件。支持 LLM 智能解析、课表预览、节次时间自定义等功能。

## 主要功能
- 粘贴原始课表文本，一键解析为结构化课程数据
- 支持自定义每节课的开始时间、学期起始日、课时长度
- 解析结果可表格预览，确认无误后生成 `.ics` 文件
- 支持自带 LLM API Key 或使用平台公用 Key
- 赞赏码弹窗鼓励支持开发者

## 目录结构
```
timetable2ics/
├── web.py                # Streamlit 网页主入口
├── data.py               # 课表数据结构与生成逻辑
├── main.py               # 示例/命令行入口
├── requirements.txt      # 依赖列表
├── reward_wx.jpg         # 赞赏码图片
├── parserics/            # 解析相关模块
│   ├── llm_parser.py     # LLM 解析接口
│   ├── json_to_courses.py# JSON转Course工具
│   └── ...
├── image/                # 项目配图
│   ├── render.jpg        # 效果图
│   └── apple.jpg         # Apple Maps 说明图
├── usage.md              # 导入/订阅日历说明
├── UESTC.ics             # Apple Maps 示例
└── ...
```

## 安装依赖
建议使用 Python 3.8+，推荐虚拟环境：

```bash
pip install -r requirements.txt
```

## 快速使用
1. 启动网页：
   ```bash
   streamlit run web.py
   ```
2. 在网页中：
   - 粘贴你的课表文本
   - （可选）填写 LLM API Key（如阿里云 DashScope Key），否则自动使用公用 Key
   - 设置学期起始日、每节课时长、每节课开始时间
   - 点击“解析课表”，预览无误后生成并下载 `.ics` 文件

## LLM 公用 Key 与赞赏
- 未填写 API Key 时，系统会自动弹出赞赏码，欢迎支持开发者！
- 公用 Key 仅供体验，建议长期使用时申请自己的 Key。

## 常见问题
- **课表格式不标准/解析失败？**
  - 请尽量粘贴原始教务系统表格文本，或适当调整格式。
- **时间格式错误？**
  - 每节课时间请用 `8:00` 这种格式填写。
- **ics 文件导入失败？**
  - 请参考 `usage.md` 或各大日历应用官方说明。

## iPhone 无法导入 ics 的替代方案
若你在 iPhone 上直接打开 `.ics` 文件仍无法添加到 Apple 日历，可以借助快捷指令完成导入。

[快捷指令](https://www.icloud.com/shortcuts/76e984f27b194fbf9c81044bf8bd0109)@[8isnothing](https://routinehub.co/user/8isnothing)

## 致谢
- [阿里云通义千问](https://dashscope.aliyun.com/) LLM 支持
- 参考自 [python-ical-timetable](https://github.com/junyilou/python-ical-timetable) 等开源项目

---
如有建议或问题，欢迎 Issue 或 PR！

timetable2ics

timetable2ics 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

timetable2ics

timetable2ics 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README