README.org

Comporellon - ePaper Calendar & Weather Display

Setup & Run

Install system dependencies (see below), then run the following:

# git clone $repo_url comporellon
cd comporellon

# install python requirements
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# copy and populate environment file
cp environment.example environment
editor environment

./run

Example cronjob:

# chronic is part of moreutils, only prints stdout/stderr if return code != 0
*/30 * *   *   *  chronic /home/pi/comporellon/run

Configuration

See ./environment.example and the beginning of the gather_* scripts.

System Dependencies

apt install \
   poppler-utils \
   imagemagick \
   python3 \
   latexmk \
   texlive texlive-latex-recommended \
   texlive-fonts-recommended \
   texlive-fonts-extra \
   texlive-xetex \
   moretuils

pytz
vobject
jinja2
pyowm
caldav

Display Refresh Tool

Now includes the tool waveshare-epaper/display.cc to refresh 7.5” Waveshare displays

Development

Use dry_run_with_test_data to generate from mock data in the working directory. There will be a display.png, and display.pdf as output.

Documentation

https://irq0.org/code/epaper-calendar