Giter VIP home page Giter VIP logo

timelywall's Introduction

Timely Wallpaper

Changes Wallpaper based on time of day and position of sun. Will work with Cinnamon and likely Gnome and Unity. Maybe Mate too.

Wallpaper is changed for

  • Night - whenever the sun is below the the horizon after local twilight
  • Morning - During local twilight before noon.
  • Daytime - when the sun is visible
  • Evening - During local twilight after noon.

Installation

Requirements:

  • pyephem - See below
  • GTK 3.0
  • Python 2.6+

The program will run from any directory it is cloned or unzipped to. To set up a desktop menu entry you may use installdesktop.sh from the directory where you cloned or unzipped the files and the desktop file will be created and the entry made. The program knows how to "find it's way home" - when run it will change to the directory where the main script is located and get its resources from there.

Configuration

An icon is placed in the system tray. It will, when clicked, bring up the configuration dialog. Configuration items are:

  • Night: Path for Night Images
  • Morning - Path for Monring Images
  • Daytime - Path for Daytime Images
  • Evening - Path for Evening Images
  • Cycle Images: Set to allow image cycling else the first found image in each path will be used.
  • Order: The sorting order for the image cycling (Name,Date,Random)
  • Latitude/Longitude: Where you are in the world. (See notes below)
  • Altitude: Your elevation.
  • Twilight Type: Civil, Nautical, Astronomical (See notes below)
  • MorningEnds: Follow twilight or end morning when the sun is 6°, 12° or 18° above horizon
  • EveningStarts: Follow twilight or start evening when the sun is 6°, 12° or 18° above horizon

Notes

Latitude and Longitude can be in decimmal or deg:min:sec notation. Western longitudes and southern latitudes are negative Return a string indicating night, morning, datime or evening. Examples:

Los Angeles, CA is 34.039714/-118.310327 or 34:02:22.3828/-118:18:37.136

Sydney, AU is -33.8688/151.2093 or -33:52:7.68/151:12:33.48

*Please see the ephem (PyPi) documentation (http://rhodesmill.org/pyephem/) for full specifications of coordinates.

Twlight is specified as Civil (-6 degrees) Nautical (-12 degrees) and Astronomical -18 degrees.

If using civil twilight:

It is night when the sun is below -6 degrees on the horizon.

It is morning when it is before noon and the sun is between -6 and 0 degrees on the horizon

it is after noon when the hour is >= 12 and the sun is greater than 0 degrees on the horizon

It is evening when it is after noon and the sun is between 0 and -6 degres on the horizon

Intalling pyephem

You must have the package python-pip installed for this. To install python-pip in Debian based distributions, install with: sudo apt-get install python-pip

You may then install pyephem with: pip install ephem or sudo pip install ephem

timelywall's People

Contributors

nicciniamh avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.