tiktokautouploader

The Fancy_Upload.py script provides several automation features for TikTok management:

• Folder Uploads: Automatically uploads videos from a specific folder in ascending order based on filenames.
• Randomized Intervals: To evade TikTok rate limits, uploads occur at randomized intervals between 6 to 9 hours.
• Post-Upload Management: Successfully uploaded videos are moved to a separate folder to maintain organization.
• Telegram Notifications: The script sends error reports and upload status updates directly to a designated Telegram group.

The search_mode parameter determines how the library locates the sound specified in sound_name:

• 'search' (Default): Searches TikTok globally for the sound by name.
• 'favorites': Searches only within your TikTok account's saved/favorited sounds.

Note: For 'favorites' mode to work, the sound must already be saved to your account before running the script.

To schedule an upload, you must provide both the schedule and optionally the day parameter.

Rules for Scheduling:

• Time Format: Use HH:MM where MM is a multiple of 5 (e.g., 14:05, 14:10).
• Timezone: Use your local time.
• Lead Time: The scheduled time must be at least 15 minutes in the future.
• Maximum Window: You can only schedule up to 240 hours (10 days) in advance.
• Month Rollover: If scheduling for the next month, you can only schedule within the first 2 days of that month, provided they are within the 10-day window from the current date.

After installing the library, you must install the Chromium browser binaries using the phantomwright_driver command.

phantomwright_driver install chromium

Once Fancy_Upload.py is running and integrated with your Telegram bot, you can control the automation and monitor status via specific Telegram commands sent to the bot:

• /status or /stats: Retrieves current upload status or statistics.
• /skip: Skips the current randomized timer interval to trigger the next upload immediately.

The library performs several automated setup steps during its first execution:

1. Dependency Download: Javascript dependencies are automatically downloaded. This adds 20-30 seconds to the very first run.
2. Account Login: When uploading to a new account for the first time, you will be prompted to log in via the browser.
3. Cookie Storage: Once logged in, your session cookies are saved to a file named TK_cookies_(youraccountname).json. Subsequent runs will use these cookies and will not require manual login.

Install the package using pip. Note that Node.js must be installed on your system as some components run JavaScript. The JS dependencies (playwright, playwright-extra, puppeteer-extra-plugin-stealth) are installed automatically during the first run, provided npm is in your PATH.

pip install tiktokautouploader

Set copyrightcheck=True to run a check before the upload starts. The upload process will stop if the video fails the check.

upload_tiktok(video=video_path, description=description, accountname=accountname, 
              hashtags=hashtags, copyrightcheck=True)

For automated environments, you can run the uploader without a visible browser window (headless=True), enable additional human-like delays (stealth=True), and route traffic through a proxy.

upload_tiktok(
    video=video_path,
    description=description,
    accountname=accountname,
    headless=True,       # no browser window
    stealth=True,        # additional human-like delays on top of baseline evasion
    suppressprint=True,  # no console output
    proxy={              # optional proxy config
        'server': 'http://yourproxy:port',
        'username': 'user',
        'password': 'pass'
    }
)

Queue videos for a specific time (up to 10 days in advance) using the schedule and day parameters.

upload_tiktok(video=video_path, description=description, accountname=accountname, 
              schedule='03:10', day=11)