dannyzz2/douyin-share

Douyin Self-Share Capture watches a person's own Douyin inbox on the web version of the app and automatically copies anything they share to themselves into a Feishu Base, which is a spreadsheet-like database tool used widely in China. The idea is that when someone forwards a video to their own account from a phone, from Douyin's desktop app, or from the web, this tool notices the new message and turns it into a saved, searchable record, effectively building a personal knowledge base out of videos a person wanted to keep. The tool runs on a computer using Playwright, a browser automation tool, with a persistent browser profile so a login only needs to happen once. When a shared video appears, it clicks the card to find the video's unique ID, then reads and cleans up the caption, removing things like author badges and publish times so only the real title text remains. Once that basic record is saved, a background process takes over: it fetches the exact video file, checks that the audio track is valid, transcribes the video's speech to text using OpenAI's Whisper speech recognition model, converts any Traditional Chinese text to Simplified Chinese, generates a short summary, and writes everything back into the correct row in Feishu. The Feishu record includes fields for title, content type, original link, original text, author or source, summary, capture time, processing status, a deduplication ID, any error message, and a link back into the user's knowledge base. Two additional fields for key points and tags are mentioned as not yet part of this early version. Setup requires Node.js, Python 3.10 or newer, FFmpeg, and a Feishu command-line tool already authenticated with write access to the target table. Summaries can be generated with a mock mode that skips any external AI call, or through an OpenAI-compatible provider such as Agnes AI. The project deliberately avoids fully headless browser mode because it can trigger Douyin's verification pages, instead running a real but hidden browser window. Sensitive files like the environment config, browser profile, and downloaded media are excluded from version control by default. The README does not state a license.