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.


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
Twitter: @Cym13
GPG: 383A 76B9 D68D 2BD6 9D2B 4716 E3B9 F4FE 5CED 42CB

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


This version
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.2.1.tar.gz (4.3 kB) Copy SHA256 hash SHA256 Source None Jun 23, 2014

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