FalconA Modern, Cross-Platform C++ Resource Transfer Engine

The main-view design prototypes (warm console / cold utility) and live desktop screenshots (download management, completed list, add-download dialog, cloud storage, settings) rotate automatically — hovering pauses the carousel, and you can switch with the left/right arrows, the dots, or the keyboard arrow keys.

More UI screenshots (52 in total: 13 views × light/dark × two window widths) are available in the repository at docs/design/ui-sandbox/.

Quick Preview ​

Install ​

# Build from source
git clone https://github.com/cuihairu/falcon.git
cd falcon
cmake -B build -S . -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

The current documentation focuses on building from source; it no longer assumes that Homebrew, APT, or prebuilt installers have been published.

Basic Usage ​

# Download a single file
falcon-cli https://example.com/file.zip

# Multi-threaded download
falcon-cli https://example.com/large.zip -c 5

# Read URLs from a file for batch downloading
falcon-cli -i urls.txt -j 3

# Download through a proxy
falcon-cli https://example.com/file.zip --proxy http://127.0.0.1:7890

C++ API ​

#include <falcon/falcon.hpp>

int main() {
    falcon::DownloadEngine engine;

    falcon::DownloadOptions options;
    options.max_connections = 5;

    auto task = engine.add_task(
        "https://example.com/file.zip",
        options
    );

    if (task) {
        engine.start_task(task->id());
        task->wait();
    }
    return 0;
}

Project Structure ​

falcon/
├── packages/
│   ├── libfalcon-core/      # Core download engine, task model, event system
│   ├── libfalcon-protocols/ # Standard download protocols
│   ├── libfalcon-storage/   # Object storage and resource browsing
│   ├── libfalcon-drives/    # Cloud drive and share-link capabilities
│   ├── falcon-cli/          # Command-line tool
│   └── falcon-daemon/       # Background daemon
├── apps/
│   ├── desktop/             # Desktop application
│   └── browser_extension/   # Browser extension
└── docs/                    # Project documentation

Protocol Support ​

Contributing ​

Contributions, bug reports, and suggestions are welcome!

• GitHub Issues
• Contributing Guide

License ​

Apache License 2.0