A supported computer
macOS, Windows, or Linux with Python 3.9 or newer and a terminal application.
Setup
All SNS Publish is a desktop application you run yourself. It is a command-line app for macOS, Windows, and Linux, so your media, post plans, and platform authorizations never leave your machine. This page lists the requirements and walks through the commands from authorization to a published post.
All SNS Publishは、自分のパソコンで実行するデスクトップアプリです。macOS・Windows・Linuxで動作し、動画・投稿計画・各SNSの認可情報はすべて手元に置いたまま投稿できます。
Before you start
The first three are set up once. After that, publishing a post is a single command.
macOS, Windows, or Linux with Python 3.9 or newer and a terminal application.
The TikTok, YouTube, or X accounts you publish to, and the media files you own or are licensed to publish.
A TikTok application with Login Kit and the Content Posting API enabled, so the app can authorize your creator account.
Setup, authorization, and a first dry run before anything is sent to a platform.
Commands
All SNS Publish is distributed as a Python package for macOS, Windows, and Linux. Email info@michi-gaeru.net to receive the current release and its checksum. Once it is installed, the sns-publish command is available in your terminal.
$ sns-publish --help
The doctor command reports missing settings, unreachable media files, and anything that would stop a post before a platform is contacted.
$ sns-publish doctor --plan ./plans/my_post.yaml
The app opens TikTok's authorization page in your browser. TikTok returns you to our callback page; copy the full URL from the address bar and paste it back into the app. Authorization is completed on your computer.
$ sns-publish auth-tiktok --plan ./plans/my_post.yaml
# paste the URL shown in your browser's address bar when prompted
Preparation shows your creator information, asks you to choose a privacy level with no preselected value, and collects the interaction, commercial-content, AIGC, and music-rights decisions. You can play the selected video before confirming.
$ sns-publish tiktok-prepare --plan ./plans/my_post.yaml \
--open-media --output ./plans/my_post.prepared.yaml
Run a dry run first to see exactly what would be sent. When it looks right, publish and wait for TikTok's final status.
$ sns-publish publish --plan ./plans/my_post.prepared.yaml --dry-run
$ sns-publish publish --plan ./plans/my_post.prepared.yaml --wait-tiktok-status
$ sns-publish history --platform tiktok
Disconnecting
One command revokes the TikTok authorization and deletes the stored credential from your computer. You can also remove the app from TikTok's connected-app settings at any time.
$ sns-publish revoke-tiktok --delete-local-token
These pages are static documentation. No authorization, upload, or posting happens in your browser.
Read the Help and FAQ or email info@michi-gaeru.net.
Keep reading
The pages below describe the same creator-controlled flow the commands above perform.