html
Detailed User Manual
VERSION 1.0Beast FTP (ip) is a program for searching for files on open FTP servers on the internet.
Imagine you need a specific configuration, document, or source code. Instead of manually going through servers one by one, you launch the program — and it checks thousands of servers for you.
For the program to work correctly, your computer must meet the following requirements:
| Component | Requirement |
|---|---|
| Operating System | Windows 7–10 (64-bit) or newer |
| Microsoft Visual C++ Redistributable | Version 2015–2022. If the program doesn't start and shows a DLL error, install: https://aka.ms/vs/17/release/vc_redist.x64.exe |
| Free Disk Space | At least 100 MB (for the program and database) |
| Internet | Required for searching FTP servers. Required for program activation |
| Additional Software (optional) | FileZilla or WinSCP — for convenient downloading of files from found FTP servers |
The program is distributed as an archive containing two files:
BeastFTP.exe — the program itselfбаза.gz — FTP server databaseBoth files must be in the same folder.
база.gz —
without it the program cannot search servers!
It is recommended to create a separate folder, for example:
D:\BeastFTP\
And extract both files into it:
D:\BeastFTP\
├── BeastFTP.exe
└── база.gz
Some antiviruses may mistakenly flag programs created with Python as suspicious. This is a false positive.
If your antivirus deletes or blocks BeastFTP.exe:
D:\BeastFTP\ to exclusions.BeastFTP.exe from quarantine.The program is safe and contains no viruses.
Run BeastFTP.exe by double-clicking it.
Activation is done via email. Here is a step-by-step guide:
In the activation window, enter your email in the "Email:"
field (for example, user@mail.ru).
The button is located below the email input field.
A window will appear with a choice:
Choose a convenient option. An email window will open with the message already filled in.
Send the email to:
bc1q4yp7fpqfsd96m@gmail.com
The email must contain your email address.
In response, you will receive a LONG ACTIVATION CODE
(about 350 characters, consisting of letters, digits, signs
+, /, = and containing a dot).
Example code:
MjAyNy0wOS0yOA==.H5WrjtXrU0AEThNZVQ...
Copy the entire code from the email (Ctrl+C).
Return to the Beast FTP activation window.
Paste the code into the "Activation code (long)" field (Ctrl+V).
If the code is correct — the message "Program successfully activated!" will appear and the main program window will open.
Causes and solutions:
D:\BeastFTP\).
| Element | What It Shows |
|---|---|
| Database Indicator |
Red — database not loaded. Green — all good. Orange — searching. |
| Server Count | How many IP addresses are available for search. |
| EN / RU Button | Switch interface language. |
This panel is needed when you want to scan not the whole database, but a specific range of addresses — for example, your subnet.
| Element | What It Does |
|---|---|
| Start IP | First address of the range (for example, 192.168.1.1) |
| End IP | Last address of the range (for example, 192.168.1.255) |
| SCAN RANGE | Starts scanning the specified range |
| Element | What It Does |
|---|---|
| Query | Word or fragment to search for. |
| Servers per Batch | How many servers to check in one "batch". Default is 100. |
| AUTO | Automatically move to the next batch. |
| SEARCH DATABASE | Start a new search (old results will be cleared). |
| CONTINUE | Continue from where you stopped. |
| STOP | Stop the search (progress will be saved). |
| CLEAR | Remove all found results. |
| SETTINGS | Choose file types and interface scale. |
| Column | What It Contains |
|---|---|
| # | Sequential number |
| Name | File or folder name |
| Server | FTP server IP address |
| Link | Full address ftp://... |
| Match | Where exactly found: in name, in folder, in content |
Here you can see everything the program does: which servers were checked, how many were active, what was found, what errors occurred. If something goes wrong — look here.
Use the ready-made server list from база.gz.
This is the MAIN mode — it provides access
to millions of addresses.
Set two IP addresses manually — for example, from
10.0.0.1 to 10.0.0.254.
In simple terms, the program does five steps:
| Rule | Value | Why |
|---|---|---|
| Walk depth | 4 levels | Deeper — rare, but very slow |
| Files per folder | up to 150 | Folders with 10,000 files "kill" FTP |
| Subfolders per level | up to 30 | Protection against "clone folders" |
| File size for reading | up to 10 MB | Large files — usually not text |
| Connection timeout | 3-10 seconds | So "dead" servers don't slow things down |
By default, the program searches only text and meaningful files — configurations, documents, source code, keys. It skips images, video, and music so as not to waste time.
Click "SETTINGS" to open the list of extensions.
| Category | Examples | Enabled |
|---|---|---|
| Source code | .py, .js, .java, .c, .php | Yes |
| Configs and data | .conf, .ini, .json, .xml | Yes |
| Keys and certificates | .key, .pem, .crt, .pub | Yes |
| Databases | .db, .sqlite, .dump | Yes |
| Archives | .zip, .rar, .gz, .tar | Yes |
| Documents | .pdf, .txt, .log, .md | Yes |
| Programs and libraries | .exe, .dll, .so | No |
| Media | .jpg, .png, .mp3, .mp4 | No |
In the "SETTINGS" window, there are two related blocks: "SEARCH PROFILES" and "SEARCH PARAMETERS". They define HOW DEEP and HOW LONG the program will search for files on each server.
Profiles are ready-made sets of parameters. One click — and all parameter fields are filled in automatically. Convenient when you don't want to fiddle with numbers manually.
| Parameter | Fast | Standard | Deep |
|---|---|---|---|
| Depth | 2 levels | 4 levels | 6 levels |
| Folders per level | 50 | 200 | 500 |
| Files per server | 500 | 5000 | 20000 |
| Files per folder | 100 | 150 | 300 |
| Server timeout | 60 s | 1800 s | 3600 s |
| File size | 5 MB | 10 MB | 20 MB |
| Search inside | Yes | Yes | Yes |
What it's for: when you need to quickly scan through servers and see if there's anything interesting.
How it works:
When to use:
What it WON'T find:
What it's for: balanced mode for everyday use. This is what you should choose by default.
How it works:
When to use:
What it will find:
What it's for: maximum thoroughness. The program will walk the server up and down, but it will work for a long time.
How it works:
When to use:
What to expect:
Below the profiles are fine-tuning fields. They are filled automatically when you select a profile, but you can change them manually.
| Parameter | What It Means |
|---|---|
| Search depth (levels) | How many levels deep to go into folders. Less — faster, but finds less. More — slower, but digs deeper. Recommended: 2–4. |
| Folders per level | How many folders to walk at each level. Less — faster. More — wider coverage. Recommended: 50–300. |
| Files per server | Maximum files the program will view on one server before moving to the next. 500 — fast. 20000 — slow. |
| Files per folder | How many files to read from one folder. Folders with 10,000 files heavily slow down FTP. Recommended: 100–300. |
| Server timeout (sec) | How many seconds maximum to spend on one server.
1800 = 30 minutes. 3600 = 1 hour. |
| File size for reading (MB) | Files larger than this size are not read inside — only the name is checked. 5–10 MB is usually enough. |
| Search inside files |
CHECKBOX. ✓ — read file contents (slow, but more hits). ✗ — search by name only (fast, but finds less). |
| Situation | Profile |
|---|---|
| Quickly check a huge range | FAST |
| Regular search in the database | STANDARD |
| Thorough search in 100 IPs | DEEP |
| Slow internet | FAST |
| Don't want to disturb family | FAST |
| Want to find the maximum | DEEP |
| Not sure what to choose | STANDARD |
Red button at the bottom of the parameters block. Returns all values to factory defaults:
Use if you "twisted" the parameters and got confused, or if the program works incorrectly because of invalid values.
параметры поиска.json next to the program. On next
launch they load automatically.
The program can remember where it stopped. This is convenient if the search lasts for hours.
beast_search_state.dat manually.All results can be exported to a file — for example, to send to a colleague or process in Excel.
.txt — human-readable report..json — structured data for programs.Available range — from 50% to 200%.
Click the EN / RU button in the top right corner. All labels update instantly. The language is saved until next launch.
If the program runs too long, try the following one by one:
| What to Do | How It Helps |
|---|---|
| Reduce "Servers per Batch" to 30-50 | Each server is checked faster |
| Leave only the extensions you need | Fewer files are downloaded |
| Scan a specific IP range | Fewer servers — faster results |
| Turn off "AUTO" | The program will stop after one batch |
| Choose the "Fast" profile | Fewer folders, files, and timeout |
| Disable "Search inside files" | Files are not downloaded — only names |
база.gz is next
to BeastFTP.exe.база.gz.Install Visual C++ Redistributable: https://aka.ms/vs/17/release/vc_redist.x64.exe
Most likely the database is not loaded yet or is still being read. Wait 5–10 seconds and check the top panel — a green indicator should appear.
Add BeastFTP.exe to antivirus exclusions.
A search is probably already running. Wait for it to finish or click "STOP". Only one search can run at a time.
No program is assigned for ftp:// links in the system.
Install FileZilla or WinSCP, or copy the link via the context menu
and paste it into your FTP client.
Progress was saved automatically. Launch the program again — a suggestion to continue from the same place will appear.
BeastFTP.exe.beast_search_state.dat if it remains.beast_ftp_license.json if it remains.Beast FTP (ip) is created for:
PROHIBITED:
The author is not responsible for any damage from using the program. Responsibility lies with the user.