Skip to content

v3.2.0 - Settings, Safe Mode & Discord Notifications

Latest
Latest

Choose a tag to compare

View all tags
@zebbern zebbern released this 03 Feb 22:54
· 6 commits to main since this release
v3.2.0
aa8b9e7

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

Assets 2
Loading