Metadata-Version: 2.4
Name: astrosky
Version: 0.3.0
Summary: CLI tool to see what's visible in the night sky tonight
Project-URL: Homepage, https://github.com/astrosteveo/astrosky
Project-URL: Repository, https://github.com/astrosteveo/astrosky
Project-URL: Issues, https://github.com/astrosteveo/astrosky/issues
Author-email: AstroSteveo <stevengmjr@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: astronomy,cli,night-sky,planets,stargazing
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Astronomy
Requires-Python: >=3.11
Requires-Dist: astronomy-engine>=2.1.0
Requires-Dist: click>=8.1.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: rich>=13.0.0
Requires-Dist: skyfield>=1.46
Provides-Extra: dev
Requires-Dist: pytest-mock>=3.12.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: time-machine>=2.13.0; extra == 'dev'
Description-Content-Type: text/markdown

# AstroSKY

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** - Complete Messier catalog (110 objects) with equipment recommendations and observing tips
- **Astronomical events** - Conjunctions, oppositions, moon phases, equinoxes, and solstices

## Installation

```bash
# With pip
pip install astrosky
astrosky tonight --lat 40.7128 --lon -74.0060

# Or run directly with uvx (no install needed)
uvx astrosky tonight --lat 40.7128 --lon -74.0060
```

## Quick Start

```bash
# 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.

```bash
# 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 events`

Show upcoming astronomical events.

```bash
# Next 7 days (default)
astrosky events --lat 40.7128 --lon -74.0060

# Next 30 days
astrosky events --lat 40.7128 --lon -74.0060 --days 30

# Filter by event type
astrosky events --lat 40.7128 --lon -74.0060 --type moon
astrosky events --lat 40.7128 --lon -74.0060 --type conjunction

# JSON output
astrosky events --lat 40.7128 --lon -74.0060 --json
```

**Event types:** `moon` (full/new moon), `conjunction`, `opposition`, `seasonal` (equinoxes/solstices)

### `astrosky location`

Manage saved observation locations.

```bash
# 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](https://www.n2yo.com/api/):

```bash
export N2YO_API_KEY=your-api-key
astrosky tonight
```

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

## License

MIT
