This downloads weekly database dumps from the FCC's public database for various radio services including amateur radio, GMRS, land mobile, cellular, microwave, and more. The tool handles automatic extraction of zip files and organizes everything into a clean directory structure.

Installation

pip install -r requirements.txt

Requirements:

Python 3.7+
aiohttp
beautifulsoup4
tqdm

Usage

Basic Download (5 concurrent downloads)

python download.py

List Available Databases

python download.py --list

Custom Concurrency

python download.py -c 10

Debug Mode

python download.py --debug

Command-Line Arguments

Argument	Short	Type	Default	Description
`--list`	`-l`	flag	-	List available databases without downloading
`--concurrency`	`-c`	int	5	Maximum number of concurrent downloads
`--debug`	`-d`	flag	-	Enable debug logging output

Output Structure

Downloaded files are saved to assets/fcc_data/YYYY-MM-DD/ with the following structure:

assets/fcc_data/2025-11-26/
├── amateur_radio_service/
│   ├── applications/
│   │   ├── AM.dat
│   │   ├── CO.dat
│   │   ├── EN.dat
│   │   └── ...
│   └── licenses/
│       ├── AM.dat
│       ├── HD.dat
│       └── ...
├── gmrs/
│   ├── applications/
│   └── licenses/
├── cellular_47_cfr_part_22/
└── ...

Each category (e.g., amateur_radio_service) contains subdirectories for different file types (e.g., applications, licenses). The downloaded zip files are automatically extracted and the original archives are removed to save space.