tiktodv3 - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #llm #golang #android #rust #deep-learning #java #windows #awesome #kubernetes #pytorch #mcp

tiktodv3

(★ 894)

TIKTOD V3 is a bot application designed to automate interactions on Zefoy website, such as increasing views, hearts, followers, and shares on a specified video. The bot uses technologies like Selenium for web automation and OCR (Optical Character Recognition) for solving captchas.

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yml
  - stale.yml
- dark-logo.png
- light-logo.png
- logo.ico
- build.ps1
- package-release.ps1
- __init__.py
- __main__.py
- bot.py
- captcha_solver.py
- config.py
- gui.py
- settings.py
- theme.py
- utils.py
- __init__.py
- core.py
- gui.py
.gitignore
app.py
build.ps1
CHANGELOG.md
LICENSE
NOTICE
package-release.ps1
pyproject.toml
README.md
requirements-dev.txt
requirements-lock.txt
requirements.txt
THIRD_PARTY_NOTICES.md
verify.py
verify_gui.py

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/kangoka/tiktodv3

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd tiktodv3

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

python -m venv .venv

파이썬 스크립트(또는 모듈)를 실행합니다.

python -m pip install --upgrade pip

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python -m pip install -r requirements-lock.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python -m tiktodv3

파이썬 스크립트(또는 모듈)를 실행합니다.

python -m verification.core

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="assets/dark-logo.png" alt="TIKTOD V3 logo" width="180">
</p>

# TIKTOD V3

TIKTOD V3 is a Windows desktop utility that coordinates selected interactions
through Zefoy for a supplied TikTok video URL. It uses CustomTkinter for the UI,
CloakBrowser/Playwright for browser control, and Tesseract OCR for CAPTCHA text.

## Read this before using the application

The application sends the TikTok URL you enter to **Zefoy**, a third-party
service. It also automates interactions that may violate TikTok's or Zefoy's
rules. That can expose an account to restrictions and creates privacy, legal,
and contractual risk.

Use the application only when you are authorized to do so. Never enter account
credentials or private links. The desktop UI requires an explicit acknowledgment
of these facts before Setup can run.

## Features

- Explicit `IDLE → SETTING_UP → READY → RUNNING → STOPPING` lifecycle.
- Automatic discovery of currently available supported modes.
- In-memory CAPTCHA OCR; generated CAPTCHA images are not stored on disk.
- Stable-image CAPTCHA readiness checks that reject loading placeholders.
- Confirmed send counts when the service reports them.
- At-a-glance target progress, percentage, elapsed time, per-mode session counts,
  and total confirmed activity.
- Bounded retry/backoff behavior, explicit rate-limit pauses, and interruptible
  cooldowns.
- Light and dark themes with persisted preference.
- Keyboard-accessible controls, status feedback, and read-only copyable logs.
- Preflight messages for missing OCR or browser dependencies.

## Requirements

