{"id":21639375,"url":"https://github.com/sudorook/timed-backgrounds","last_synced_at":"2025-03-19T02:09:59.165Z","repository":{"id":83499747,"uuid":"105379341","full_name":"sudorook/timed-backgrounds","owner":"sudorook","description":"A collection of backgrounds that transition along day/night cycles.","archived":false,"fork":false,"pushed_at":"2024-12-16T02:01:08.000Z","size":19095,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T03:11:51.792Z","etag":null,"topics":["backgrounds","timed-backgrounds","timed-wallpapers","wallpapers"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sudorook.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2017-09-30T15:26:33.000Z","updated_at":"2024-12-16T02:01:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"517d7d59-b379-4073-a973-4308bec7472b","html_url":"https://github.com/sudorook/timed-backgrounds","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Ftimed-backgrounds","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Ftimed-backgrounds/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Ftimed-backgrounds/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Ftimed-backgrounds/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudorook","download_url":"https://codeload.github.com/sudorook/timed-backgrounds/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244339044,"owners_count":20437169,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backgrounds","timed-backgrounds","timed-wallpapers","wallpapers"],"created_at":"2024-11-25T04:13:36.136Z","updated_at":"2025-03-19T02:09:59.145Z","avatar_url":"https://github.com/sudorook.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Timed Backgrounds\n\n**Build Requirements:** autotools, glib, geoclue2, libxml\n\nThis is a set of timed backgrounds that change during the day.  The time\ntransitions are calculated by\n[equations](http://www.srrb.noaa.gov/highlights/sunrise/calcdetails.html)\noutlined by the U.S. Department of Commerce, National Oceanic and Atmospheric\nAdministration and implemented in\n[Redshift](https://github.com/jonls/redshift).\n\nOnly tested on Cinnamon and GNOME desktop environments, but will work with any\nother desktop environment that supports `gnome-backgrounds`.\n\nAvailable backgrounds:\n * 24 hours (by [Arzamas](https://www.deviantart.com/arzamas/gallery))\n * Firewatch (by [Campo Santo](https://blog.camposanto.com/post/138965082204/firewatch-launch-wallpaper-when-we-redid-the) and [\\_felics](https://www.reddit.com/r/Firewatch/comments/458ohf/i_made_a_night_version_of_the_launch_wallpaper/))\n * Island (by [arsenixc](https://arsenixc.deviantart.com/gallery/))\n * Metropolis (by [???](https://imgur.com/a/JH7RJ#2))\n * Mountainside (by [???](https://imgur.com/a/vqb7Q))\n\n\n## Configuration\n\nTo compute you sunrise and sunset times, you can specify your latitude and\nlongitude manually, or you can use geoclue2 to compute it based on your IP\naddress. The geoclue2 option is much slower and requires a network connection.\n\nIf the config file does not exist, the program will default to using\n`geoclue2`.\n\n\n### Manual\n\nCreate a file called `~/.config/backgrounds.conf` and add:\n\n```\n[backgrounds]\nlocation-provider=manual\n\n[manual]\nlat=\u003clatitude\u003e\nlon=\u003clongitude\u003e\n```\n\n### Geoclue2 (default)\n\nCreate a file called `~/.config/backgrounds.conf` and add:\n\n```\n[backgrounds]\nlocation-provider=geoclue\n```\n\n\u003e Note: If using the geoclue2 option, make sure that your IP address is located\n\u003e where you are. If you are, for example, behind a VPN, the script will set the\n\u003e sunrise and sunset times corresponding to where the network servers are.\n\n## Building\n\nRun:\n```\ngit clone https://github.com/sudorook/timed-backgrounds.git\ncd timed-backgrounds\n./autogen.sh\nmake\nsudo make install\n```\n\nThe backgrounds will be installed in `/usr/share/backgrounds/timed` and the\nrelevant metadata in `/usr/share/gnome-background-properties`,\n`/usr/share/cinnamon-background-properties`, and\n`/usr/share/mate-background-properties`.\n\nUninstall by running `sudo make uninstall`.\n\n\u003e Note: Times for sunrise and sunset vary throughout the year due to the tilt\n\u003e in Earth's axis. Recompile and reinstall the backgrounds periodically so that\n\u003e the transition times match real-world day/night cycles. The sunrise/sunset\n\u003e equations do not take into account elevation.\n\nTo rebuild and reinstall, run:\n```\nmake clean\nmake\nsudo make install\n```\n\n\n### GNOME\n\nTo select a wallpaper in GNOME, use \"Backgrounds\" in \"System Settings\".\n\n\n### Cinnamon\n\nPreviously, setting timed backgrounds in Cinnamon was not possible using the\nsettings GUI, but this has now been\n[fixed](https://github.com/linuxmint/Cinnamon/issues/5586). For Cinnamon\nversions older than 4.4.3, use the following to set the background:\n\n```\ndconf write /org/cinnamon/desktop/background/picture-uri \"'file:///usr/share/backgrounds/timed/\u003ctimed-background\u003e.xml'\"\n```\n\n\u003e Note: By default, Cinnamon looks for the timed.xml file (which contains a\n\u003e list of all the available backgrounds) in\n\u003e `/usr/share/cinnamon-background-properties/`, but some distros (such as Arch)\n\u003e patch it to look in `/usr/share/gnome-background-properties/` instead.\n\n\n### MATE (Untested)\n\nBackground metadata is installed in `/usr/share/mate-background-properties`. If\nthey cannot be selected via the mate background app, you will need to use dconf\nto select one manually. See the above instructions for Cinnamon.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudorook%2Ftimed-backgrounds","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudorook%2Ftimed-backgrounds","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudorook%2Ftimed-backgrounds/lists"}