Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/desertplant/moon-phase-background
Change desktop background to a high resolution picture of the current moon phase from NASA
https://github.com/desertplant/moon-phase-background
astronomy cinnamon cinnamon-desktop cinnamon-theme desktop desktop-background linux linux-mint linuxmint mint moon moon-phase moonphase nasa open-source space theme wallpaper wallpaper-changer
Last synced: about 2 months ago
JSON representation
Change desktop background to a high resolution picture of the current moon phase from NASA
- Host: GitHub
- URL: https://github.com/desertplant/moon-phase-background
- Owner: desertplant
- License: mit
- Created: 2021-07-16T12:26:12.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-02T14:12:50.000Z (7 months ago)
- Last Synced: 2024-07-10T09:54:03.938Z (2 months ago)
- Topics: astronomy, cinnamon, cinnamon-desktop, cinnamon-theme, desktop, desktop-background, linux, linux-mint, linuxmint, mint, moon, moon-phase, moonphase, nasa, open-source, space, theme, wallpaper, wallpaper-changer
- Language: Shell
- Homepage:
- Size: 9.91 MB
- Stars: 17
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# moon-phase-background
Change background picture to high resolution picture of the current moon phase from NASA
This bash script downloads a high resolution image of the current moon phase from NASAs Dial-A-Moon website https://svs.gsfc.nasa.gov/5187/, adds it onto a background image of stars, labels the image with the phase in percent and the age of the current moon cycle and sets it as a background image on Linux Mint Cinnamon.
best.tif is an example picture. (Resolution 5641x3650 by default, 8192x5641 is possible too.)
For automatic desktop background updates it is recommended to add the script to Startup applications or set a Cron Job.
The downloaded images are deleted again immediately, as not to pollute storage.
## Requirements:
In Linux Mint Cinnamon most likely pre-installed:
- bash
- curl
- ImageMagick
- Cinnamon (for other environments please see below under Configuration)
- 2024 (NASA Link changes every year. Script will be updated for 2025)
## Installation:
1. Download the repository and extract the files in some new folder, anywhere you want.
2. Navigate to your new folder in terminal
3. Make the script executable by entering
```chmod u+x moonback.sh```
You can then run the script using ```./moonback.sh```. Note that you need to be in the folder to run the script this way. To run it from anywhere add the path to ~/.bashrc file. Instructions for that are here: https://askubuntu.com/questions/153251/launch-shell-scripts-from-anywhere
It will download a 5MB image file and change your desktop background and then delete the downloaded image again (as not to pollute storage space). The file back.tif is your new background image now.
You can add this script moonback.sh to startup applications to automatically load the new moon phase background on startup.
To automatically update in certain time intervals you can set a cron job. Note that there is a new image available once per hour, so running this more often will not result in change.
## Configuration:
- **Resolution**:
- Default resolution: 5631x3640
- for 8192x5641: change `isbig=false` to `isbig=true`
- for lower resolutions more complex changes needed
- **Positioning**:
- size and position of moon and text field customizable by changing imagemagick commands
- **Background Image**:
- best_small.tif is the default background image for `isbig=false` (best.tif for `isbig=true`)
- can be replaced with different background image
- **System**:
- made for Linux Mint Cinnamon
- adjustable for other systems by editing line 40
- for gnome just replace the word cinnamon with gnome in line 40
## Uninstall
To uninstall simply delete the folder with all the files you downloaded. Don't forget to remove any Cronjobs, launchers or references (f.e. in bashrc or startup applications), you may have created.
## Image Credits:
The moon phase image is downloaded from NASA's Dial-A-Moon website: https://svs.gsfc.nasa.gov/5187/. Thank you to NASA's Scientific Visualization Studio for creating these high resolution visualizations of the moon and making them available to the public. For more information about how these images were created and on the moon itself, see the the link above.
## Example Image:
