Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Nuu-maan/Filly-Discord-Token-Filler/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

Before installing Filly, ensure you have the following:
1

Python 3.7+

Verify your Python installation:
python --version
If you don’t have Python installed, download it from python.org
2

Git

Git is required to clone the repository:
git --version
Download from git-scm.com if needed
3

Windows OS

Filly v1 is designed for Windows and uses Windows-specific libraries (msvcrt, ctypes)
Linux/Mac users may need to modify console title and keyboard input code

​
Installation steps

1

Clone the repository

Download the Filly source code:
git clone https://github.com/Nuu-maan/Filly-Discord-Token-Filler.git
cd Filly-Discord-Token-Filler
2

Install dependencies

Install all required Python packages:
pip install -r requirements.txt
This installs:
  • requests - HTTP library for API calls
  • curl-cffi - Browser impersonation for Discord requests
  • colorama - Colored console output
  • httpx - Async HTTP client for captcha solvers
  • Built-in libraries: concurrent.futures, msvcrt, ctypes, pathlib, dataclasses
If you encounter SSL errors with curl-cffi, you may need to install Visual C++ redistributables on Windows
3

Configure input files

Set up your configuration and input data files:

​
config.json

Edit input/config.json with your settings:
{
    "threads": 10,
    "proxyless": true,
    "max_joins": 100,
    "delay": 1,
    
    "captcha": {
        "solve_captcha": true,
        "service": "razorcap",
        "apikey": "your-api-key-here",
        "proxyless": false
    }
}
Configuration options:
OptionTypeDescription
threadsintegerNumber of concurrent threads (1-50 recommended)
proxylessbooleanSet to true to disable proxies for joining
max_joinsintegerMaximum servers each token will join
delayintegerDelay in seconds between join attempts
captcha.solve_captchabooleanEnable automatic captcha solving
captcha.servicestringCaptcha service: razorcap, hcoptcha, csolver, capmonster
captcha.apikeystringYour captcha solver API key
captcha.proxylessbooleanWhether to use proxies for captcha solving

​
tokens.txt

Add your Discord tokens (one per line):
email:password:token
token_only_format
another_token
Tokens can be in email:password:token format or just the token itself. The script automatically extracts the token portion.

​
invites.txt

Add Discord invite codes (one per line):
api
discord
your-invite-code
Use invite codes only, not full URLs. For example, use api instead of discord.gg/api

​
proxies.txt (optional)

If using proxies ("proxyless": false), add proxies in this format:
username:password@ip:port
ip:port
Example:
user:pass@192.168.1.1:8080
10.0.0.1:3128
4

Verify installation

Test that everything is configured correctly:
python index.py
You should see the Filly banner:
                     █████▒██▓ ██▓     ██▓   ▓██   ██▓
                     ▓██   ▒▓██▒▓██▒    ▓██▒    ▒██  ██▒
                     ▒████ ░▒██▒▒██░    ▒██░     ▒██ ██░
...
The script will start joining servers immediately. Press Ctrl+C to stop if you’re just testing.

​
Directory structure

After installation, your directory should look like this: 
Filly-Discord-Token-Filler/
├── input/
│   ├── config.json       # Configuration settings
│   ├── tokens.txt        # Discord tokens
│   ├── invites.txt       # Server invite codes
│   └── proxies.txt       # Proxy list (optional)
├── output/
│   ├── joined.txt        # Successfully joined
│   ├── failed.txt        # Failed attempts
│   ├── invalid.txt       # Invalid tokens
│   ├── locked.txt        # Locked accounts
│   ├── captcha.txt       # Captcha encounters
│   ├── failed_captcha.txt # Captcha failures
│   └── filled_tokens.txt # Max joins reached
├── data/
│   ├── solver.py         # Captcha solver implementations
│   └── logger.py         # Custom logging system
├── index.py              # Main script
├── requirements.txt      # Python dependencies
└── readme.md

​
Troubleshooting

Install curl-cffi with proper SSL support:
pip install --upgrade curl-cffi
On Windows, you may need Visual C++ redistributables.
  • Verify tokens are valid and not expired
  • Check that tokens are in the correct format in tokens.txt
  • Ensure one token per line with no extra whitespace
  • Test a token manually in Discord to confirm it works
  • Verify proxy format: username:password@ip:port or ip:port
  • Test proxies are working and not banned by Discord
  • Try setting "proxyless": true to test without proxies
  • Check that proxies support HTTPS connections
  • Verify your API key is valid and has credits
  • Check the captcha service status
  • Try a different solver service (razorcap, hcoptcha, csolver, capmonster)
  • Increase timeout in solver.py if needed

​
Next steps

Quickstart guide

Learn how to join your first Discord server with Filly

Build docs developers (and LLMs) love

Get started for freeTalk to us