Setup and Use

Requirements

You will need the following dependencies:

• Python >= 3.13 (Download) And one of the following Browsers:
• Google Chrome (Download)
• Chromium (Download)

---

Installation

1. Download the Repository

You can either download the 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 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 folder where you extracted 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 or Linux

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 requisite dependencies:

pip install .

Via UV

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

3. Install the requisite 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.

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 your given regex template. (e.g. If you only remember parts of it).

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.

---

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 or Linux

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 or Linux

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 or Linux

rm -r .venv