FingerBot Setup Guide

Overview

FingerBot is a multi-retailer checkout automation tool with a Chrome extension for browser-based automation. This guide walks through setup for both Windows and macOS.

Prerequisites

• Google Chrome (latest)
• The FingerBot zip for your platform
• Your .env credentials file (API keys, proxy info)

Step 1 — Extract & Launch

Windows

1. Extract FingerBot-Windows-v{version}.zip to a permanent location (e.g. C:\FingerBot or Desktop)
2. Open the extracted folder
3. Double-click FingerBot.exe to launch

Tip: Right-click FingerBot.exe → Create shortcut → move shortcut to Desktop for easy access

macOS

1. Extract FingerBot-macOS-v{version}.zip
2. Double-click FingerBot.app to launch
3. If macOS blocks it: System Settings → Privacy & Security → click Open Anyway

Step 2 — Load the Chrome Extension

1. Open Chrome and navigate to chrome://extensions
2. Enable Developer mode (toggle in top-right)
3. Click Load unpacked
4. Navigate to the extracted FingerBot folder and select the finger_extension folder
5. The FingerBot extension will appear in your extensions list
6. Copy the Extension ID — a 32-character string shown under the extension name (e.g. abcdefghijklmnopabcdefghijklmnop)

Step 3 — Connect Extension to App

1. Open FingerBot
2. Go to Settings → General tab
3. Scroll to the Chrome Extension section
4. Paste your Extension ID into the input field
5. Click Connect
6. You should see a success dialog — click OK
7. Fully restart Chrome (quit from the menu bar / taskbar, not just close the window)
8. The extension status in Settings will now show connected

Note: If you see an error, make sure FingerBot is running before connecting, and that you copied the full 32-character extension ID.

Step 4 — Verify Connection

1. After restarting Chrome, click the FingerBot extension icon in the toolbar
2. The popup should show Connected status
3. In the FingerBot app, the activity monitor should show extension events

Retailer Setup

Macy's

• Configure account credentials in Settings → Macy's
• Set proxy preferences
• Choose between browser mode and request mode
• Request mode requires a valid session — let the bot handle this automatically

Target

• Configure account credentials in Settings → Target
• Target uses browser automation — ensure Chrome is configured correctly
• Set your preferred payment method

Walmart

• Configure account credentials in Settings → Walmart
• Walmart uses request-based checkout with anti-bot bypass
• Trigger via Discord using the configured webhook

Pokémon Center (PKC)

• Configure account credentials in Settings → PKC
• Supports multi-item cart for drops
• Request mode available for faster checkout

Updating FingerBot

FingerBot checks for updates automatically on launch.

• Stable channel — production-ready releases
• Experimental channel — latest features, may have rough edges

To change channel: Settings → General → Update Channel When an update is available, a dialog will appear. Click Update and the app will restart automatically.

Troubleshooting

Extension shows disconnected after restarting Chrome

• Go to Settings → General → Chrome Extension
• Click Connect again with the same Extension ID
• Fully quit and reopen Chrome

App won't launch on macOS

• Go to System Settings → Privacy & Security
• Scroll down and click Open Anyway next to the FingerBot block message
• If not visible, try right-clicking the .app → Open

Bot fails with proxy errors

• Verify proxy credentials in .env
• Check that your proxy supports HTTPS and residential IPs
• Try switching to a different proxy endpoint

Captcha solving fails

• Verify CAPSOLVER_API_KEY and NOPECHA_KEY in .env
• Check your CapSolver / NopeCHA account balance
• Some challenges require manual solving on the first run

Notes

• Keep the entire extracted folder intact — moving individual files will break the app
• The finger_extension folder must stay in the same location after loading in Chrome