v3.2.0 - Settings, Safe Mode & Discord Notifications

v3.2.0 - Settings, Safe Mode, Ban Detection & Discord Notifications

What's New

Settings Screen

A comprehensive settings screen with 16 configurable options across 4 sections:

• Notifications: Discord webhook URL with test button, error/ban/summary notification toggles
• Automation: CAPTCHA max attempts, browser timeout, retry delay, max consecutive errors, and behavior toggles
• Rate Limiting: Safe mode toggle and configurable delay
• Network: Proxy URL support

Settings are persisted to ~/.zefoy/config.json.

Safe Mode (Rate Limiting)

Enable Safe Mode to limit sends to 4 per hour (15 min minimum delay between sends). This helps avoid triggering rate-limits and potential IP bans.

Recommendation: Max 5 sends per hour to stay safe.

Ban Detection

Automatically detects 24-hour+ rate limits as potential IP/account bans:

• Auto-stops automation when ban detected
• Sends Discord notification (if configured)
• Provides clear warning in the TUI

Discord Notifications

Get notified in Discord for:

• Milestones: 10, 25, 50, 100, 250, 500, 1000 sends
• Ban Detection: When 24h+ rate limit detected
• Errors: When automation encounters issues
• Session Summary: Stats when automation ends

Configure with webhook URL in Settings or via ZEFOY_DISCORD_WEBHOOK environment variable.

CAPTCHA Improvements

• Increased max attempts from 3 to 25 (configurable)
• Progress display: "CAPTCHA try X/25" in the TUI

New Config Options

Setting	Default	Description
captcha_max_attempts	25	Max CAPTCHA solve attempts
browser_timeout	30	Seconds to wait for page loads
auto_retry_delay	3	Extra seconds after rate limit
max_consecutive_errors	5	Stop after N consecutive errors
safe_mode	false	Enable 4/hour rate limiting
safe_mode_delay	900	Seconds between sends in safe mode
headless_mode	true	Run browser headless
debug_mode	false	Enable debug logging
proxy_url	""	Proxy URL (optional)
notify_on_errors	true	Discord notify on errors
notify_on_ban	true	Discord notify on ban detection
send_session_summary	true	Discord notify on session end

Installation

git clone https://github.com/zebbern/Zefoy-Automation.git
cd Zefoy-Automation
uv sync
uv run python main.py

Usage

1. Run with uv run python main.py
2. Press S for Settings to configure options
3. Enter your TikTok video URL
4. Select a service
5. Let it run!

---

Full Changelog: v3.1.0...v3.2.0

v3.1.0 - TUI & Branding Edition

What's New

🆕 Terminal UI (TUI)

• Beautiful interactive terminal interface
• 3-screen flow: Welcome → Service Selection → Running
• Live countdown timer during rate limiting
• Session stats: Sent count, Attempts, Elapsed time
• Headless mode (no browser window)
• Press Q to quit anytime

🏷️ Branding & Attribution

• MIT License with copyright
• --about flag shows credits banner
• --version shows version and author
• Author info in TUI welcome screen
• Credits in multiple source files

📊 Session Statistics

• Track successful sends in real-time
• Count total attempts
• Live elapsed time display
• Continuous operation until user quits

🛠️ Improvements

• Cleaner TUI with single q Quit binding
• No command palette clutter
• Better error handling on exit

Usage

# TUI Mode (recommended)
python tui_main.py

# CLI Mode (headless)
python main.py --headless --auto-captcha "https://www.tiktok.com/@user/video/123"

# Show credits
python main.py --about

Full Changelog: v3.0.0...v3.1.0

v3.0.0 - Headless Mode & Full Automation

What's New in v3.0.0

Fully Automated Headless Mode

Run completely in the background with no browser window:

python main.py --headless --auto-captcha --service hearts "VIDEO_URL"

Features

• Headless Mode: --headless flag runs browser invisibly
• Auto-CAPTCHA: OCR-powered CAPTCHA solving with EasyOCR + spell correction
• Auto-Installer: One-command setup with python install.py
• Clean Architecture: Modular, maintainable codebase

Services Available

• Hearts (likes)
• Favorites
• Comment Hearts

Improvements

• Fixed Hearts button click (btn-dark selector)
• Rate limit handling with auto-wait
• Robust popup dismissal
• Comprehensive error recovery

Installation

git clone https://github.com/zebbern/Zefoy-Automation.git
cd Zefoy-Automation
python install.py
python main.py --headless --auto-captcha --service hearts "YOUR_VIDEO_URL"

Full Changelog: 6bc6b66...v3.0.0

Automate Zefoy Interactions With No Effort | v2.0.0

Automate Zefoy Interactions With No Effort

v2.0.0 - Clean Architecture Edition

---

Features	Description
Virtual Environment Setup	Automatic venv creation and dependency management.
One-Click Launch	Auto-setup and run with a single command.
Smart Popup Handling	Auto-dismisses alerts, clicks close buttons, removes overlays.
Automated Views	Automate video views on TikTok seamlessly.
Likes Automation	Perform automated likes on specified videos or profiles.
Comment Likes	Boost engagement by automating comment likes.
Dynamic Service Detection	Automatically detects available services on page load.
Continuous Execution	Automatically loops tasks until stopped by the user.
Professional Logging	File and console logging with automatic rotation.
Error Recovery	Robust error handling and automatic retries.
Clean Architecture	Modular, maintainable, and easy to extend.

---

Overview

The TikTok Automation Bot leverages Python and Selenium WebDriver to automate TikTok interactions via Zefoy. Completely refactored with clean architecture and robust popup handling.

Just run the command ->

python main.py 

and it will automate you through it all!