social-auto-upload: one-click multi-platform video distribution

Publishing the same short video to Douyin, Bilibili, and Xiaohongshu usually means logging in, filling out a title, and uploading a file three separate times. social-auto-upload aims to hand that whole process to a script: written in Python, it drives each platform’s web frontend with browser automation to complete uploads, without relying on official APIs; beyond video, some platforms also support publishing image-and-text posts. GitHubDaily recommended this tool in April 2025.

Core features

• Video upload across eleven platforms: covers nine domestic platforms—Douyin, Kuaishou, Xiaohongshu (RedNote), Bilibili, WeChat Channels, Weibo, Baijiahao, Alipay Life Account, and Hupu—plus TikTok and YouTube.
• Image-and-text posts: Douyin, Xiaohongshu, and Kuaishou support image-and-text publishing; the rest are primarily video-focused.
• Scheduled publishing: Douyin, Bilibili, Xiaohongshu, Kuaishou, WeChat Channels, and TikTok support scheduling; scheduled times are mostly computed as “the next day,” so publishing immediately requires adjusting this yourself.
• Multi-account management: each account_name is tied to its own account file, and tasks can run concurrently per account, making it easy to run several accounts at once.
• Unified command line: sau provides a consistent set of login, verification, and upload subcommands for platforms it has integrated with the CLI (image-and-text posts use upload-note; TikTok isn’t wired into the CLI yet).
• AI agent integration: built-in upload skills for platforms like Douyin, Kuaishou, Xiaohongshu, and Bilibili can be handed off to agents such as Claude Code or Codex.

Typical use cases

• Distribute a finished video to multiple platforms in one click, skipping the repetitive work of uploading to each one manually.
• Matrix-style operation: maintain separate configs for accounts on multiple platforms and run each account’s scheduled publishing tasks in batch.
• Hand high-frequency operations like login and upload to an AI agent, which calls the built-in skills to run the whole flow.

Quick start

Clone the repo, set up a virtual environment with uv, and register the CLI (see the install docs for details):

git clone https://github.com/dreammis/social-auto-upload.git && cd social-auto-upload
uv venv && uv pip install -e . && patchright install chromium
cp conf.example.py conf.py

Log in to an account first, then run an upload:

sau douyin login --account <account_name>
sau douyin upload-video --account <account_name> --file videos/demo.mp4 --title "Sample title" --desc "Sample description"

Summary

This suits short-video creators and multi-account matrix operators, as well as independent developers who want to script the upload process and hand it to an agent. The project is MIT licensed and can be used in closed-source commercial software; because it relies on browser automation rather than official APIs, it needs a real account per platform via QR-code or cookie login, and publishing on Douyin may trigger SMS two-factor verification. Platform capabilities also aren’t uniform: TikTok has no CLI yet, and some platforms lack scheduling or image-and-text support; the author also acknowledges past maintenance was insufficient and the project is currently in a period of heavy refactoring, with official docs admittedly lagging behind—it’s worth validating on a small scale before adopting it.