Hallaxius CLI

Upload

Upload files up to 200 GB with multipart support, real-time progress bars, and resume capability.

Local File

Upload any local file by providing its path. Supports drag-and-drop paths, quoted paths with spaces, and all file types.

$hallaxius upload photo.png
$hallaxius upload "C:\Users\ZyRox\Documents\report.pdf"
$hallaxius up video.mp4 -p mypassword --slug my-video

URL Download & Upload

Pass a URL instead of a file path. The CLI downloads the file to a temporary directory, uploads it, and cleans up automatically.

$hallaxius upload https://example.com/archive.zip
Terminal
Downloading... ✓ archive.zip (45.2 MB)
Uploading... ✓
URL https://cdn.hallaxi.us/abc123

URL downloads are validated against blocked MIME types (executables, installers, etc.) to prevent uploading potentially dangerous files.

Flags

FlagDescription
-v, --verboseVerbose output (SHA-256, chunk size)
--jsonJSON output for scripting and automation
-p, --password <pass>Password-protect the uploaded file
--slug <slug>Set a custom slug for the upload URL
-e, --expires <time>Set expiry time (e.g. 1d, 7d, 30d)

JSON Output

Use --json for machine-readable output, ideal for scripting and CI/CD pipelines.

$hallaxius upload photo.png --json
Terminal
{
"success": true,
"url": "https://cdn.hallaxi.us/abc123",
"message": "Upload completed successfully",
"totalTimeSeconds": 3.42
}

Progress Bar

During uploads, an animated progress bar displays real-time status including speed, progress, and ETA.

Terminal
⠋ [████████████░░░░░░░░░░░░░░░░░░] 42.3% 3/7 12.5 MB/s ETA 00:45

Resuming Uploads

If an upload is interrupted, it is saved as pending. You can list and resume pending uploads at any time.

$hallaxius pending
Terminal
Pending uploads
 
abc12345...
Size: 150 MB
Path: C:\Users\ZyRox\Videos\video.mp4
$hallaxius resume abc12345

The CLI verifies the file still exists and its size hasn't changed before resuming. If the file was modified, the resume will be rejected.

Multipart Upload

Large files are split into chunks and uploaded in parallel for maximum speed. Files are delivered from Cloudflare's global edge network for fast downloads anywhere in the world.