TikTok Automatic Sender

Tự động gửi video TikTok hàng ngày đến danh sách bạn bè để duy trì streak.

Tính năng

• Giao diện UI (Tkinter) để quản lý danh sách người nhận
• Tự động scan danh sách DM và resolve username
• Hỗ trợ đa nền tảng: Linux, Windows, macOS
• Lên lịch gửi tự động hàng ngày theo giờ cố định
• Inject cookie từ file (không cần login lại mỗi lần)
• Tự động xử lý Screen Time popup, Sleep Hours popup
• Tuy nhiên, người dùng cần phải tự tay xử lý captcha khi trang yêu cầu.

Yêu cầu

• Python 3.10+
• Google Chrome đã cài đặt
• TikTok account đã đăng nhập

Cài đặt

# Clone repo
git clone https://github.com/w111user/daily-streak-tool
cd daily-streak-tool

# Tạo virtual environment
python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows

# Cài dependencies
pip install -r requirements.txt
playwright install chromium

Cấu hình

1. Export cookie từ TikTok

• Cài extension EditThisCookie
• Đăng nhập TikTok trên Chrome
• Click extension → Export → lưu thành cookies.json vào thư mục project

2. Cấu hình config.json

Tạo file config.json từ mẫu config.example:

{
  "schedule": {
    "time": "00:00",
    "timezone": "Asia/Ho_Chi_Minh",
    "run_on_start": true
  },
  "cookie_file": "cookies.json",
  "tiktok": {
    "headless": false,
    "user_data_dir_linux": "~/chrome-debug",
    "user_data_dir_macos": "~/Library/Application Support/chrome-debug",
    "user_data_dir_windows": "~\\AppData\\Local\\chrome-debug",
    "message_delay_seconds": [8, 18],
    "navigation_timeout_ms": 60000
  },
  "recipients": [],
  "videos": [
    "https://www.tiktok.com/@username/video/..."
  ],
  "telegram": {
    "enabled": false,
    "bot_token": "",
    "chat_id": ""
  }
}

Sử dụng

Chạy UI (khuyến nghị)

python3 ui.py

1. Điền thông tin config (giờ gửi, delay, video links)
2. Click Scan DM List để lấy danh sách người nhận
3. Click Resolve Usernames để lấy username thật
4. Tick chọn người muốn gửi
5. Click Start Sender

Chạy trực tiếp

python3 main.py

Lưu ý

• cookies.json hết hạn sau vài tháng → cần export lại
• Không commit cookies.json và config.json lên GitHub
• Giữ process chạy liên tục để scheduler hoạt động (dùng tmux hoặc screen trên Linux)

⚠️ Disclaimer: This project is for educational purposes only. Automated interaction with TikTok may violate their Terms of Service. Use at your own risk.