Skip to main content

Multiplexed chunked file downloader

Project description

StreamShatter

Originally a very basic script for reliably downloading files from servers with inconsistent connections, this project has been revisited and modernised to use https://github.com/jawah/niquests to greatly improve multiplexing performance, for those who still have use for such a tool.

StreamShatter takes advantage of the Range HTTP header to dynamically allocate multiple chunks, by starting with one streaming request and gradually bisecting it while bandwidth permits, all without restarting the download. This allows for single, large file downloads from hosts that, whether intentionally or unintentionally, have degraded throughputs. The individual chunks also serve as checkpoints for if/when connections are broken.

Installation

  • Install python and pip
  • Install StreamShatter as a package: pip install streamshatter

Usage

usage: streamshatter [-h] [-V] [-H HEADERS] [-c CACHE_FOLDER] [-l LIMIT] url [filename]

Multiplexed chunked file downloader

positional arguments:
  url                   Target URL
  filename              Output filename

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -H, --headers HEADERS
                        HTTP headers, interpreted as JSON
  -c, --cache-folder CACHE_FOLDER
                        Folder to store temporary files
  -l, --limit LIMIT     Limits the amount of chunks to download

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

streamshatter-1.0.2.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

streamshatter-1.0.2-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file streamshatter-1.0.2.tar.gz.

File metadata

  • Download URL: streamshatter-1.0.2.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.5

File hashes

Hashes for streamshatter-1.0.2.tar.gz
Algorithm Hash digest
SHA256 b415495543a6f18d8b506a2aa39d25d7835d06f795149a5e7e5650bcc796c817
MD5 3279722e2c14407d343bcd27a9d51e4f
BLAKE2b-256 436fb0efd8ebaafeb06ecd3181f11ba3577a2b8cb21bd6addef74c61977eb28e

See more details on using hashes here.

File details

Details for the file streamshatter-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: streamshatter-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.5

File hashes

Hashes for streamshatter-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6f97e1e05b7fb696466f141c8a8ac08efc833ec21bc4e747182ead288f48de28
MD5 c50562b8b4c302f087da7d5a1e9d3362
BLAKE2b-256 3572400c6bfea64fdb93d07e5143bae5391742632ac8ee9be9867b3e83058c50

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page