reeln-plugin-tiktok

A reeln-cli plugin for uploading rendered videos to TikTok.

Install

pip install reeln-plugin-tiktok

Or for development:

git clone https://github.com/StreamnDad/reeln-plugin-tiktok
cd reeln-plugin-tiktok
make dev-install

Configuration

Add the plugin to your reeln config:

{
  "plugins": {
    "enabled": ["tiktok"],
    "settings": {
      "tiktok": {
        "upload_shorts": true,
        "upload_videos": false,
        "client_key": "awxxxxxxxxxxxxxxxx",
        "client_secret_file": "/path/to/tiktok_client_secret.txt",
        "privacy_level": "SELF_ONLY"
      }
    }
  }
}

OAuth Setup

This plugin requires TikTok OAuth2 credentials. For the initial setup:

1. Create a TikTok Developer App at developers.tiktok.com
2. Add scopes: video.upload (inbox/drafts) and optionally video.publish (direct post)
3. Complete the OAuth2 authorization flow to obtain tokens
4. Save the credentials to ~/Library/Application Support/reeln/data/tiktok/oauth.json:

{
  "access_token": "act.xxx",
  "refresh_token": "rft.xxx",
  "expires_at": 1712345678.0,
  "open_id": "xxx",
  "scope": "video.upload,user.info.basic"
}

The plugin automatically refreshes expired tokens using the refresh token.

Config Options

Development

make dev-install    # uv venv + editable install with dev deps
make test           # pytest with 100% coverage
make lint           # ruff check
make format         # ruff format
make check          # lint + mypy + test

License

AGPL-3.0-only