Skip to main content


Project description


The purpose of this code base is to provide an easy interface for creating a Raspberry Pi-based coffee camera. I found that there were too many people walking back and forth to the empty coffee pot and decided to make this little project with some parts that I had mostly laying around.


  • raspberry pi (all should work, but may need extra hardware)
  • compatible camera
  • wifi dongle (optional)
  • case (optional)
  • power adapter



At this time, you must be running this project on a Raspberry Pi or the dependency picamera will not be runnable:

pip install coffeecam


>From the Command Line

This package will serve up pages by simply starting it. If you have installed coffeecam into the path /home/myname/py3env, then you can simply:

$ sudo /home/myname/py3env/bin/coffeecam

Or, if you wish to specify a configuration file:

$ sudo /home/myname/py3env/bin/coffeecam -c /my/config/file.json

The configuration file is not required to begin execution. If a configuration file is not supplied, defaults will be assumed.

An example configuration file may be found in the examples directory.

At Reboot

>From Raspbian, you may wish to add to the crontab in order to start up at boot:

$ sudo su
$ crontab -e

Then append the line:

@reboot /home/myname/py3env/bin/coffeecam


All dependencies are pip-installable:

  • flask
  • humanize
  • picamera
  • waitress

This has only been tested on Raspbian, though it may work with other distributions.

How it Works

This package will run a flask instance which serves up a page containing a series of screenshots. This originally had a different structure, but after coming across a blog post, I decided to template the project after that.


All contributions are welcome! I could use some particular focus on adding tests and documentation, but features are always welcome as well!


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 coffeecam, version 0.2.7
Filename, size File type Python version Upload date Hashes
Filename, size coffeecam-0.2.7-py3-none-any.whl (1.1 MB) File type Wheel Python version py3 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 Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page