Cinnamon Dynamic Wallpaper

About the project

This extension switches the background image of your Cinnamon desktop multiple times in a day, based on a location or custom time periods. You can choose between included image-sets, your own HEIC-file or a source folder with single images. Configuration through a user-friendly configuration window.

Features

• 12 included image sets
• 10 day periods
• HEIF converter
• Image configuration assistent with simple one-click setup for image choices
• Online location estimation (three provider) or offline with manual latitude and longitude input
• Time periods individual configured by user
• Offline sun angles estimation
• Image stretching over multiple displays or repeat image for every display
• Creating a color gradient based on the current wallpaper for images which not fill the whole screen

Tested Cinnamon versions

• 5.4 (Mint 21)
• 5.6 (Mint 21.1)
• 5.8 (Mint 21.2)
• 6.0 (Mint 21.3)

Technology

• JavaScript
  • Display desktop notifications
  • Calling the Python loop script every 60 seconds to refresh the background image
• Python
  • Handles the preference window
  • Esimates the location
  • Changes of the desktop wallpapers
• Glade

  • Preference window UI design

    Installation

    From Built-in Extension Manager

    1. Open "Extensions" in Linux Mint or any other distribution with Cinnamon as Desktop Environment
    2. Click on "Download"
    3. Search and download it

From the repo

1. Download the latest from the Releases page on GitHub: https://github.com/TobiZog/cinnamon-dynamic-wallpaper/releases
2. Extract the files

3. Copy the folder cinnamon-dynamic-wallpaper@TobiZog to ~/.local/share/cinnamon/extensions/

   Usage

4. Active the Extension via Cinnamon Extension Manager
5. Open the settings
6. Configure it to your
   • You can apply the setted settings without closing the window if you click on "Apply"

7. If your config is complete, click on "OK"

   Preferences Window

   Because of the lack of configuration options in the standard Cinnamon configuration system for extensions offers this extension a custom preference window.
   All configuration will be handled there. You can choose between included image sets, a HEIC file or a folder source and set the image to ten different daytime periods. Time periods will be estimated via network, custom coordinations or custom time periods. Some behaviour preferences (strech image, fill empty background with gradient color) are also here.

   Contribute

   Translation

   You want to contribute a language which isn't supported yet? Here is how to do:

8. Fork the cinnamon-spices-extensions project: https://github.com/linuxmint/cinnamon-spices-extensions
9. Pull the repository
10. Open cinnamon-dynamic-wallpaper@TobiZog/files/cinnamon-dynamic-wallpaper@TobiZog/po/cinnamon-dynamic-wallpaper@TobiZog.pot with a po-tool like poedit (https://poedit.net/).
11. Create a new translation in your language
12. Push the changes to your repository
13. Create a pull request