Automatically turn new videos from across platforms into concise, self-improving briefings.

Quick Start · 中文文档 · Supported Platforms

🎬 See it in action

1. Overview

This is a backend service for automatically tracking the channels you follow and summarizing their newly published videos (including older content).

The system periodically checks whether specified creators have released new videos, automatically performs download → transcription → content refinement, and delivers structured, concise summary reports to the configured destination.

This enables you to quickly grasp the core viewpoints and high-frequency insights from a large volume of creator content in a very short amount of time.

1.1 Supported Platforms

Platform	Support	Notes
YouTube	✅	Automatic
Bilibili	✅	Automatic
TikTok	✅	Automatic
Douyin	✅	Automatic (via f2)
📡 Live Stream Recordings	✅ via external tool DouyinLiveRecorder	See below for details
📕 Xiaohongshu	In development
Instagram	In development
Reddit	In development
X	In development

1.2 External Downloader Compatibility

This project is compatible with external downloaders.

Put audio files in the briefing/data/audio directory, or set the downloader’s output directory to briefing/data/audio.
The system will automatically detect and process them.

1.3 Multiple Model Support

1.4 Self-Evolving Summaries

Leave a quick note on any report and the summary agent learns from your feedback, getting closer to how you like it over time.

---

2. Feature Preview

2.1 GUI Reading Interface

2.2 Send Summary to Terminal

---

3. Quick Start (No Configuration Required)

3.1 Download

Go to Releases and download the latest build for your OS:

• Windows — briefing-vX.X.X-windows.zip
• macOS — briefing-vX.X.X-macos.dmg

Windows 7 / 8 may require installing Edge WebView2 Runtime

3.2 Install and Run

• Windows — extract to any directory and run briefing.exe.
• macOS — open the .dmg and drag Briefing into Applications. On first launch (the app isn't notarized): double-click it, then go to System Settings ▸ Privacy & Security and click Open Anyway. After that, just double-click normally.

3.3 LLM API Configuration (Required)

3.4 Source URL Format

• YouTube: https://www.youtube.com/@example/videos
• BiliBili: https://space.bilibili.com/example/upload/video
• TikTok: https://www.tiktok.com/@example
• Douyin: https://v.douyin.com/example/

3.5 Browser Cookies (Recommended)

For content that requires login (e.g. Bilibili / Douyin homepages), just log into the site in any installed browser (Safari / Edge / Firefox / Chrome). On each run the downloader automatically reads and merges cookies from all of them into cookies.txt — no manual export needed.

3.6 ntfy Notifications (Optional)

This project uses ntfy as the message delivery channel.

You only need to choose a unique string as your topic, for example: https://ntfy.sh/example123

Summary reports can be read by opening this URL in a browser.

4. Run From Source (Developers)

Environment requirement: Python 3.10 (Python 3.8 and 3.9 are not supported.)

git clone https://github.com/YutaiGu/briefing.git
cd briefing
conda create -n briefing python=3.10
conda activate briefing
pip install -r requirements.txt
python launcher.py

5. Feedback & Contributions

The project is under active development.
Feedback is welcome — feel free to open an Issue for usage feedback, bug reports, or feature requests.

---

This project is not affiliated with or endorsed by any third-party downloaders or platforms. Users are responsible for complying with the terms of service of the respective platforms.