Welcome to inkycal v2.0.0!

GitHub issues GitHub stars GitHub forks python

Inykcal is a software written in python for selected E-Paper displays. It converts these displays into useful information dashboards. It’s open-source, free for personal use, fully modular and user-friendly. Despite all this, Inkycal can run well even on the Raspberry Pi Zero. Oh, and it’s open for third-party modules! Hooray!

Main features

Inkycal is fully modular, you can mix and match any modules you like and configure them on the web-ui. For now, these following built-in modules are supported:

  • Calendar – Monthly Calendar with option to sync events from iCalendars, e.g. Google.
  • Agenda – Agenda showing upcoming events from given iCalendar URLs.
  • Image – Display an Image from URL or local file path.
  • Slideshow – Cycle through images in a given folder and show them on the E-Paper.
  • Feeds – Syncronise RSS/ATOM feeds from your favorite providers.
  • Stocks – Display stocks using Tickers from Yahoo! Finance.
  • Weather – Show current weather, daily or hourly weather forecasts from openweathermap.
  • Todoist – Syncronise with Todoist app or website to show todos.
  • iCanHazDad – Display a random joke from iCanhazdad.com.


  • New Inkycal release published (early December 2020)
  • Added support for all 4.2″, 5.83″, 7.5″, 9.7″ waveshare E-Paper displays
  • Discord chat open now. Click here to enter

Development status

This software is in active development. To see the current development status, [Click here].


Hardware required

  • One of the supported ePaper displays from waveshare: 4.2″, 5.83″, 7.5″ (all variants), 9.7″
  • Any Raspberry Pi with 40 pins and WiFi. (Raspberry Pi 3/3B/3B+/3A/4/0W/0WH – Inkycal runs just fine on the Zero W/Zero WH model!)
  • MicroSD card (min. 4GB) for flashing Raspberry Pi OS with Desktop. Lite is not supported!
  • MicroUSB cable (for power)
  • Optional, a 3D-printable case

Installing Inkycal

Configuring the Raspberry Pi

  1. Flash Raspberry Pi OS according to the instructions. Leave the SD card plugged in your computer.
  2. Create and download settings.json file for Inkycal from the WEB-UI
  3. Download the ssh text file from the WEB-UI
  4. Create and download a WiFi-configuration file (wpa_supplicant.conf) from the WEB-UI
  5. Copy these three downloaded files to the flashed microSD card. On Windows, this is the only visible directory on the SD card. On Linux, copy these files to /boot
  6. Eject the microSD card from your computer now, insert it in the Raspberry Pi and power the Raspberry Pi.
  7. Once the green LED has stopped blinking after ~3 minutes, use an SSH client to connect to the Raspberry Pi. On Windows, you can use PUTTY but you can also use an SSH App on your smartphone. Use the address: raspberrypi.local with pi as the username and raspberry as the password. Fro more detailed instructions, check out the page from the Raspberry Pi website
  8. After connecting via SSH, run the following commands, line by line:

sudo raspi-config --expand-rootfs
sudo sed -i s/#dtparam=spi=on/dtparam=spi=on/ /boot/config.txt
sudo dpkg-reconfigure tzdata

These commands expand the filesystem, enable SPI and setup the correct timezone on the Raspberry Pi. When running the last command, please select the continent you live in, press enter and then select the capital of the country you live in. Lastly, press enter.

  1. Change the passowrd for the user pi by entering passwd in the Terminal, enter your current password, hit enter, then type your new password and press enter. Please note you will have to remember this password to access your Raspberry Pi.
  2. Follow the steps in Installation (see below) on how to install Inkycal.


Open a Terminal and enter the following command:

bash -c "$(curl -sL https://raw.githubusercontent.com/aceisace/Inkycal/main/installer.sh)"

Yes, it’s that simple! The above command runs the user-friendly installer. You can install, update and uninstall inkycal with ease. What’s more is that it also allows starting Inkycal at every boot!

Should the installer fail, please open a issue or report the problem in Discord. In the meantime, you can try the Manual Installation

If you expierence issues with getting started, please check out the FAQ. If this doesn’t help, please get help from the Inkycal Discord server, we’re happy to help!


All sorts of contributions are most welcome and appreciated. To start contributing, please follow the Contribution Guidelines.

The average response time for issues, PRs and emails is usually 24 hours. In some cases, it might be longer. If you want to have some faster responses, please use Discord (link below).

P.S: Don’t forget to star and/or watch the repo. For those who have done so already, thank you very much!

Contact and Support

Inkycal chatroom Discord

Buy me a coffee please

Yes please :). I do drink and like my coffee, especially when developing the inkycal software ? You can donate a coffee with this QR-code (Paypal):