Metadata-Version: 2.4
Name: zstarview
Version: 0.24.1
Summary: Transparent desktop sky viewer with stars, planets, eclipses, and optional real-time satellite cloud overlay.
Project-URL: Homepage, https://github.com/tos-kamiya/zstarview
Project-URL: Documentation, https://github.com/tos-kamiya/zstarview#readme
Project-URL: Issues, https://github.com/tos-kamiya/zstarview/issues
Project-URL: Source, https://github.com/tos-kamiya/zstarview
Author-email: Toshihiro Kamiya <kamiya@mbj.nifty.com>
License-Expression: MIT
License-File: LICENSE.txt
Keywords: astronomy,clouds,desktop,planetarium,pyside6,satellite,sky
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Astronomy
Requires-Python: >=3.10
Requires-Dist: appdirs>=1.4.4
Requires-Dist: astropy<7,>=6.1
Requires-Dist: boto3<2,>=1.42
Requires-Dist: botocore<2,>=1.42
Requires-Dist: h5netcdf<2,>=1.8
Requires-Dist: h5py<4,>=3.15
Requires-Dist: numpy<2.4,>=2.2
Requires-Dist: pillow<13,>=12
Requires-Dist: polars<2,>=1.38
Requires-Dist: pyproj<4,>=3.7
Requires-Dist: pyside6<7,>=6.10
Requires-Dist: rasterio>=1.4.4
Requires-Dist: satpy<0.60,>=0.59
Requires-Dist: skyfield<2,>=1.54
Requires-Dist: xarray<2026.0,>=2025.6
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pyongc; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Description-Content-Type: text/markdown

# zstarview

Transparent desktop sky viewer with stars, planets, eclipses, and optional real-time satellite cloud overlay.

<img src="https://raw.githubusercontent.com/tos-kamiya/zstarview/main/docs/images/screenshot1.png" width="640" alt="zstarview screenshot">

## Install

Recommended:

```bash
pipx install zstarview
```

Or with pip:

```bash
pip install zstarview
```

## Quick Start

```bash
zstarview [options] [city]
```

Examples:

```bash
zstarview Tokyo
zstarview "35.68;139.76"
zstarview -Z E -A 25 Tokyo
```

## Highlights

- Real-time rendering of bright stars, planets, celestial equator, and ecliptic.
- Optional deep-sky object (DSO) overlays.
- Optional asterism overlays (line patterns, not IAU constellation boundaries).
- Real-time cloud overlays from Himawari/GOES (can be disabled with `-c 0`).
- Hover interactions for object labels and contextual overlays.

## Useful Options

- `-V`, `--vmag-limit`: star magnitude limit.
- `--datetime "YYYY-MM-DD HH[:MM[:SS]] [TZ]"`: absolute sky time.
- `--show-dso-initial true|false`: DSO visibility at startup.
- `--show-asterisms-initial true|false`: asterism visibility at startup.
- `-c`, `--cloud-opacity`: cloud overlay opacity (`0` disables clouds).

## Notes

- On first launch, ephemeris data may be downloaded once and cached.
- If cloud fetching is slow or unavailable, use `-c 0` for offline-friendly star/planet viewing.

## Links

- Homepage: https://github.com/tos-kamiya/zstarview
- Documentation: https://github.com/tos-kamiya/zstarview#readme
- Issues: https://github.com/tos-kamiya/zstarview/issues
