Troubleshooting

Before trying any other troubleshooting or creating an issue, please make sure that all the necessary dependencies for kivy are installed. On Debian-based distros:

sudo apt install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev libportmidi-dev libswscale-dev libavformat-dev libavcodec-dev zlib1g-dev libgl1-mesa-dev

Correct Python Version not Installed

If you don't have the correct version of Python installed to run the application, the pipenv install command will warn you about this and fail to properly execute. If you already have pyenv installed, it will prompt you to install the correct version of Python.

If you don't already have pyenv installed, pipenv will warn you that it cannot find pyenv to install the correct python version. In this case, you can install pyenv from your package manager, and rerun the pipenv install command.

Pyenv may require you to modify your .bashrc to work properly. You can find instructions on how to do this by running man pyenv.

Trouble Installing Cryptography Python Package

Cryptography is a required dependency of the msal package. That package is used for authentication to Microsoft for Microsoft To Do task information.

If during the pipenv install process fails and the error shows an issue with installing the cryptography package it is often due to issues with the Rust toolchain. My recommendation is to install rustup through your package manager, and then run rustup toolchain install stable to install the latest version of the rust compiler.

Trouble installing the Pillow dependency

If you are receiving an error about a required jpeg dependency for the Pillow package, try installing the jpeg library dependency. On Debain-based distros:

sudo apt install libjpeg-dev

If on a Debian-based distro (like RaspiOS) and running into issues with pipenv

Ensure that the latest version of pipenv is installed. Most Debian-based distros do not ship the latest version of packages like pipenv, so in this case it is usually best to uninstall pipenv from apt using the command sudo apt remove pipenv and then install directly through pip with the command pip install pipenv and then try the pipenv install command again.

During this process you may also need to add the install location to your PATH variable, as the correct location is not always in the PATH on some distros. To do this, add export PATH=/home/<username>/.local/bin/:$PATH to your .bashrc, replacing the <username> with your username. After doing so, you will either need to close and reopen your terminal, or run source ~/.bashrc.

If you run into this problem after having run the pipenv install command the first time, you may also need to rebuild the pipenv virtual environment so it can pick up the new version of pipenv. You can do so by first running pipenv --rm to remove the old virtual environment, then rerun the pipenv install command, which will automatically rebuild the virtual environment.

No web browser is opening for authentication

The first time you start the app, a web browser should opne up to allow you to authenticae to Microsoft and Spotify. Please be patient, as this can take a while on weaker Raspberry Pi's. If after a few minutes, you still aren't getting a web browser, there could be an error. One common issue is that the xdg-utils package is not installed, so Python doesn't know how to open a web browser. On Debian-based systems:

sudo apt install xdg-utils

After installing this, it is usually a good idea to reboot your computer.
If you are still having issues, feel free to open an issue.