SpaceOddity

"It mostly works" ™©®

Set the NASA Astronomy Picture of the Day as your wallpaper

Version 0.1.0

Table of Contents

• Requirements
• Downloading
• Installing
• Usage
• Uninstalling
• Documentation
• Developing
• Notes

Requirements

Python 3.10+

Downloading

There are two ways to get the code:

1. Download the latest release (the 'spaceoddity-\<version>.zip' file should work on all platforms).

2. Or you can clone the git repo to get the latest (and often broken) code from the main branch:

$ git clone https://github.com/cyclopticnerve/SpaceOddity

Installing

If you downloaded the zip file, extract it and go to the main directory:

$ cd ~/Downloads/spaceoddity-<version>

where \<version> is the version number of the file you downloaded.

If you cloned the repo, just go to the 'install' directory:

$ cd ~/Downloads/SpaceOddity/install

Either way, run the install script:

$ ./install.py

Usage

Read the full documentation.

Uninstalling

Just type the program name and use the '--uninstall' option:

$ spaceoddity --uninstall

Documentation

See the full documentation.

Developing

If you are developing this project, make sure you run the "develop.py" script first to create the proper virtual environment and install the requirements (if any).

Notes

DO NOT edit the crontab file by hand! If you do, SpaceOddity will overwrite your changes with the info from spaceoddity.json. To change the time interval, run

$ spaceoddity -e

or edit the file at '~/.local/share/spaceoddity/conf/spaceoddity.json' and run the program again:

$ spaceoddity

-)