explaingit

dreammis/social-auto-upload

11,010PythonAudience · vibe coderComplexity · 3/5Setup · moderate

TLDR

Python command-line tool that automatically publishes videos and image posts to Douyin, Bilibili, TikTok, and other platforms by driving a browser in the background, no public API required.

Mindmap

mindmap
  root((social-auto-upload))
    What it does
      Auto video upload
      Multi-platform post
      Scheduled publish
    Platforms
      Douyin TikTok
      Bilibili
      Xiaohongshu
      Kuaishou
    How it works
      Browser automation
      Headless mode
      CLI interface
    Tech stack
      Python
      Browser driver
      Command line
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Upload the same video to Douyin, Bilibili, and Kuaishou in one command without logging in manually each time.

USE CASE 2

Schedule a TikTok video to publish at a specific future time from a server with no visible browser window.

USE CASE 3

Manage multiple accounts per platform and choose which account to post from via a CLI flag.

Tech stack

Python

Getting it running

Difficulty · moderate Time to first run · 30min

Requires running a one-time browser login command per platform and account before uploads can be automated.

In plain English

social-auto-upload is a Python tool for automatically publishing videos and image posts to multiple social media platforms from a single command. The platforms it supports include Douyin (the Chinese version of TikTok), Bilibili (a Chinese video platform popular for anime, gaming, and general content), Xiaohongshu (also called Little Red Book, a Chinese lifestyle and shopping app), Kuaishou (another Chinese short video platform), Tencent's video platform, Baijiahao (Baidu's content platform), and TikTok. The tool works by driving a web browser in the background, logging into each platform, and completing the upload process as if a person were doing it manually. This approach lets it handle platforms that do not offer a public API for third-party uploads. The README notes that the browser runs in headless mode, meaning no visible window appears, making it suitable for running on servers or in automated pipelines. The main interface is a command-line tool called sau. A typical workflow involves running a login command once per platform and account, then calling an upload command with the video file path, title, description, and tags. Scheduled publishing (setting a future release time) is also supported on most platforms. Multiple accounts per platform are supported, identified by an account name you assign. The README is written in Chinese. From the feature table and CLI examples, it is clear that Douyin, Bilibili, Xiaohongshu, and Kuaishou have the most complete support, including both video and image-text post uploads. TikTok and some other platforms are listed as having partial support. The project is currently being refactored. The author notes that the codebase is going through a period of active updates to improve stability and expand platform coverage. It is open source and accepts contributions.

Copy-paste prompts

Prompt 1
Show me the sau CLI commands to log in to Douyin and then upload a video file with a title, description, and tags.
Prompt 2
How do I schedule a Bilibili video upload for a specific future publish time using social-auto-upload?
Prompt 3
Write a Python script that uses social-auto-upload to post the same video file to both Kuaishou and Xiaohongshu.
Prompt 4
How do I configure and switch between multiple Douyin accounts in social-auto-upload?
Prompt 5
What does headless browser mode mean in social-auto-upload and how do I run it on a Linux server without a display?
Open on GitHub → Explain another repo

← dreammis on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.