{"id":47061082,"url":"https://github.com/maxb2/stellui","last_synced_at":"2026-04-01T18:14:57.873Z","repository":{"id":343638976,"uuid":"1178290592","full_name":"maxb2/stellui","owner":"maxb2","description":"A terminal planetarium — view the night sky and weather forecast from your command line.","archived":false,"fork":false,"pushed_at":"2026-03-15T04:48:44.000Z","size":431,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-16T07:53:38.106Z","etag":null,"topics":["astronomy","night-sky","planets","stars","telescope","weather"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maxb2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-10T22:10:05.000Z","updated_at":"2026-03-15T04:48:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/maxb2/stellui","commit_stats":null,"previous_names":["maxb2/stellui"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/maxb2/stellui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxb2%2Fstellui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxb2%2Fstellui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxb2%2Fstellui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxb2%2Fstellui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxb2","download_url":"https://codeload.github.com/maxb2/stellui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxb2%2Fstellui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astronomy","night-sky","planets","stars","telescope","weather"],"created_at":"2026-03-12T04:03:30.020Z","updated_at":"2026-04-01T18:14:57.843Z","avatar_url":"https://github.com/maxb2.png","language":"Rust","readme":"# stellui\n\nA terminal planetarium — view the night sky and weather forecast from your command line.\n\n![stellui solar system screenshot](solar_system.png)\n\n## Features\n\n- **Sky map** — stereographic projection of the visible sky with 9,000+ stars from the J2000 catalog\n- **Sun \u0026 Moon** — real-time positions and moon phase\n- **Solar system orrery** — animated top-down view of the planets\n- **Almanac** — 24-hour radial altitude plot for the Sun and Moon\n- **Weather forecast** — hourly seeing quality via [Open-Meteo](https://open-meteo.com/) with sparklines\n- **Live mode** — auto-updates at ~60fps\n- **Time travel** — simulate time at variable speeds (1x → 1 day/s) forward or backward\n- **Local time** — timezone auto-detected from observer coordinates\n- **Southern hemisphere** support\n\n## Installation\n\n```sh\ncargo install --path .\n```\n\nOr run directly:\n\n```sh\ncargo run -- --lat 40.71 --lon -74.01\n```\n\n## Usage\n\n```\nstellui [--lat \u003cdegrees\u003e] [--lon \u003cdegrees\u003e] [--height \u003cmeters\u003e]\n```\n\nDefaults to New York City (40.71°N, 74.01°W).\n\n## Configuration\n\nSettings are saved automatically on quit and loaded on startup from:\n\n| Platform | Path |\n|----------|------|\n| Linux / macOS | `~/.config/stellui/config.toml` |\n| Windows | `%APPDATA%\\stellui\\config.toml` |\n\nCLI flags (`--lat`, `--lon`, `--height`) override the config file for that session.\n\nExample config (see `config.example.toml`):\n\n```toml\nlat = 40.71\nlon = -74.01\nheight = 0.0\n# timezone = \"America/New_York\"  # auto-detected from lat/lon if omitted\n# max_mag = 5.5  # Faintest magnitude to display (0 = brightest, 8 = very faint)\n```\n\n## Keybindings\n\n| Key | Action |\n|-----|--------|\n| `s` | Sky tab |\n| `w` | Weather tab |\n| `p` | Solar System orrery tab |\n| `a` | Almanac tab |\n| `n` | Jump to now (live mode) |\n| `Space` | Pause / resume simulation |\n| `,` / `.` | Decrease / increase simulation speed |\n| `l` | Edit latitude |\n| `o` | Edit longitude |\n| `t` | Edit date/time (`YYYY-MM-DD HH:MM` local time) |\n| `z` | Edit timezone |\n| `+` / `=` | Show fainter stars (increase magnitude limit) |\n| `-` | Show fewer stars (decrease magnitude limit) |\n| `r` | Refresh weather |\n| `↑` / `↓` | Scroll weather forecast |\n| `Enter` | Confirm input |\n| `Esc` | Cancel input |\n| `q` / `Ctrl+C` | Quit |\n\n## Sky Map Orientation\n\nThe sky map uses a stereographic projection centered on the zenith:\n- **South at top**, North at bottom\n- **East at left**, West at right\n- Stars beyond the horizon (altitude \u003c 0°) are hidden\n\n## Dependencies\n\n- [astronomy-engine-bindings](https://crates.io/crates/astronomy-engine-bindings) — planetary positions\n- [ratatui](https://ratatui.rs/) — TUI framework\n- [Open-Meteo API](https://open-meteo.com/) — weather data (no API key required)\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxb2%2Fstellui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxb2%2Fstellui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxb2%2Fstellui/lists"}