Skip to main content

CLI program to quickly share directories using a http server

Project description


QuickShare (qs) is a variant of the (now legacy) SimpleHTTPServer present in python 2.x. It allows one to share quickly directories by opening a http server. qs supports both python2 and python3.

You can define an upload rate limit to prevent the clients from using all your bandwidth and it automatically searches a free port if the given or default one is taken.

Why QuickShare?

Sharing is fun, but it quickly becomes a pain when dealing with multiple operating systems, platforms and unexperimented users. Nowadays, almost everything has a web interface, why should’nt we use it?


Usage: qs [-h] [-p PORT] [-r RATE] [--no-sf] [FILE]...

    -h, --help       Print this help and exit.
    -p, --port PORT  Port on which the server is listenning.
                     Default is 8000
    -r, --rate RATE  Limit upload to RATE in ko/s.
                     Default is 0 meaning no limitation.
    --no-sf          Do not search a free port if the selected one is taken.
                     Otherwise, increase the port number until it finds one.
    --version        Print the current version

    FILE             Files or directory to share.
                     Default is the current directory: `.'
                     If '-' is given, read from stdin.
                     If 'index.html' is found in the directory, it is served.


docopt or “pip install docopt”


The simplest is to use

pip install qs

or, in this directory,

python install


This program is under the GPLv3 License.

You should have received a copy of the GNU General Public License along with this program. If not, see <>.


Main developper: Cédric Picard

Project details

Download files

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

Files for qs, version 1.4.1
Filename, size File type Python version Upload date Hashes
Filename, size qs-1.4.1.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View

Supported by

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