Skip to main content

Simple http server, streaming directories as tarballs.

Project description

Serves directories as .TARs (tarball archives) over http - to be downloaded by a web browser

  • tarball_httpd extends pythons http.server/SimpleHTTPServer to serve directories as tarballs

  • the goal is to do this without creating the tarball in memory at one time

  • as much code as possible has been borrowed from python3’s http.server


  • doublecheck for XSS, LFI, directory traversal vulnerabilities

  • add more supported archive files: zip, non compressed zip, gz/gz2, ..

  • test on bsd, mac and windows


% pip install tarball_httpd


% python -m tarball_httpd
  Serving HTTP on port 8000 ( ...

% python -m tarball_httpd 12345 --bind --directory /tmp
  Serving HTTP on port 12345 ( ..

% python -m tarball_httpd -h
  usage: [-h] [--bind ADDRESS] [--directory DIRECTORY] [port]

  positional arguments:
    port                  Specify alternate port [default: 8000]

  optional arguments:
    -h, --help            show this help message and exit
    --bind ADDRESS, -b ADDRESS
                        Specify alternate bind address [default: all interfaces]
    --directory DIRECTORY, -d DIRECTORY
                        Specify alternative directory [default:current directory]

Usage without installation

% git clone
% cd tarball_httpd
% ./
  Serving HTTP on port 8000 ( ...


% ./tests/


This project is licensed under the PSF License - see the LICENSE file for details

Authors and Acknowledgments

Largs parts of its code are based on or copied from python3/lib/http/server

tarball_httpd was written by

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

tarball_httpd-0.0.3.tar.gz (5.0 kB view hashes)

Uploaded source

Built Distribution

tarball_httpd-0.0.3-py3-none-any.whl (6.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page