- Windows 10 or newer.
- Python **3.10 or newer** when running from source.
- [Tesseract OCR](https://github.com/tesseract-ocr/tesseract/releases/latest)
  installed and available on `PATH`.
- Internet access during Setup and automation.

CloakBrowser downloads and caches its patched Chromium build on first use. The
download is approximately 200 MB and normally lives under `~/.cloakbrowser`.

## Install from source

Use an isolated environment so project dependencies do not conflict with global
packages:

```powershell
git clone https://github.com/kangoka/tiktodv3.git
cd tiktodv3
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -r requirements-lock.txt
python -m tiktodv3
```

The existing `python app.py` command remains available as a compatibility
launcher.

## Application workflow

1. Read and accept the authorization and data-use notice.
2. Enter a public TikTok video URL and positive target amount.
3. Select **Setup**. The app checks Tesseract, launches CloakBrowser, solves the
   CAPTCHA, and discovers supported modes.
4. Choose an available mode and select **Start**.
5. Select **Stop** or press Escape to stop safely.

Disabled and unsupported modes are not offered. Counts are updated only after a
send reaches a confirmed cooldown response; if the service does not report the
exact amount, the log clearly labels the fallback as estimated.

## Keyboard shortcuts

| Shortcut | Action |
|---|---|
| `Alt+S` | Setup, Start, or Stop according to current state |
| `Alt+M` | Cycle the available mode |
| `Alt+T` | Toggle light/dark theme |
| `Ctrl+Tab` | Switch between Log and Stats |
| `Ctrl+L` | Focus the TikTok URL field |
| `Ctrl+G` | Open the GitHub repository |
| `Escape` | Stop an active run |

Tab and Shift+Tab also traverse the inputs, primary action, theme control, mode
selector, disclosure acknowledgment, log actions, and GitHub action.

## Local data

The app stores two preferences in `~/.tiktodv3/settings.json`:

- selected theme;
- whether the risk notice was acknowledged.

TikTok URLs, counters, and log output are not intentionally persisted by the
application. Zefoy and the browser/network stack remain separate trust domains.

## Verification

This project intentionally does not use a `tests/` directory. Deterministic,
offline checks live in the `verification` package:

```powershell
python -m verification.core
python -m verification.gui
python -m compileall -q .
ruff check .
ruff format --check .
mypy .
```

The previous `python verify.py` and `python verify_gui.py` commands remain as
compatibility wrappers.

These checks do not launch CloakBrowser, solve a live CAPTCHA, or contact Zefoy.
Live compatibility depends on third-party markup and must be validated manually
by an authorized operator.

## Build an executable

From an activated environment, run the canonical build script:

```powershell
.\scripts\build.ps1
```

The build produces `dist/tiktodv3.exe`. Tesseract remains an external system
requirement. Release maintainers should sign the executable and publish a SHA-256
checksum.

Publishing the checksum is safe: it is a one-way file fingerprint, not executable
content or a secret. It lets users detect a corrupted or replaced download when
they obtain the checksum from the trusted release page. A checksum does not prove
publisher identity, so code signing remains the stronger authenticity control.

The root `.\build.ps1` wrapper remains supported. Release packaging is available
through `.\scripts\package-release.ps1` or its root compatibility wrapper.

## Project structure

```text
tiktodv3/       Runtime package, GUI, automation, OCR, settings, and shared policy
verification/   Deterministic offline core and GUI checks (no tests directory)
scripts/        Build and release-packaging implementations
assets/         Application icons and light/dark logo artwork
.github/        Continuous integration and repository automation
app.py          Backward-compatible source launcher
*.ps1           Backward-compatible build and packaging launchers
```

Public documentation, dependency manifests, licensing, and notices stay at the
repository root so standard tooling and GitHub can discover them easily.

## Troubleshooting

- **Tesseract unavailable:** install it, add its installation directory to
  `PATH`, restart the terminal, and retry Setup.
- **First Setup takes a long time:** CloakBrowser may be downloading its patched
  Chromium build.
- **No modes available:** the third-party service has no supported mode enabled;
  retry later.
- **Too many requests:** this is a remote rate limit, not a local CAPTCHA or retry
  failure. Keep only one instance running and let the automatic 90-180 second
  pause finish. If it remains active across three checks, the run stops; wait at
  least 15-30 minutes before restarting. VPN/proxy switching can worsen trust and
  is not a reliable or appropriate workaround.
- **Automation stops after three errors:** the circuit breaker prevented an
  infinite retry loop. Copy the log, confirm the service page still works, and
  retry Setup.
- **GUI opens but a release executable fails:** rebuild using the pinned
  dependencies by running `.\scripts\build.ps1` from an activated environment.

## Contributing and reporting issues

Run `python -m verification.core`, `python -m verification.gui`, Ruff, and
compilation before proposing a change. Keep UI work on the Tk main thread, keep
Playwright work on the dedicated bot worker, and never add live-service calls to
offline verification.

Report vulnerabilities privately to the repository maintainer. Do not include
sensitive TikTok URLs or exploit details in public issues.

## License

Licensed under the [Apache License 2.0](LICENSE). Copyright 2025-2026 kangoka
and contributors. Third-party components retain their respective licenses; see
[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

## Disclaimer

This software is provided without warranty. Its use may violate third-party
terms or applicable rules. The operator is responsible for authorization,
compliance, accounts, data, and consequences arising from use.