asterizk / apod-grabber

Sets the Mac desktop to the current NASA astronomy photo of the day

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Example image created by apod-grabber

apod-grabber

Sets your Mac's desktop to the current NASA Astronomy Photo of the Day, including explanation text overlaid onto image.

Usage:

  • Manual
    • python3 apodgrab.py
  • Automated
    • See 'Installation' below

Requirements:

  • Homebrew ( see install instructions at https://brew.sh/ )
  • Python 3 ( brew install python3 )
  • BeautifulSoup ( pip3 install beautifulsoup4 )
  • Pillow ( pip3 install pillow )

Installation:

  1. cp dependencies/com.krishengreenwell.apod.plist ~/Library/LaunchAgents
  2. vi ~/Library/LaunchAgents/com.krishengreenwell.apod.plist
  3. Change line 8 to the absolute path of your apod-grabber GitHub checkout
  4. Change line 11 to the absolute path of your python3 installation (to find this, run which python3)
  5. launchctl load ~/Library/LaunchAgents/com.krishengreenwell.apod.plist
  6. launchctl start com.krishengreenwell.apod
  7. Grant the following two permissions ('Documents' may vary based on the location of your apod-grabber checkout):
    • documents folder permission request
    • finder permission request
  8. Go to System Preferences > Desktop and select Fit to Screen and black background color:
    • system preferences desktop preference pane

Notes:

  • Captioned APOD images can be found at ~/Pictures/apod/
  • Very much a work in progress! Please be patient/forgiving. If something doesn't look right, please browse the existing issues or file a new one

TODO:

  • Create a lighter region under textbox to make it more readable in event of a busy background
  • Get rid of apodosa.sh if possible
  • Decide install location in order to get rid of home directory dependency in dependencies/com.krishengreenwell.apod.plist
  • Create installer
  • Set picture on all attached monitors rather than just the one with the menubar

Feature ideas:

  • Option to turn off captions

Troubleshooting

  • If apod-grabber stops updating your desktop picture automatically, try re-running "pip3 install beautifulsoup4".

Credits

About

Sets the Mac desktop to the current NASA astronomy photo of the day

License:MIT License


Languages

Language:Python 100.0%