______ _______  ______     ______   ______  ______  _____  ______  _______  ______
| |       | |   | |  | \   / |      | |     | |  | \  | |  | |  | \   | |   / |
| |----   | |   | |__|_/   '------. | |     | |__| |  | |  | |__|_/   | |   '------.
|_|       |_|   |_|         ____|_/ |_|____ |_|  \_\ _|_|_ |_|        |_|    ____|_/


For advice, feedback, or help, contact me:

Discord: gulemo
Github: https://github.com/Omelug

__________________________________________________________________
INSTALLATION:
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
On Linux:
    sudo apt-get install python3 python3-pip
    make venv_init && source .venv/bin/activate (if you use venv)
    make install
__________________________________________________________________
BEFORE START:
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

requirements: python3, postgresSQL link

1/ create postgresSQL database
2/ Run "python3 ftp_config.py --generate_default" for generating config.json
3/ edit database connection in ftp_secret.py (optionally edit config.json)
4/ ftp_hub is main script, good luck

__________________________________________________________________
USAGE:
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

You can use ftp_hub.py to every command, it will be automatic redirected

Dont forget "source .venv/bin/activate" if you are using venv

__________________________________________________________________
ftp_hub.py
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
usage: Example: save_ranges -> scan_all_ranges -> check_all_ftp_anon | scan_all_versions

options:
      -h, --help            show this help message and exit
      --save_ranges         ranges.txt file with ranges in format <ip_start> <ip_stop> <count> <date> company
      --scan_all_ranges     --scan_all: Scan all RANGE in the database, rescan older than old_delay_days
      --scan_all_versions   --scan_all_versions : Scan version of all connected
      --print_ftp_list      Print ftp list to stdout



__________________________________________________________________
ftp_forest.py
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

usage: ftp_forest.py [-h] [--anon_all] [-d LIST] [-lvl MAX_LVL] [--quite] [--user USER] [--password PASSWORD] [--crack]

options:
  -h, --help           show this help message and exit
  --anon_all           --anon_all <n> : Try anonymous: login for all FTP_con,
                       retry older than n days
  --quite              TODO NOT AVAIBLE NOW | Do not display servers that are
                       not responding in the terminal log.
  --user USER          Username
  --password PASSWORD  Password
  --crack              File containing user and password separated by :





__________________________________________________________________
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Inspiration and maybe some code parts are from:

https://github.com/richmas-l/Anonymous-FTP-Scanner/blob/main/ftpscanner.py
https://github.com/Sunlight-Rim/FTPSearcher/tree/main?tab=readme-ov-file
https://github.com/rethyxyz/FTPAutomator/blob/main/FTPAutomator.py
https://github.com/tfwcodes/FTP-exploits.git
https://github.com/imnikola/ShodanAnomymousDirs/blob/master/ShodanOpenDirs.py


__________________________________________________________________
TODO
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

1/ control prints, add quite and debug option
2/ make cleaner Key Interrupt, leave live connections save progress (tree are not cut)
3/ progress bar