Setup and Use

Requirements

You will need to install the following dependencies:

• Python >= 3.13 (Download)

And one of the following Browsers (you will need to specify your selected browser in the Browser configuration):

• Google Chrome (Download)
• Chromium (Download)
• Thorium (Download)
• Brave (Download)

---

Installation

1. Download the Program

You can either download the repository ZIP file directly or clone it via Git.

Download ZIP (Recommended for most users)

https://codeberg.org/Discord-OTP-Forcer/Discord-OTP-Forcer/archive/refs/heads/main.zip

Clone via Git

If you prefer using the command line, you can clone the repository instead:

git clone --depth=1 https://codeberg.org/Discord-OTP-Forcer/Discord-OTP-Forcer.git
cd Discord-OTP-Forcer

---

2. System Setup

Choose your operating system below to continue the setup process:

Windows

1. Go to the location where you extracted the zip file or where you cloned the repository.
2. Double-click and run scripts/Windows/setup.cmd.
3. The requisite dependencies will install automatically. Once finished, the config/account.yml and config/program.yml files will open in Notepad.
4. fill out the necessary details (see the Configuration section below) then save the files and close Notepad.
5. If you are ready to start a forcer session now, type Y at the prompt. A new window will open starting a forcer session.

macOS, Linux, other Non Windows based OS

1. Open your terminal and navigate to the repository folder.
2. Create and activate a Python virtual environment:

Via Pip

python -m venv .venv
source .venv/bin/activate

3. Install the required dependencies:

pip install .

Via UV

uv venv --python 3.14
source .venv/bin/activate

3. Install the required dependencies:

uv sync

4. Open the config/account.yml file in your preferred text editor and fill out the necessary credentials.
5. Open the config/program.yml file and fill out the necessary program configuration options.

---

Configuration

program.yml

The program has two modes: Reset and Login. Set programMode to one of these.

• programMode: Reset: Will set the program to password reset mode. It will log in to your account using the password reset token resetToken, enter your desired newPassword, and then start codes. (the reset token usually expires after 6 hours, keep that in mind)
• programMode: Login: Will set the program to login mode. This is a normal email+password login which will then (usually) ask you for a hCaptcha, then start Forcing codes.

Browser

You will need to specify a browser so Selenium knows which one to use. Set browser to your chosen browser name. Available options are: Chrome, Chromium, Thorium, and Brave.

Advanced Configuration

Option	Description	Default
sensitiveDebug	If True, hides sensitive info (passwords, tokens) from logs using a CensoredStr class.	True
logCreation	If True, saves logs to a file in the log/ directory.	False
headless	Runs the browser without a GUI. Not recommended as you cannot solve captchas.	False
logLevel	Minimum level of logs to show (DEBUG, INFO, SUCCESS, WARNING, ERROR, SENSITIVE).	INFO
elementLoadTolerance	Seconds to wait for UI elements to appear before timing out.	3
usualAttemptDelayMin	Minimum seconds to wait between normal attempts.	6
usualAttemptDelayMax	Maximum seconds to wait between normal attempts.	8
ratelimitedAttemptDelayMin	Minimum seconds to wait when rate limited.	7
ratelimitedAttemptDelayMax	Maximum seconds to wait when rate limited.	11

Code Modes

• codeMode: Normal: Generates a 6-digit numeric ‘normal’ code.
• codeMode: Backup: Generates an 8-digit alphanumeric ‘backup’ code.
• codeMode: "aqzi[a-z0-9]{2}(p|q)[3-5]": Special regex mode. Generates a backup code conforming to a given regex template (useful if you only remember parts of your code). For example, the pattern above could produce codes like aqzi03p4, aqzi8jq5, and many others. The template must fit within the Discord backup code format: [a-z0-9]{8}. Fill in the characters you remember, and use a regex pattern for the ones you don’t.

Note

You can use regex101.com to build and test your patterns. Make sure to select Python as the regex flavor.

account.yml

Fill in your account’s email and password in the email and password fields (in quotes). If using Reset mode, you’ll also need to fill out newPassword and resetToken (password is not needed).

---

How to Get Your Reset Token

1. Go to discord.com/login and enter the email for the account, then click “Forgot your password?”.
2. Find the password reset email and click “Reset Password”.
3. Your token will be in the URL for the password reset page.

Example: https://discord.com/reset#token=YOUR_TOKEN_HERE

Note

You only need the part after token=. The program will not work if you put the entire URL.

Visual Instructions

---

Running the Program

Windows

Via .cmd Script

1. Go to scripts/Windows/ folder
2. Doble click on start.cmd

Via CMD + Python

1. Open CMD
2. Go to the path where you decompress the program
3. Execute:

python main.py

macOS, Linux, other Non Windows based OS

1. Open your terminal
2. Go to the path where you decompress / clone the program
3. Execute:

Via Python

python main.py

Via UV

uv run main.py

What will happen on both Operative Systems

1. An automated Google Chrome window will open. When the hCaptcha appears, complete it as normal.
2. Wait for either a successful login or a closed browser window (failure).
3. Success: The program will print your account token to the console and save it to secret/token.txt.
4. Important: The automated browser window will stay open after the program finishes. You will need to press Enter in the terminal to close it. This allows you to manually verify the login or perform further actions.
5. WARNING: Do not run this where someone else could access the log. Save this token safely!
6. CRITICAL: Do NOT log out, log in from a different device, or change account settings. Doing so invalidates your currently obtained token.
7. Using the token, log into your account via browser console:
   • Go to discord.com/login, open the developer tools console.
   • Paste a token login script (like this one).
   • Wait for it to log in.
8. Go to User Settings > My Account > Authenticator App > View Backup Codes.
9. Save your backup codes! Then click “Remove Authenticator App” and enter one of your new backup codes.

---

Updating Dependencies

To update all installed dependencies, you can run the update script:

Windows

Run scripts/Windows/update_dependencies.cmd to update all Python packages that this program uses.

macOS, Linux, other Non Windows based OS

Via Python

python install .

Via UV

uv sync

Uninstalling Dependencies

To remove all installed dependencies, you can run the uninstall script:

Windows

Run scripts/Windows/uninstall_dependencies.cmd to uninstall all Python packages that this program uses.

macOS, Linux, other Non Windows based OS

Is easier to remove the whole .venv and start a new one:

rm -r .venv