linux-iso/examples/README.md

Examples

This directory contains example scripts demonstrating various ways to use the Linux ISO downloader.

Available Examples

1. download_specific.py

Download only specific distributions (Ubuntu and Fedora in this example).

python examples/download_specific.py

Features:

• Downloads only Ubuntu and Fedora ISOs
• Uses fewer parallel workers (2) for demonstration
• Saves files to ./examples_output/

2. create_custom_categories.py

Demonstrates how to create custom URL files for different categories of Linux distributions.

# Create category files and download lightweight distributions
python examples/create_custom_categories.py

# Download enterprise distributions
python examples/create_custom_categories.py --enterprise

# Show help
python examples/create_custom_categories.py --help

Features:

• Creates custom URL files for different distribution categories
• Lightweight distributions (Arch-based): Arch Linux, EndeavourOS, Manjaro
• Enterprise distributions (RHEL-based): AlmaLinux, Rocky Linux, Oracle Linux
• Organizes downloads into category-specific subdirectories

Output Structure

When running examples, files are organized as follows:

examples_output/
├── lightweight/          # From create_custom_categories.py
│   ├── archlinux-x86_64.iso
│   ├── EndeavourOS-Mercury-Neo-2025.03.19.iso
│   └── manjaro-gnome-25.0.4-250623-linux612.iso
├── enterprise/           # From create_custom_categories.py --enterprise
│   ├── AlmaLinux-10.0-x86_64-dvd.iso
│   ├── Rocky-10.0-x86_64-dvd1.iso
│   └── OracleLinux-R10-U0-x86_64-dvd.iso
└── ubuntu-24.04.2-desktop-amd64.iso  # From download_specific.py
└── Fedora-Workstation-Live-42-1.1.x86_64.iso

Custom URL Files

The create_custom_categories.py script generates these URL files:

• examples/lightweight_distros.txt - Arch-based distributions
• examples/enterprise_distros.txt - Enterprise Linux distributions

You can modify these files or create your own custom URL files to download specific sets of distributions.

Tips

1. Start Small: Begin with the download_specific.py example to understand the basic usage
2. Custom Categories: Use create_custom_categories.py as a template for your own categorization needs
3. Modify URLs: Edit the generated URL files in the examples/ directory to customize which distributions to download
4. Output Directories: Each example uses different output directories to keep downloads organized

Creating Your Own Examples

Use these examples as templates to create your own custom download scripts:

1. Import the ISODownloader class from download_isos
2. Define your list of URLs
3. Create a downloader instance with your preferred settings
4. Call download_all() with your URLs

from download_isos import ISODownloader

# Your custom URLs
urls = ["https://example.com/distro.iso"]

# Create downloader
downloader = ISODownloader(
    output_dir="./my_downloads",
    max_workers=3,
    retry_attempts=5
)

# Download
successful, failed, results = downloader.download_all(urls)