Skip to content
This repository has been archived by the owner on Feb 21, 2021. It is now read-only.

powellcj12/nasa-apod-desktop

 
 

Repository files navigation

nasa-apod-desktop

Python Script to Download the NASA APOD and Set it as Your Background

About:

The popular NASA Astronomy Picture of the Day produces wonderful images that make for a great desktop background. This script will download the NASA APOD and set it as your background.

NASA APOD Example

http://en.wikipedia.org/wiki/Astronomy_Picture_of_the_Day
http://apod.nasa.gov/apod/astropix.html

Originally created for Ubuntu 12.04 by David Drake
Adapted for Mac OS X by Simon Walker
Updated and maintained for Mac OS X by Charlie Powell

Tested on:

  • Mac OS X 10.6.8
  • Mac OS X 10.8.2

Instructions:

  1. Open a terminal
  2. Type the following in a terminal: git clone http://www.github.com/powellcj12/nasa-apod-desktop.git; sudo sh nasa-apod-desktop/configure;
  3. Enter your password when prompted
  4. Tell the program whether or not you want this to run on its own so your background will change automatically
  5. If all goes well, your background should be changed and you can remove the directory this was downloaded to! rm -rf nasa-apod-desktop

How it Works:

  1. Grabs your current download path
  2. Downloads the latest image of the day from NASA (http://apod.nasa.gov/apod/)
  3. Determines your desktop resolution, or uses the set default
  4. Resizes the image to the given resolution
  5. Sets the image as your desktop
  6. Adds image to XML file used to scroll through desktop background images.

It's not very exciting to scroll through a single image, so it will attempt to download additional images (default: 10) to seed your list of images.

Development:

I really enjoyed the NASA background images that were easily available in Windows 7. I wanted to recreate the experience for Ubuntu as I don't use Windows 7 at home, much.

Searching around in Google, I came across the apodbackground project. Unfortunately, the git link was broken. I eventually found a mirror and took a look at the code. There were a few changes that I thought were necessary:

  • Removal of the description text. I just wanted an image, no text as I live in a semi-transparent terminal most of the time.
  • Instead of appropriately scaling the image based on the size and placing it on a black background, I wanted the image to be scaled to the size I specified no matter what so I didn't have distracting vertical lines.
  • Cleaned up the code and the comments.
  • Added debugging information to see what's going on.
  • Checked to see if the file already existed before performing the download.
  • Saving as a PNG instead of a JPG. Yes, the filesize is increased quite a bit but we remove the artifacts and get a much cleaner image.

After I modified the original script, I still wanted to allow for the image scrolling to return. I found the XML file that comes with Ubuntu in /usr/share/backgrounds/contest/precise.xml that is used to create the background scrolling. From there, I got a hold of lxml and went to town.

But, generating the XML file wasn't enough. I also wanted to start with a number of images so I would actually have some to scroll through.

While searching around for the original source, I found out that the project I grabbed from was originally based on a different script, which I think is worth mentioning.

Please note: I am not extremely well-versed in Python. I have been playing with the language and Django lately so, if improvements could be made, please let me know.

Defaults:

While the script will detect as much as possible and has safe defaults, you may want to set your own.

  • DOWNLOAD_PATH - where you want the file to be downloaded. Will be auto-detected if not set.
  • CUSTOM_FOLDER - if we detect your download folder, this will be the target folder in there.
  • RESOUTION_TYPE -
    'stretch': single monitor or the combined resolution of your available monitors
    'largest': largest resolution of your available monitors
    'default': use the default resolution that is set
  • RESOLUTION_X - horizontal resolution if RESOLUTION_TYPE is not default or cannot be automatically determined
  • RESOLUTION_Y - vertical resolution if RESOLUTION_TYPE is not default or cannot be automatically determined
  • NASA_APOD_SITE - location of the current picture of the day
  • IMAGE_SCROLL - if true, will write also write an XML file to make the images scroll
  • IMAGE_DURATION - if IMAGE_SCROLL is enabled, this is the duration each will stay in seconds
  • SEED_IMAGES - if > 0, it will download previous images as well to seed the list of images
  • SHOW_DEBUG - whether to print useful debugging information or statuses

License:

Open-source and free for use.

Copyright (c) 2012 David Drake

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Original Author:

David Drake

@randomdrake | http://randomdrake.com | LinkedIn

About

Automatically downloads and sets the NASA picture of the day (APOD) as your desktop in Mac OS X

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%