# Set up BlackSwipe, from ZIP to first run

For Windows and LDPlayer. Complete preparation first, then watch your first run in the game.

## What you need

Windows

Windows 10 / 11, 64-bit.

Emulator

LDPlayer with ADB and root. Memory features are tested on LDPlayer.

Display

Exactly 1600 × 900 pixels at 240 DPI.

OCR

Tesseract OCR installed, even when memory reads are enabled.

License

A valid license for this PC and internet for activation.

Python

Not required. The ZIP includes BlackSwipe.exe.

Detection of other emulators does not confirm support for every memory feature. This guide uses LDPlayer.

Already purchased? [Download the latest release](https://getblackswipe.com/download)  using the key from your order.

## 1. Extract the entire package

Use the package supplied through official support or your update. Extract the full ZIP into a writable folder. Do not run the EXE inside the ZIP or move it without its _internal folder.

Install Tesseract OCR at C:\Program Files\Tesseract-OCR\tesseract.exe or make it available on PATH. If the app does not start, use the included Start helper.bat or Check system.bat.

## 2. Prepare LDPlayer

- Enable ADB and root in the settings of your LDPlayer instance.

- Set the Android display to 1600 × 900 at 240 DPI and restart the instance.

- Open Clash of Clans and wait in your home village.

This means the internal Android display profile. Resizing the emulator window is not the same as changing that resolution.

## 3. Sign in and complete preparation

Open BlackSwipe.exe and sign in with your license. Under Settings → Emulator, select the right emulator and verify the connection. Wait until preparation finishes.

Check the account name, Town Hall, resources and builders. If anything is wrong, do not start yet. Resolve unsupported game versions or missing root access first.

## 4. Supervise a short run

- Under Army, select a strategy with a matching saved army preset in the game.

- Review heroes, siege machine, loot targets and attack duration.

- Set a small attack limit. Fresh packages start with three attacks; existing settings are retained and may differ.

- Start and watch target selection, deployment, return home and result values.

- Check Stop before planning a longer session.

START FARMING performs real game actions. The current interface has no test-mode switch. Requests, donations and wall upgrades start disabled in a fresh package. Enable only the actions you intend.

## Multiple instances and saved accounts

Assign each bot instance its own emulator. Settings, logs and statistics remain separate. Accounts lets you switch between game accounts already saved in the emulator. After switching, verify the target name and village data.

## Updates and saved data

The app checks for updates on startup. You can also use the version button. After an accepted update, settings, license and statistics remain saved. Older installations without the updater need the complete package installed once.

Local user data lives under %LOCALAPPDATA%\BlackSwipe. Do not copy license caches or personal configuration to another person's PC. Moving a PC-bound license may require a device reset through support.

## When something does not work

Emulator missing or not responding

Check that the intended instance is running and ADB is enabled, then select it again. Do not run a second bot against the same device.

Preparation does not finish

Leave the game in the home village. Check root, the display profile and any game-version error. Use Logs and diagnostic export if the problem persists.

A Superuser popup keeps appearing

From package 1.0.20, preparation automatically disables root notices on supported LDPlayer instances. The first setup request can still show one notice. Root grants remain unchanged.

The EXE does not open

Extract the entire package again and run Start helper.bat or Check system.bat. Keep the error message for support.

Settings cannot be saved

Check file permissions and the error message. From 1.0.19, invalid or unreadable settings are not silently replaced with defaults.

What should I send to support?

The bot version, LDPlayer version, the affected action and a diagnostic export. Never post license keys or tokens in public channels.

## Need a hand?

Get help with preparation, licensing and errors.

[Discord Support](https://discord.gg/YdAeYYy2FN)