circadian-desktops 0.0.3

An app that changes your desktop background based on time of day.

CIRCADIAN DESKTOPS

Description

Circadian Desktops is a Python app for Windows 10 that changes your desktop background based on time of day.

Desktop Images

Allows users to select different image files to use as desktop background during dawn, day, dust and night. A single image can be selected for each period or the app can be set to shuffle images from the selected image's folder.

Transition Times

The app determines image transition times based on sunrise and sunset times at the users location. This is calculated using two non-standard library Python modules:

• Geocoder - Retrieves the users location and timezone using their IP address.
• Astral - calculates sunrise and sunset times based on user location and the current date.

Alternatively, the user can select their own times for images to transition.

Preferences

The app offers three additional options:

• Dark Theme - Toggles the GUI between light and dark theme.
• Minimize to tray - When selected the app will minimize to the system tray and continue running, instead of shutting down when the window in closed.
• Run on startup - The app to run in the background when the computer is started.

Installation

To install Circadian Desktops as a library module from PyPI:

python -m pip install circadian_desktops

Alternatively, copy the contents of the src/circadian_desktops directory.

Usage

With Circadian Desktops installed in Python's library packages, run:

python -m circadian_desktops

Alternatively, provide a reference to its location (without the -m flag):

python C:\example\path\to\app\circadian_desktops

App files

The circadian_desktops directory contains:

• __init__.py - Empty file to identify module.
• __main__.py - Entry point to run module as a script.
• app.py - Primary script to run the app. Contains the MainWindow class and script to start app.
• functions.py - Helper functions called by app.py. Handles functionality outside the GUI.
• ui_mainwindow.py - Python script generated from destopUi.ui by pyuic5. Used as GUI layout for MainWindow in app.py.
• desktopUi.ui - Widget layout for GUI generated by Qt Designer. Not required for app to run.
• custom_qt.py - Contains a custom QtPalette class used for 'dark theme'.
• Icons/ - Folder with image files used in GUI and for Windows system icons.