m1ngsama/TUT
1
0
Fork 0
mirror of https://github.com/m1ngsama/TUT.git synced 2025-12-24 10:51:46 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
25 commits 10 branches 7 tags 372 KiB
C++ 97.3%
HTML 1.1%
CMake 0.9%
Makefile 0.7%
Find a file
m1ngsama 8e291399ae feat: Add newspaper-style text rendering engine 
Implement text renderer with adaptive layout:
- Adaptive width with maximum 80 characters
- Center-aligned content for comfortable reading
- Smart text wrapping and paragraph spacing
- Color scheme optimized for terminal reading
- Support for headings, paragraphs, lists, and links
- Link indicators with numbering
- Horizontal rules and visual separators

The renderer creates a newspaper-like reading experience
optimized for terminal displays.
2025-12-05 14:59:17 +08:00
.github/workflows fix: Add contents write permission for release job 2025-11-20 11:50:43 +08:00
src feat: Add newspaper-style text rendering engine 2025-12-05 14:59:17 +08:00
.gitignore Add build/ to .gitignore and remove build directory from Git tracking. 2025-11-19 17:32:41 +08:00
CMakeLists.txt ci: Auto release on push to main with multi-platform builds 2025-11-20 11:45:50 +08:00
README.md docs: Add developer guide to README.md 2025-11-19 17:58:34 +08:00

README.md

TUT - TUI Utility Tools (WIP)

This project, "TUT," is a collection of TUI (Terminal User Interface) utility modules written in C++. The initial focus is on the integrated ICS Calendar Module. This module fetches, parses, and displays iCal calendar events from https://ical.nbtca.space/nbtca.ics using ncurses to show upcoming activities within the next month.

依赖

  • CMake ≥ 3.15
  • C++17 编译器（macOS 上建议 clang）
  • ncurses
  • libcurl

在 macOS (Homebrew) 安装依赖

brew install cmake ncurses curl

构建

在项目根目录执行：

mkdir -p build
cd build
cmake ..
cmake --build .

生成的可执行文件为 nbtca_tui。

运行

在 build 目录中运行：

./nbtca_tui

程序会：

  1. 通过 libcurl 请求 https://ical.nbtca.space/nbtca.ics
  2. 解析所有 VEVENT 事件，提取开始时间、结束时间、标题、地点、描述
  3. 过滤出从当前时间起未来 30 天内的事件
  4. 使用 ncurses TUI 滚动展示列表

TUI 操作说明

  • ↑ / ↓：上下移动选中事件
  • q：退出程序

Developer Guide

For contributors and developers, follow these guidelines:

  1. Clone the Repository: 
    git clone https://github.com/m1ngsama/TUT.git
cd TUT
  2. Build Environment Setup: Ensure all Dependencies are installed.
  3. Local Build: Follow the 构建 instructions.
  4. Code Style: Adhere to the existing code style in src/.
  5. Testing: Currently, there are no automated tests. Please manually verify changes.
  6. Contributing: Submit Pull Requests for new features or bug fixes.

版本 (Version)

  • v0.0.1