Simple web GUI to upload files to print

Davide Alberani e7db05faf9 ability to keep documents in the queue 9 months ago
archive b318b9c46a manage number of copies and PDF files 1 year ago
dist ce6f228d79 reset fields only in case of success 11 months ago
queue ad2051e0e0 print with a random code 1 year ago
ssl 2e395edfd1 httprint: initial commit 1 year ago
.gitignore 3753236897 update gitignore 11 months ago
LICENSE.txt 2e395edfd1 httprint: initial commit 1 year ago e7db05faf9 ability to keep documents in the queue 9 months ago e7db05faf9 ability to keep documents in the queue 9 months ago


A very simple web interface to upload and print files.

Install and run


  • Python 3
  • pdfinfo executable; usually found in the poppler-utils package

To install it:

sudo python3
# if you want to install these modules for an unprivileged user, add --user and remove "sudo";
# if you want to upgrade the versions already present in the system, also add --upgrade
sudo pip3 install tornado
git clone
cd httprint
./ --debug

Now you can point your browser to http://localhost:7777/

You can also run the server in https, putting in the ssl directory two files named httprint_key.pem and httprint_cert.pem

By default:

  • the --print-with-code argument is true, and the uploaded files are just scheduled for priting. To actually print them, you should supply the generated code, for example: curl -X POST http://localhost:7777/api/print/1234
  • --max-pages is set to 10, limiting the number of allowed copies
  • --pdf-only is true, meaning that only PDF files are allowed
  • --check-pdf-pages is true, and the number of pages of a PDF are taken into consideration, calculating the maximum number of pages to print

See the --help output for more options.

Once a document is queued, it can be made persistent creating an empty file code-docname.pdf.keep in the queue directory.

License and copyright

Copyright 2019 Davide Alberani

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.