Skip to main content

spacecrew

Spacecrew is a lightweight Python terminal program that shows who is in space right now.

92_1x_shots_so

Tested Systems

  • CachyOS
  • Ubuntu
  • Debian

Installation

Install from PyPI:

pip install spacecrew

Or install from source with pipx:

git clone https://github.com/jakub-ginal/spacecrew
cd spacecrew
pipx install .

Usage

Simply type spacecrew anywhere in your terminal. Follow the interactive menu:

  1. People in Space
  2. NASA APOD
  3. Upcoming Launches
  4. ISS Position
  5. Space Weather
  6. Satellite Passes
  7. Theme
  8. Dashboard

Start directly in a mode:

spacecrew --mode passes
spacecrew --mode apod --offline
spacecrew --mode iss --no-image
spacecrew --mode people --json
spacecrew --mode launches --json
spacecrew --mode passes --json

Time in Space

  • p (previous): Days from past missions.
  • c (current): Days from the current mission (tracked live).
356_1x_shots_so

Uninstall

To completely remove the program, run:

pip uninstall spacecrew

Configuration

~/.config/spacecrew/config.toml stores your NASA API key, theme, observer location, and favorites. Cache lives in ~/.config/spacecrew/cache.db.

export NASA_API_KEY="your-key-here"  # optional, DEMO_KEY is used otherwise
spacecrew --offline      # cached data only, no network
spacecrew --no-cache     # disable persistent cache for this run
spacecrew --clear-cache  # clear expired cache entries
spacecrew --no-image     # skip photo rendering
spacecrew --json --mode people  # JSON output (passes|people|launches)
spacecrew --config /tmp/spacecrew-test  # isolated config/cache dir for testing
SPACE_CREW_CONFIG_DIR=/tmp/spacecrew-test spacecrew  # same via env
spacecrew --generate-completion bash  # bash|zsh|fish
man spacecrew            # manual page

Data Source

Data provided by International Space Station APIs by Cormac Quaid

Metadata

Release files for spacecrew 1.2.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spacecrew 1.2.16
File Size Uploaded
spacecrew-1.2.16.tar.gz 65.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for spacecrew 1.2.16
File Interpreter ABI Platform
spacecrew-1.2.16-py3-none-any.whl Python 3 none any Details

Total release size: 132.3 kB

Release files / spacecrew-1.2.16.tar.gz

Download URL spacecrew-1.2.16.tar.gz
Size 65.8 kB
Tags Source
SHA-256 checksum
How to use checksums
538ab47d1bd5df5d5d2d496df7c75f76069a9cd1c45d28fef99c0247ff705fde
BLAKE2b-256 checksum
How to use checksums
37a4a4cbee75639f11980734b3f7c6b38bae9af9fc645fa0db82b6bbfff3cc09
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / spacecrew-1.2.16-py3-none-any.whl

Download URL spacecrew-1.2.16-py3-none-any.whl
Size 66.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
075d1f6355b6750068f275b4d60c3d286eb59ff1fd667a0371aa0047f96e308c
BLAKE2b-256 checksum
How to use checksums
3c7821c68b4eab40990ef600cf6816f2fa9d6776dcf5f83447b1928e6e4f462d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page