A Selenium-based automated TikTok video uploader
- ⬆️ TikTok Uploader
- Table of Contents
- Installation
- Usage
- ♻ Examples
- 📝 Notes
- Accounts made using
tiktok-uploader
A prequisite to using this program is the installation of a Selenium-compatable web browser. Google Chrome is recommended.
Install Python 3 or greater from python.org
Install tiktok-uploader using pip
pip install tiktok-uploaderInstalling from source allows greater flexability to modify the module's code to extend default behavior. To install it, clone the repository and install the requirements
git clone https://github.com/wkaisertexas/tiktok-uploader.git
cd tiktok-uploader
pip install -r requirements.txtIf you want to install it as a library in your Python environment, run the following command from the root of the repository
python -m build --wheel
pip install dist/tiktok_uploader-0.1.2-py3-none-any.whlWhile TikTok is strict about login in from Selenium, simply copying your session tokens is enough to bypass this restriction and be able to upload your videos.
Using the CLI is as simple as calling tiktok-uploader with your videos: path (-v), description(-d) and cookies (-c)
tiktok-uploader -v video.mp4 -d "this is my escaped \"description\"" -c cookies.txtfrom tiktok_uploader.upload import upload_video, upload_videos
from tiktok_uploaader.auth import AuthBackend
# single video
upload_video('video.mp4',
description='this is my description',
cookies='cookies.txt')
# Multiple Videos
videos = [
{
'path': 'video.mp4',
'description': 'this is my description'
},
{
'path': 'video2.mp4',
'description': 'this is also my description'
}
]
auth = AuthBackend(cookies='cookies.txt')
upload_videos(videos=videos, auth=auth)This library revolves around the upload_videos function which takes in a list of videos which have filenames and descriptions and are passed as follows:
from tiktok_uploader.upload import upload_videos
from tiktok_uploader.auth import AuthBackend
videos = [
{
'video': 'video0.mp4',
'description': 'Video 1 is about ...'
},
{
'video': 'video1.mp4',
'description': 'Video 2 is about ...'
}
]
auth = AuthBackend(cookies='cookies.txt')
failed_videos = upload_videos(videos=videos, auth=auth)
for video in failed_videos: # each input video object which failed
print(f'{video['video']} with description "{video['description']}" failed')Mentions and Hashtags now work so long as they are followed by a space. However, you as the user are responsible for verifying a mention or hashtag exists before posting
Example:
from tiktok_uploader.upload import upload_video
upload_video('video.mp4', '#fyp @icespicee', 'cookies.txt')To set whether or not a video uploaded allows stitches, comments or duet, simply specifiy comment, stitch and duet as keyword arguments to upload_video or upload_videos.
upload_video(..., comment=True, stitch=True, duet=True)Comments, Stiches and Duets are allowed by default
Authentication uses your browser's cookies. This workaround was done due to TikTok's stricter stance on authetication by a Selenium-controlled browser.
🍪 Get cookies.txt makes getting cookies in a NetScape file format.
After installing, open the extensions menu on TikTok.com and click 🍪 Get cookies.txt to reveal your cookies. Select Export As ⇩ and specify a location and name to save.
Optionally, cookies_list is a list of dictionaries with keys name, value, domain, path and expiry which allow you to pass your own browser cookies.
Example:
cookies_list = [
{
'name': 'sessionid',
'value': '**your session id**',
'domain': 'https://tiktok.com',
'path': '/',
'expiry': '10/8/2023, 12:18:58 PM'
}
]
upload_video(..., cookies_list=cookies_list)
sessionidis actually the only required cookie for authentication.
Google Chrome is the prefered browser for TikTokUploader. The default anti-detection techniques used in this packaged are optimized for this. However, if you wish to use a different browser you may specify that in upload_videos.
from tiktok_uploader.upload import upload_video
from random import choice
BROWSERS = [
'chrome',
'safari',
'chromium',
'edge',
'firefox'
]
# randomly picks a web browser
upload_video(..., browser=choice(BROWSERS))✅ Supported Browsers:
- Chrome (Recommended)
- Safari
- Chromium
- Edge
- FireFox
Default modifications to Selenium are applied which help it avoid being detected by TikTok.
However, you may pass a custom driver configuration options. Simply pass options as a keyword argument to either upload_video or upload_videos.
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_argument('start-maximized')
upload_videos(options=options)Note: Make sure to use the right selenium options for your browser
Headless browsers do not work at this time
If more experienced in Webscraping, I would really appreciate helping make this work. undetected-chromedriver was already tried and did not work.
WebDriverManager is used to manage driver versions.
On intial startup, you may be prompted to install the correct driver for your selected broswer. However, for Chrome and Edge this works without issue.
Basic Upload Example is a simple automation which uses upload_video.
Series Upload Example is a automation which uploads the same video multiple times using upload_videos.
Scheduled Uploader Example is an automation which is based off this package. Videos are read from a CSV file using Pandas. A video upload attempt is made and if and only if it is successful will the video be marked as uploaded.
This bot is not fool proof. Though I have not gotten an official ban, when the video will fail to upload after too many uploads. When testing, waiting several hours was sufficient to fix this problem. For this reason, please thing of this more as a scheduled uploader for TikTok videos, rather than a spam bot.
Please think of this package as more of a scheduled uploader for TikTok videos, rather than a spam bot
- @C_Span - A split-screen channel with mobile games below featuring clips from C-Span's YouTube channel
- @habit_track - A Reddit to TikTok bot for a data science project