NASA's Astronomy Picture of the Day, rendered directly in your terminal.
- Auto-detected graphics: Kitty protocol, SIXEL, or block-character fallback
- Cross-platform: Windows, Linux, macOS
- Works with Windows Terminal, Ghostty, Kitty, WezTerm, Alacritty, and more
- Terminal greeter — show today's APOD when you open your shell
- Browse by date, view random APODs, read full explanations
- Search all APOD titles from APOD Archive
- Save HD images of APODs
- Works out of the box with DEMO_KEY
pip install astra-apod
astra # Today's APOD
astra today # Same as above
astra date 2021-08-14 # APOD for a specific date
astra random # Random APOD
astra search <title> # Search APOD archive by title
astra info # Full explanation of last viewed APOD
astra save # Save last viewed APOD
astra config --show # Show current configuration
astra config --api-key <key> # Set NASA API key
astra config --size full # Full terminal width image
astra config --size default # 60% terminal width image
astra config --bg "#0c0c0c" # Set background color manually
astra config --save-dir <path> # Set default save directory
astra config --clear-cache # Clear cached images
astra config --reset # Reset all settings to defaults
Auto-display today's APOD when you open your terminal:
astra config --greeter on --shell cmd # CMD (Windows)
astra config --greeter on --shell powershell # PowerShell (Windows)
astra config --greeter on --shell bash # Bash (Linux/macOS)
astra config --greeter on --shell zsh # Zsh (Linux/macOS)
astra config --greeter on --shell fish # Fish (Linux/macOS)
Control how often it runs:
astra config --greeter-freq daily # Once per day (default)
astra config --greeter-freq always # Every terminal open
Disable it:
astra config --greeter off --shell <shell>
Python · Typer · Rich · Pillow · NumPy
MIT © 2026 Asutosh Shrestha