whatisgithub

What is social-auto-upload?

dreammis/social-auto-upload — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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.

What is it built with?

Python

How does it compare?

dreammis/social-auto-uploadnumba/numbakkroening/ffmpeg-python
Stars11,01011,02010,995
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/52/5
Audiencevibe coderresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is social-auto-upload?

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.

What language is social-auto-upload written in?

Mainly Python. The stack also includes Python.

How hard is social-auto-upload to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is social-auto-upload for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.