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

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
qs-1.4.1.tar.gz (4.5 kB) Copy SHA256 hash SHA256 Source None Jun 27, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page