GitXplorerGitXplorer
p

spacestills

public
14 stars
2 forks
0 issues

Commits

List of commits on branch master.
Verified
69146a578b51886bb608341946f9b087d0c06ce7

Replace Buy Me A Coffee with GitHub Sponsors

ppamoroso committed a year ago
Unverified
926cd2e7203d679d0291fa8a519c26be90622dea

Package for PyPI publication

ppamoroso committed 3 years ago
Unverified
eaca871d07d0cc449fb7f1cb9669f17f7ff672dc

Merge remote-tracking branch 'origin/master'

ppamoroso committed 3 years ago
Unverified
1f06b3f29968e19875805e164984d8d565b8a79f

Add PyPI installation instructions and release history

ppamoroso committed 3 years ago
Verified
74df98455c55a31ea191669a93ddecd7af76d63c

Create FUNDING.yml

ppamoroso committed 3 years ago
Unverified
2403ca4c62bc83b9d0d4798fe65e1ab19d3ef0f1

Add release and blog links, expand Replit run instructions

ppamoroso committed 4 years ago

README

The README file for this repository.

Spacestills

Spacestills is a Python program for viewing NASA TV still frames. It periodically downloads the frames from a web feed and displays them in a GUI.

Spacestills main window

The program allows to correct the aspect ratio of the frames and save them. It downloads the latest frame automatically and gives the option to reload manually, disable the automatic reload, or change the download frequency.

Spacestills has a GUI based on the PySimpleGUI framework and relies on the Pillow and Requests libraries. More implementation details are in a blog post that discusses the design of Spacestills.

Installation

Spacestills is available on PyPI, so to install the package execute the following shell command:

$ pip install spacestills

Usage

Running on Replit

To run the program online on Replit visit the Spacestills REPL with a browser and click Run. If the program window is cropped, try marking the checkbox Correct aspect ratio.

You can also adjust the size of the X Window desktop pane when running Spacestills directly in a REPL. You may see screen redraw artifacts when dragging the window on the desktop. To force a refresh and fix the issue, restart the window manager by right-clicking on the X desktop and then clicking Restart.

Running elsewhere

You can run Spacestills from the shell by executing the command:

$ spacestills

Commands and options

The program window displays the current NASA TV still frame and automatically reloads it every 45 seconds.

The images are stretched vertically in the raw web feed. Mark the Correct aspect ratio checkbox to squeeze the image and get an undistorted view.

To manually refresh the image click the Reload button. Change the reload frequency by entering an integer number of seconds (from 45 to 300) in the text field and pressing Set. You can disable auto-reload by unmarking the Auto-reload every (seconds): checkbox.

Click the Save button to save the current image to the local file system in PNG format, or Exit to quit the program.

Known issues

Typing a file name in the save dialog without first going through the file browse dialog doesn't add the default .png extension.

Release history

See the list of releases for notes on the changes in each version.

Author

Paolo Amoroso developed Spacestills as a Python learning exercise. Email: info@paoloamoroso.com

License

This code is distributed under the MIT license, see the LICENSE file.