.github | ||
fonts | ||
Gallery | ||
images | ||
logs | ||
modules | ||
settings | ||
auto-update.sh | ||
Changelog.md | ||
Installer.sh | ||
LICENSE | ||
README.md | ||
requirements.txt | ||
wpa_supplicant.conf |
A python 3 software for 7.5" E-Paper displays from waveshare/gooddisplay to display events from iCalendars, weather from openweathermap and RSS feeds.
Main features
- Monthly Calendar that shows events from your Google (or other) iCalendar/s
- Live weather info and forecasts for next 9 hours (openweathermap)
- Agenda to show what is on your shedule (from your iCalendar/s)
- RSS feeds from various providers to keep up to date with news, quotes etc.
News:
- Version 1.7 released with weather forecasts and fully new UI (Mid December 2019)
- Thank You everyone for the first 100 stars :D
- Added support for recurring events
- Added support for Debian Buster, Buster Lite is not supported!
- Added a user-friendly Web-UI for adding details to the programm (Credit to TobyChui for the template)
Preview
Hardware required
- 7.5" 3-Colour E-Paper Display (Black, White, Red/Yellow) with driver hat from waveshare or
- 7.5" 2-Colour E-Paper Display (Black, White) with driver hat from waveshare
- Raspberry Pi Zero WH (with headers) (no soldering iron required)
- Or: Raspberry Pi Zero W. In this case, you'll need to solder 2x20 pin GPIO headers yourself
- MicroSD card (min. 4GB)
- MicroUSB cable (for power)
- Something to be used as a case (e.g. a RIBBA photo-frame or a 3D-printed case)
Setup
Getting the Raspberry Pi Zero W ready
- After flashing Raspbian Buster (with Desktop), set up Wifi on the Raspberry Pi Zero W by copying the file wpa_supplicant.conf (from above) to the /boot directory and adding your Wifi details in that file.
- Create a simple text document named ssh in the boot directory to enable ssh.
- Expand the filesystem in the Terminal with
sudo raspi-config --expand-rootfs
- Enable SPI by entering
sudo sed -i s/#dtparam=spi=on/dtparam=spi=on/ /boot/config.txt
in the Terminal - Set the correct timezone with
sudo dpkg-reconfigure tzdata
, selecting the correct continent and then the capital of your country. - Reboot to apply changes
- Optional: If you want to disable the on-board leds of the Raspberry, follow these instructions: Disable on-board-led
Installing required packages for python 3.x
Execute the following command in the Terminal to install all required packages. Please use Raspbian Buster with Desktop (preferably the latest version). Raspbian Buster LITE is not supported.
bash -c "$(curl -sL https://raw.githubusercontent.com/aceisace/Inky-Calendar/master/Installer.sh)"
If the Installer should fail for any reason, kindly open an issue and paste the error. Thanks.
Screenshot of the installer:
Adding details to the programm
When you run the installer, you can add details in the last step. For new-users, it is recommended to use the 'web-UI' option.
You can also manually edit the settings file like this: nano /home/$USER/Inky-Calendar/settings/settings.py
If you encounter any issues, please leave a comment in the issues or via email. Thanks in advance.
iCalendar
With the latest release (v1.7), most iCalendars (Google, Yahoo, etc.) will work without problems. With Google and Yahoo, recurring events are now supported as well. With the other iCalendar providers, testing has not been done.
Event names will be truncated until they fit in their allocated space/line. Try avoiding too long event names.
If you encounter errors related to your iCalendar, please feel free to report the error either by opening an issue or by sending a mail.
Updating
Before updating, re-name the current Inky-Calendar folder e.g. Inky-Calendar-old and then run the installer again (see above), choosing the update option.
Contributing
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.
Don't forget to check out the Wiki. It contains all the information to understanding and customising the script.
P.S: Don't forget to star and/or watch the repo. For those who have done so already, thank you very much!
Contact
- Email: aceisace63@yahoo.com (average response time < 24 hours)
- Website: aceinnolab.com (coming soon)