file · Command reference
qzx downloadFile
What it does
Downloads a file from the Internet (similar to 'wget' or 'curl' in Unix)
Command maturity: Alpha
Available for real use and feedback while its interface and behavior can still evolve. This is the current development-checkout assessment. Every future immutable release tag preserves the exact assessment shipped by that version. Available in PyPI 0.2.2.0.8. This page documents the 0.2.2.0.8 alpha development checkout.
Behavior and built-in protections
Live mode applies the changes you request
Direct execution for this operation
Works without invoking native programs
Uses network access for the documented task
No elevation required by design
Creates a new destination without approval. Existing destinations remain untouched unless --overwrite is explicit; an overwrite creates a fail-closed safety backup first. Only absolute HTTP/HTTPS URLs are accepted, the timeout is enforced, and the final replacement is atomic.
QZX creates a recovery archive before live changes; use --dangerously-bypass-approvals-and-sandbox/--yolo only when you deliberately choose to skip it.
This safety classification was reviewed by OpenAI GPT-5.6 Pro against implementation digest sha256:bfba9193ca946ab5eb99d10987b6d6103468ff086964a3dc21d3237d2a022a34 on 2026-08-25.
Exact syntax
qzx downloadFile <url> <destination_path> [show_progress] [timeout] [overwrite] --jsonParameters
Swipe or use the horizontal scrollbar to see every column.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| url | str | Yes | Not declared | URL of the file to download |
| destination_path | str | Yes | Not declared | Path where to save the downloaded file |
| show_progress | bool | No | true | Whether to show download progress |
| timeout | int | No | 30 | Maximum wait time in seconds |
| overwrite | bool | No | false | Replace an existing destination after creating a safety backup |
Input examples
qzx downloadFile https://example.com/file.txt downloads/file.txtDownload a sample file
qzx downloadFile https://example.com/file.zip downloads/file.zip falseDownload a file without showing progress
qzx downloadFile https://example.com/large-file.iso downloads/file.iso true 120Download a large file with extended timeout
qzx downloadFile https://example.com/file.txt downloads/file.txt --overwriteReplace an existing file after creating a safety backup
For the complete structured payload, add --json: qzx downloadFile <url> <destination_path> [show_progress] [timeout] [overwrite] --json
Representative output example
This illustrative JSON is derived from the current implementation-backed result contract. It shows what the command can return without claiming a recorded execution; values vary with inputs, host, permissions, and optional tools.
Example command: qzx downloadFile https://example.com/file.txt downloads/file.txt --json
{
"success": true,
"message": "Downloads a file from the Internet (similar to 'wget' or 'curl' in Unix). In this illustrative example, the command completed successfully.",
"meta": {
"command": "downloadFile",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 0,
"schema_version": 1
},
"destination": "C:\\project\\example.txt",
"details": {
"destination": "C:\\project\\example.txt"
},
"overwrite": true,
"show_progress": [
{
"name": "example",
"status": "ok"
}
],
"start_time": "Example value",
"timeout": "Example value",
"url": "https://example.com"
}View the JSON result contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"destination": [],
"details": {
"oneOf": [
{
"type": "object",
"properties": {
"destination": []
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"destination": [],
"overwrite": {
"type": "boolean"
}
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"timeout_seconds": [],
"partial_file_removed": {
"type": "boolean"
}
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"url": [],
"allowed_schemes": {
"type": "array"
}
},
"additionalProperties": true
}
]
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"overwrite": [],
"show_progress": [],
"start_time": [],
"timeout": [],
"url": []
},
"additionalProperties": true
}Errors and limits
The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.
QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.
Evidence workflow: requires an authorized endpoint or reviewed fixture.
Evidence and provenance
- Implementation
- src/qzx/commands/file/download_file.py
- Documentation channel
- Development documentation 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Availability
- 0.2.2.0.8 or earlier
Keep exploring
Related commands
These commands also belong to the file category. Compare them to choose the operation that best fits your task.
qzx detectFileTypeIdentifies a regular file from bounded content signatures with an optional libmagic refinement and an explicit extension comparisonqzx extractZipExtracts files from a ZIP archive after validating paths, types, limits, and destination conflictsqzx deletePathPreviews or deletes a file or directory from the filesystemqzx findBrokenSymlinksScans directories for broken symbolic links (pointing to nonexistent files or folders)