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 --timezone Europe/Warsaw  # local times (auto-detected on first run)
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.17

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.17
File Size Uploaded
spacecrew-1.2.17.tar.gz 68.0 kB Details

Built distribution (wheel)

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

Total release size: 136.6 kB

Release files / spacecrew-1.2.17.tar.gz

Download URL spacecrew-1.2.17.tar.gz
Size 68.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5cf7bbce1da2f0a437c74470ae95ea196bf209a4fa4403290962c607f17dc48f
BLAKE2b-256 checksum
How to use checksums
49501d353ad089eab26173cc49c43fa0189d4f4a0e4fc4744f41d01bcced05cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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.17-py3-none-any.whl

Download URL spacecrew-1.2.17-py3-none-any.whl
Size 68.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
38ebb8a7365b322134c7eec9b4a9598df8e382e421d169b3d2adf7c1a8f1a99f
BLAKE2b-256 checksum
How to use checksums
b2428aaf13fd1382685791f812e73d6ecc719db0147ffe917238e9058edce109
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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