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.1.tar.gz (5.5 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.1-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: streamshatter-1.0.1.tar.gz
  • Upload date:
  • Size: 5.5 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.1.tar.gz
Algorithm Hash digest
SHA256 db3bae41c9ae9ead1b56b54fad4bf8798a3ac8c381fa84c59b31c062f0117872
MD5 ee34cc967bd1968b494724e9a01fb3d6
BLAKE2b-256 629bb9f0c32ef1157a5e1e662b21179b0a2941599d8f3be6b8859d8d7f4bdb25

See more details on using hashes here.

File details

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

File metadata

  • Download URL: streamshatter-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 6.4 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 63441b9b9777965e84241d0aff6d8f3f4184a9f228ba1ca1c7c899c9111fd859
MD5 34a14a0cd42384989deff1bab8286934
BLAKE2b-256 360dc5119e249702d593cab8b8c28117bb240e0246da868f135c54ddbe40281c

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