astrosky 0.1.2

CLI tool to see what's visible in the night sky tonight

SkyCLI

A command-line tool that shows you what's visible in the night sky tonight.

Features

• Moon phase - Current phase, illumination, and rise/set times
• Visible planets - Which planets are up and where to look
• ISS passes - Upcoming International Space Station flyovers for your location
• Meteor showers - Active showers and peak dates
• Deep sky objects - Visible Messier objects (galaxies, nebulae, clusters)

Installation

# With pip
pip install astrosky

# Then run
astrosky tonight --lat 40.7128 --lon -74.0060

Quick Start

# Check the sky for a specific location
astrosky tonight --lat 40.7128 --lon -74.0060

# Save a location for easy reuse
astrosky location add home 40.7128 -74.0060 --default

# Now just run
astrosky tonight

Commands

astrosky tonight

Show what's visible in the night sky.

# Using coordinates
astrosky tonight --lat 40.7128 --lon -74.0060

# Using a saved location
astrosky tonight -l home

# For a specific date
astrosky tonight --date 2025-01-15

# At a specific time
astrosky tonight --at 22:30

# Show only specific sections
astrosky tonight --only planets,moon

# Exclude sections
astrosky tonight --exclude iss,meteors

# JSON output
astrosky tonight --json

Sections: moon, planets, iss, meteors, events, deepsky

astrosky location

Manage saved observation locations.

# Add a location
astrosky location add home 40.7128 -74.0060

# Add and set as default
astrosky location add cabin 44.9778 -93.2650 --default

# List saved locations (* marks default)
astrosky location list

# Set default location
astrosky location set-default home

# Remove a location
astrosky location remove cabin

Locations are stored in ~/.config/astrosky/locations.json.

ISS Tracking

ISS pass predictions require a free API key from N2YO:

export N2YO_API_KEY=your-api-key
astrosky tonight

Without the API key, ISS passes will be skipped (other features work fine).

License

MIT