Canonical source: the canonical features document for this domain is
deep-dive/features.md, rendered in the docs
center. This file is its operational companion (service topology, APIs,
schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
Nyx is a Cosmic Observatory Platform that combines interactive star
mapping, high-precision celestial calculations, VR planetarium experiences, AR
sky identification, telescope control, astrophotography tools, and educational
features into a complete astronomy ecosystem. This document describes every
user-facing feature from the perspective of stargazers, educators,
astrophotographers, and telescope operators.
Table of Contents#
- Platform Access
- Interactive Star Map
- Celestial Object Database
- Ephemeris and Position Calculations
- Astronomical Events
- Observation Planning
- Telescope Control
- Astrophotography
- VR Planetarium
- AR Sky Identification
- Educational Features
- Constellation Mythology
- Solar System Explorer
- Satellite Tracking
- Time Travel
- Social and Community
- Gamification
- Search and Discovery
- Audio and Narration
- Offline and Cross-Platform
- Data Catalogs and Sources
- Developer and API Access
- Lilith Integration
Nyx is available across multiple platforms, from web browsers to VR headsets.
Applications#
| Application |
Description |
| Star Map (Web) |
Interactive WebGL-powered star map in the browser |
| Mobile App |
iOS and Android app with AR sky identification and observation logging |
| VR Planetarium |
Immersive 360-degree VR planetarium for headsets |
| AR Sky (Mobile) |
Augmented reality sky overlay for real-time object identification |
| Desktop App |
Electron desktop application with telescope control integration |
| CLI Tools |
Command-line utilities for ephemeris calculation and chart generation |
| API Server |
REST and GraphQL API for programmatic access to all calculations |
| Data Pipelines |
Automated data ingestion and processing for celestial catalogs |
System Requirements#
| Platform |
Minimum |
Recommended |
| Web |
Chrome 90+, WebGL 2.0, 4GB RAM |
Chrome 110+, Dedicated GPU, 8GB RAM |
| Mobile |
iOS 15+ / Android 10+ |
iPhone 12+ / ARCore device |
| VR |
Quest 2 / SteamVR headset |
Quest 3 / Valve Index |
| Desktop |
Any modern OS |
Dedicated GPU |
Interactive Star Map#
The centerpiece of Nyx is a real-time, interactive map of the night sky.
Navigation#
| Feature |
Description |
| Pan and Zoom |
Drag to pan, scroll to zoom from full-sky down to sub-degree fields |
| Touch Navigation |
Pinch-to-zoom and single-finger pan on mobile and tablet |
| Gamepad Support |
Navigate using game controller with analog stick control |
| Center on Object |
Double-click any object to center and zoom to it |
| Coordinate Entry |
Jump to any RA/Dec or Alt/Az coordinates directly |
| Compass Heading |
Align the map with your real compass heading on mobile |
| Horizon Masking |
Hide objects below your local horizon for realistic sky view |
View Modes#
| Mode |
Description |
| 2D Flat View |
Traditional flat sky chart with selectable map projection |
| 3D Orbital View |
Interactive 3D view of the solar system with orbiting planets |
| Planetarium Mode |
Hemisphere dome projection simulating a planetarium experience |
| Telescope Eyepiece |
Simulated eyepiece view matching your telescope's field of view |
| Night Mode |
Red-tinted display to preserve dark adaptation during observing |
Map Projections#
| Projection |
Best For |
Field of View |
| Stereographic |
General viewing and wide-field navigation |
1 - 180 degrees |
| Gnomonic |
Telescope planning with minimal distortion |
1 - 120 degrees |
| Orthographic |
Hemisphere view and artistic rendering |
1 - 180 degrees |
| Mercator |
Equatorial belt navigation |
1 - 360 degrees |
| Hammer-Aitoff |
Full-sky survey and overview |
Full sky |
| Mollweide |
Area-accurate full-sky display |
Full sky |
Display Layers#
| Layer |
Description |
| Stars |
Stars displayed with accurate magnitude, color, and position |
| Constellation Lines |
Stick-figure constellation outlines connecting bright stars |
| Constellation Boundaries |
IAU constellation boundary lines |
| Constellation Art |
Classical constellation artwork overlaid on the sky |
| Deep Sky Objects |
Nebulae, galaxies, and clusters with appropriate symbols |
| Planets |
Solar system planets shown at their calculated positions |
| Moon |
Moon with phase illumination and surface detail |
| Sun |
Sun position with danger warnings for daytime viewing |
| Milky Way |
Milky Way band with adjustable opacity |
| Coordinate Grid |
RA/Dec or Alt/Az grid overlay for reference |
| Ecliptic Line |
The ecliptic plane where planets travel |
| Celestial Equator |
The projection of Earth's equator onto the sky |
| Horizon Line |
Local horizon with cardinal direction labels |
| Satellite Tracks |
Predicted paths of artificial satellites |
| Meteor Shower Radiants |
Radiant points for active meteor showers |
Object Interaction#
| Feature |
Description |
| Click for Details |
Click any object to see its name, magnitude, distance, and type |
| Info Panel |
Detailed information panel with physical properties and images |
| Wikipedia Links |
Direct links to Wikipedia articles for further reading |
| Object Photos |
Gallery of professional and community photos of each object |
| Rise/Set Times |
When the object rises, transits, and sets from your location |
| Visibility Rating |
How well you can see this object tonight from your location |
| GoTo Telescope |
Send the object's coordinates to your connected telescope |
| Add to Observation List |
Save objects to your personal observation wishlist |
Celestial Object Database#
Nyx provides access to comprehensive astronomical catalogs.
Star Catalogs#
| Catalog |
Stars |
Description |
| Yale Bright Star |
~9,100 |
All stars visible to the naked eye |
| Hipparcos |
~118,000 |
High-precision positions from ESA satellite |
| Tycho-2 |
~2.5 million |
Extended catalog with proper motions |
| Gaia DR3 |
~1.8 billion |
State-of-the-art positions from ESA Gaia mission |
Star Data#
| Data Field |
Description |
| Name |
Common name, Bayer designation, Flamsteed number |
| Position (RA/Dec) |
Right Ascension and Declination coordinates |
| Magnitude |
Visual and absolute brightness |
| Spectral Type |
Stellar classification (O, B, A, F, G, K, M) |
| Distance |
Distance in light-years and parsecs |
| Proper Motion |
Annual motion across the sky |
| Color Index (B-V) |
Color temperature indicator |
| Luminosity |
Intrinsic brightness relative to the Sun |
| Variable Star Data |
Period, amplitude, and type for variable stars |
Deep Sky Object Catalogs#
| Catalog |
Objects |
Description |
| Messier |
110 |
Charles Messier's famous catalog of bright DSOs |
| NGC |
~7,800 |
New General Catalogue of nebulae, clusters, galaxies |
| IC |
~5,400 |
Index Catalogue extensions to NGC |
| Caldwell |
109 |
Sir Patrick Caldwell-Moore's observing list |
Deep Sky Object Data#
| Data Field |
Description |
| Type |
Galaxy, nebula (emission, reflection, planetary), cluster (open, globular) |
| Apparent Size |
Angular size on the sky |
| Surface Brightness |
Brightness per unit area |
| Constellation |
Parent constellation |
| Distance |
Distance in light-years or megaparsecs |
| Morphology |
Galaxy type (spiral, elliptical, irregular) or nebula type |
| Best Viewing |
Optimal season and conditions for observation |
Planet and Moon Data#
| Feature |
Description |
| Solar System Planets |
Complete data for all 8 planets plus dwarf planets |
| Planetary Moons |
Data for major moons of each planet |
| Physical Properties |
Mass, radius, density, rotation period, orbital elements |
| Atmospheric Data |
Atmospheric composition and conditions where applicable |
| Exoplanet Catalog |
Database of confirmed exoplanets with habitable zone queries |
Asteroid and Comet Data#
| Feature |
Description |
| Near-Earth Asteroids |
Tracking of potentially hazardous near-Earth objects |
| Comet Catalog |
Known comets with orbital elements and visibility predictions |
| Discovery Information |
Who discovered the object, when, and where |
| Orbital Elements |
Full Keplerian elements for orbit calculation |
Ephemeris and Position Calculations#
High-precision astronomical calculations for any date, time, and location.
Position Calculation#
| Feature |
Description |
| Planetary Positions |
Calculate the position of any planet for any date and time |
| Lunar Position |
Moon position, phase, illumination, and libration |
| Star Positions |
Current star positions with proper motion and precession |
| DSO Positions |
Positions of deep sky objects corrected for precession |
Precision Levels#
| Level |
Accuracy |
Speed |
Use Case |
| Low |
~1 arcminute |
Fastest |
Real-time visualization, gaming |
| Medium |
~10 arcseconds |
Fast |
Observation planning, education |
| High |
~0.1 arcsecond |
Slower |
Telescope pointing, research |
Coordinate Systems#
| Transformation |
Description |
| Equatorial to Horizontal |
Convert RA/Dec to Altitude/Azimuth for your location |
| Horizontal to Equatorial |
Convert observed Alt/Az back to RA/Dec |
| Equatorial to Galactic |
Transform to galactic longitude and latitude |
| Equatorial to Ecliptic |
Transform to ecliptic longitude and latitude |
| Precession |
Precess coordinates between epochs (J2000 to date) |
| Aberration Correction |
Correct for the motion of the Earth |
| Atmospheric Refraction |
Correct for atmospheric bending of light |
Time Systems#
| Time System |
Description |
| UTC |
Coordinated Universal Time (civil time) |
| Julian Date |
Continuous day count from 4713 BCE for astronomical calculation |
| Modified Julian Date |
JD minus 2,400,000.5 for modern convenience |
| Sidereal Time |
Local and Greenwich sidereal time for RA calculations |
| Terrestrial Time |
Uniform time scale for ephemeris calculations |
| Barycentric Dynamic Time |
Solar system barycenter time for precise planetary work |
| Delta-T |
Difference between TT and UT1 for historical calculations |
| Besselian Year |
Tropical year epochs for stellar coordinate reference |
Astronomical Events#
Never miss a celestial event with comprehensive prediction and notification.
Eclipse Prediction#
| Feature |
Description |
| Solar Eclipses |
Predict total, partial, and annular solar eclipses |
| Lunar Eclipses |
Predict total, partial, and penumbral lunar eclipses |
| Eclipse Maps |
Visual maps showing eclipse paths and visibility zones |
| Local Circumstances |
Exact timing and magnitude from your observation location |
| Contact Times |
Precise times for first contact, maximum, and last contact |
| Historical Eclipses |
Look up past eclipses for any date in history |
Planetary Events#
| Feature |
Description |
| Conjunction Finder |
Find upcoming planetary conjunctions with separation angles |
| Opposition Dates |
When outer planets are closest and brightest |
| Transit Predictions |
Mercury and Venus transits across the Sun |
| Planetary Groupings |
When multiple planets cluster in the sky |
| Greatest Elongation |
Best viewing dates for Mercury and Venus |
Other Events#
| Feature |
Description |
| Meteor Shower Predictions |
Peak dates, ZHR, and best viewing times for meteor showers |
| Comet Appearances |
Upcoming bright comet visibility predictions |
| Lunar Phases |
Calendar of new moon, full moon, and quarter phases |
| Supermoons |
Identify upcoming supermoon events |
| Equinoxes and Solstices |
Exact times for seasonal markers |
| Event Calendar |
Unified calendar of all upcoming astronomical events |
| Event Notifications |
Push notifications before significant astronomical events |
Observation Planning#
Plan your observing sessions for maximum productivity and enjoyment.
Visibility Calculator#
| Feature |
Description |
| Object Visibility |
Calculate when an object is visible from your location |
| Rise/Transit/Set Times |
Precise times objects appear, peak, and disappear |
| Darkness Windows |
Astronomical, nautical, and civil twilight times |
| Moon Interference |
Assess how moonlight affects deep sky observing |
| Altitude Chart |
Graph showing object altitude throughout the night |
Session Planner#
| Feature |
Description |
| Observation List |
Create lists of objects to observe during a session |
| Optimal Ordering |
Automatically order targets by transit time and altitude |
| Session Timeline |
Visual timeline showing when each target is best placed |
| Equipment Matching |
Filter targets by what is visible with your telescope/binoculars |
| Difficulty Rating |
Rate objects by difficulty to observe (easy, moderate, challenging) |
Weather Integration#
| Feature |
Description |
| Cloud Cover Forecast |
Multi-day cloud cover predictions for your observing site |
| Seeing Forecast |
Atmospheric seeing conditions (turbulence) prediction |
| Transparency Forecast |
Atmospheric clarity forecast for deep sky observing |
| Humidity and Temperature |
Weather conditions relevant to equipment and comfort |
| Go/No-Go Indicator |
Simple recommendation on whether conditions are suitable |
Light Pollution#
| Feature |
Description |
| Light Pollution Map |
Global map showing Bortle scale light pollution levels |
| Dark Site Finder |
Find the nearest dark sky observing locations |
| Limiting Magnitude |
Estimated faintest star visible from your location |
| Bortle Scale Display |
Your location's Bortle class rating |
| Sky Quality Meter |
Estimated sky quality in magnitudes per square arcsecond |
Telescope Control#
Connect and control your telescope directly from Nyx.
Supported Protocols#
| Protocol |
Description |
| ASCOM |
ASCOM Alpaca protocol for Windows telescope drivers |
| INDI |
INDI protocol for Linux/Mac telescope and camera drivers |
Mount Control#
| Feature |
Description |
| GoTo Slewing |
Command the telescope to slew to any object or coordinates |
| Manual Nudging |
Fine adjustments to pointing via on-screen arrow buttons |
| Tracking Rates |
Set sidereal, lunar, solar, or custom tracking rates |
| Park/Unpark |
Safely park and unpark the telescope mount |
| Sync Coordinates |
Synchronize the mount's position model with a known star |
| Alignment Routines |
Multi-star alignment procedures for accurate pointing |
Autoguiding#
| Feature |
Description |
| Autoguider Interface |
Interface for autoguiding cameras and software |
| Guide Star Selection |
Automatic or manual guide star selection |
| Guide Corrections |
Real-time guide corrections displayed graphically |
Camera Control#
| Feature |
Description |
| Exposure Control |
Set exposure time, gain, and binning |
| Image Download |
Download captured images from the camera |
| Filter Wheel Control |
Control motorized filter wheels for multi-band imaging |
| Temperature Control |
Cooled camera temperature regulation |
Plate Solving#
| Feature |
Description |
| Astrometric Plate Solving |
Analyze a photo to determine exactly where the telescope is pointing |
| Sync After Solve |
Automatically sync the mount position after solving a plate |
| Blind Solving |
Solve images without any initial position hint |
| Real-Time Solving |
Continuous plate solving for precise centering |
Astrophotography#
Tools for planning and executing astrophotography sessions.
Imaging Workflow#
| Feature |
Description |
| Target Planning |
Plan imaging targets based on visibility and conditions |
| Exposure Calculator |
Calculate optimal exposure times for your equipment |
| Framing Preview |
Preview how a target will look in your camera's field of view |
| Mosaic Planner |
Plan multi-panel mosaics for wide-field imaging |
| Sequence Builder |
Build automated imaging sequences (lights, darks, flats, bias) |
Image Management#
| Feature |
Description |
| Image Library |
Organize captured images by target, date, and equipment |
| FITS Viewer |
View FITS astronomical image files with stretch controls |
| Metadata Extraction |
Read and display image metadata (exposure, coordinates, etc.) |
| Image Sharing |
Share your astrophotography with the Nyx community |
VR Planetarium#
Immerse yourself in the cosmos with a full virtual reality planetarium.
VR Features#
| Feature |
Description |
| 360-Degree Sky |
Full immersive sky surrounding you in every direction |
| Dome Projection Simulation |
Simulates the experience of a real planetarium dome |
| Spatial Audio |
3D positional sound for narration and ambient space sounds |
| Hand Tracking |
Point at objects to identify them with hand tracking (Quest) |
| Controller Navigation |
Navigate the sky with VR controller input |
| Scale Demonstration |
Experience the true scale of celestial objects in VR |
| Time Control in VR |
Speed up, slow down, or reverse time while immersed |
VR Experiences#
| Experience |
Duration |
Description |
| Tonight's Sky |
10 min |
Quick tour of what is visible tonight from your location |
| Solar System Flythrough |
20 min |
Fly past each planet and major moon |
| Galaxy Tour |
30 min |
Journey through the Milky Way and beyond |
| Deep Space Voyage |
45 min |
Visit famous nebulae and star-forming regions |
| Cosmic Scale Journey |
15 min |
Experience the scale from atoms to the observable universe |
Multiplayer VR#
| Feature |
Description |
| Shared Viewing |
Watch the sky together with friends in VR |
| Voice Chat in VR |
Talk to other observers while viewing the sky together |
| Guided Group Tours |
A guide leads a group through a narrated VR tour |
| Pointer System |
Point at objects and others see your laser pointer |
Supported VR Headsets#
| Device |
Support Level |
Notes |
| Meta Quest 3 |
Full |
Native app with hand tracking |
| Meta Quest 2 |
Full |
Native app |
| Meta Quest Pro |
Full |
Enhanced passthrough |
| Apple Vision Pro |
Full |
visionOS native |
| Valve Index |
Full |
Via SteamVR |
| HTC Vive Pro 2 |
Full |
Via SteamVR |
| Pico 4 |
Full |
Native app |
AR Sky Identification#
Point your device at the sky and instantly identify what you see.
AR Features#
| Feature |
Description |
| Live Sky Overlay |
Star names, constellation lines, and planet labels overlaid on the live camera view |
| Point and Identify |
Point your phone at any part of the sky to identify objects |
| Constellation Drawing |
See constellation lines drawn on the real sky through your camera |
| Planet Finder |
Locate planets even during daylight by pointing your device |
| Object Information Cards |
Tap identified objects for detailed information |
| AR Time Lapse |
Visualize how the sky changes over hours through AR overlay |
| Compass Calibration |
Automatic compass calibration for accurate positioning |
AR Supported Devices#
| Platform |
Requirements |
| iPhone |
iPhone 8+ (ARKit), LiDAR recommended for best results |
| iPad |
iPad Pro with LiDAR for premium AR experience |
| Android |
ARCore-compatible devices |
| Magic Leap 2 |
Enterprise AR with full spatial mapping |
| HoloLens 2 |
Experimental enterprise AR support |
Educational Features#
Nyx is a powerful educational platform for learning astronomy at every level.
Learning Modes#
| Mode |
Description |
| Beginner |
Simplified interface showing only bright stars, large labels, guided hints |
| Student |
Coordinate grids, scientific terminology, quiz mode, progress tracking |
| Expert |
Full access to all catalogs, technical data, and professional tools |
Guided Tours#
| Tour |
Duration |
Level |
Topics |
| First Look at the Sky |
15 min |
Beginner |
Basic navigation, bright stars |
| The Constellations |
30 min |
Beginner |
Major constellation identification |
| Seasonal Sky |
20 min |
Beginner |
What to see each season |
| Planets Tonight |
10 min |
Beginner |
Current planetary positions |
| The Moon |
25 min |
Beginner |
Lunar features, phases, craters |
| Deep Sky Introduction |
30 min |
Student |
Nebulae, galaxies, star clusters |
| Life of Stars |
45 min |
Student |
Stellar evolution from birth to death |
| The Milky Way |
30 min |
Student |
Structure and features of our galaxy |
| Exoplanets |
40 min |
Student |
Planets orbiting other stars |
| Cosmology |
60 min |
Advanced |
Universe structure, origin, and fate |
Interactive Lessons#
| Feature |
Description |
| Concept Explanations |
Interactive explanations of astronomical concepts |
| Visual Demonstrations |
Animated demonstrations of phenomena (eclipses, seasons, tides) |
| Quiz Mode |
Self-testing quizzes after lessons with instant feedback |
| Progress Tracking |
Track completed lessons and earned certifications |
| Difficulty Progression |
Lessons build from basic to advanced concepts gradually |
Constellation Mythology#
Explore the stories behind the stars across world cultures.
Mythology Features#
| Feature |
Description |
| Greek Mythology |
Classical Greek myths for all 88 modern constellations |
| Roman Mythology |
Roman equivalents and variations of constellation stories |
| Chinese Star Lore |
Chinese astronomical traditions and asterisms |
| Indigenous Sky Stories |
Stories from indigenous cultures around the world |
| Arabian Star Names |
Origins and meanings of traditional Arabic star names |
| Hindu Nakshatras |
Vedic lunar mansion system and associated mythology |
| Multi-Cultural Comparison |
Compare how different cultures see the same stars |
| Illustrated Stories |
Beautiful illustrated retellings of constellation myths |
| Audio Narration |
Professionally narrated mythology stories |
Solar System Explorer#
Explore our solar neighborhood in interactive 3D.
3D Solar System#
| Feature |
Description |
| Interactive Orrery |
3D model of the solar system with planets orbiting the Sun |
| Planet Close-Up |
Fly to any planet for a close-up view with surface detail |
| Moon Explorer |
Visit moons of each planet with detailed surface maps |
| Asteroid Belt |
Visualize the asteroid belt between Mars and Jupiter |
| Kuiper Belt |
Explore the distant Kuiper Belt and trans-Neptunian objects |
| Comet Orbits |
View the highly elliptical orbits of comets |
Scale Modes#
| Mode |
Description |
| Realistic |
True distances and sizes (planets appear as tiny dots) |
| Enhanced |
Enlarged planets with compressed distances for visibility |
| Schematic |
Diagrammatic view with labeled orbits for educational use |
| Feature |
Description |
| Physical Properties |
Mass, radius, density, gravity, rotation period |
| Orbital Data |
Semi-major axis, eccentricity, inclination, orbital period |
| Atmospheric Data |
Atmospheric composition, pressure, temperature |
| Surface Features |
Named craters, mountains, plains, and seas |
| Exploration History |
Timeline of space missions that visited each world |
Satellite Tracking#
Track artificial satellites including the ISS in real time.
Satellite Features#
| Feature |
Description |
| TLE Data Processing |
Two-Line Element set parsing for satellite orbit prediction |
| ISS Tracking |
Real-time position and pass predictions for the ISS |
| Iridium Flares |
Predict bright Iridium satellite flares for your location |
| Starlink Trains |
Track Starlink satellite trains after recent launches |
| Pass Predictions |
When and where to look for satellite passes from your location |
| Brightness Predictions |
Predicted visual magnitude for each pass |
| Satellite Map |
Live map showing satellite positions over the Earth |
Time Travel#
Experience the sky at any point in history or the future.
Time Control#
| Feature |
Description |
| Date/Time Picker |
Set any date and time to see the sky as it appeared then |
| Time Slider |
Drag a slider to scrub through time and watch the sky change |
| Speed Control |
Speed up or slow down time flow (1x, 10x, 100x, 1000x) |
| Play/Pause |
Play time forward or backward and pause at any moment |
| Preset Dates |
Quick jump to significant astronomical events in history |
| Historical Eclipses |
View solar and lunar eclipses as they appeared centuries ago |
| Precession Visualization |
Watch the slow precession of the equinoxes over millennia |
| Valid Range |
High accuracy from 1800 to 2200 CE; acceptable from 500 to 2500 CE |
Social and Community#
Share your love of astronomy with fellow stargazers.
| Feature |
Description |
| Observation Sharing |
Share observation logs with photos and notes |
| Community Photo Gallery |
Browse and contribute astrophotography to a shared gallery |
| User Profiles |
Astronomy profile showing observations, equipment, and badges |
| Comments and Discussions |
Comment on observations and images from other users |
| Observing Groups |
Join or create local observing groups |
| Star Parties |
Organize and find local star party events |
Equipment Management#
| Feature |
Description |
| Equipment Inventory |
Catalog your telescopes, eyepieces, cameras, and accessories |
| Equipment Reviews |
Read and write reviews of astronomy equipment |
| Field of View Calculator |
Calculate the field of view for your telescope/camera combination |
| Equipment Recommendations |
Get suggestions for equipment based on your observing goals |
Gamification#
Make learning and observing fun with achievements and challenges.
Achievements#
| Feature |
Description |
| Messier Marathon |
Track progress toward observing all 110 Messier objects |
| Caldwell Challenge |
Attempt to observe all 109 Caldwell objects |
| Planet Collector |
Observe all visible planets |
| Constellation Spotter |
Identify all 88 constellations |
| Eclipse Chaser |
Observe solar and lunar eclipses |
| Meteor Counter |
Log meteor shower observations |
| Dark Sky Explorer |
Visit and observe from dark sky sites |
| Milestone Badges |
Earn badges for 10, 50, 100, 500, and 1000 observations |
Observation Logging#
| Feature |
Description |
| Observation Log |
Record every observation with date, time, location, and notes |
| Sketch Mode |
Draw sketches of what you see through the eyepiece |
| Photo Attachment |
Attach photos to observation log entries |
| Conditions Recording |
Log seeing, transparency, Bortle class, and equipment used |
| Personal Statistics |
Track total observations, unique objects, and time under the stars |
Search and Discovery#
Find any object in the sky quickly and accurately.
Search Features#
| Feature |
Description |
| Name Search |
Search by common name (e.g., "Orion Nebula", "Vega") |
| Catalog Search |
Search by catalog ID (M42, NGC 7000, HIP 91262, etc.) |
| Coordinate Search |
Search by RA/Dec or Alt/Az coordinates |
| Filter by Type |
Filter results by type (star, galaxy, nebula, cluster, planet) |
| Filter by Magnitude |
Show only objects brighter than a chosen magnitude |
| Filter by Constellation |
Show objects within a specific constellation |
| Nearby Objects |
Find objects near a given position or another object |
| Habitable Zone Query |
Find exoplanets within the habitable zone of their stars |
| What's Up Tonight |
List all interesting objects visible tonight from your location |
Audio and Narration#
Enhance the experience with sound and spoken content.
Audio Features#
| Feature |
Description |
| Guided Tour Narration |
Professional voice narration for all guided tours |
| Ambient Soundscapes |
Space-themed ambient music for immersive viewing |
| Object Audio Descriptions |
Audio descriptions of celestial objects for accessibility |
| Multi-Language Narration |
Tours available in multiple languages |
Use Nyx anywhere, even without internet connectivity.
Offline Features#
| Feature |
Description |
| PWA Installation |
Install the web app for offline use |
| Offline Star Catalog |
Bright star catalog available offline |
| Offline Ephemeris |
Built-in ephemeris data for offline position calculations |
| Offline Constellations |
Constellation data and boundaries available offline |
| Sync When Online |
Observations and data sync when connectivity is restored |
| Feature |
Description |
| Account Sync |
Observation logs, favorites, and settings sync across devices |
| Equipment Library Sync |
Your equipment inventory available on all platforms |
| Observation List Sync |
Observation planning lists shared across devices |
Data Catalogs and Sources#
Nyx draws on authoritative astronomical data sources.
Data Provenance#
| Source |
Components Used |
| Jean Meeus (Astronomical Algorithms) |
Planetary positions, coordinate transforms, eclipses |
| VSOP87 |
Planetary orbital theory (Venus, Mars, Jupiter, etc.) |
| IAU Standards |
Constellation boundaries, obliquity, precession model |
| JPL DE440 |
High-precision planetary and lunar ephemeris (optional) |
| ESA Gaia DR3 |
State-of-the-art star positions and parallaxes |
| ESA Hipparcos |
High-precision star catalog |
| IERS Bulletins |
Earth orientation parameters and leap seconds |
Developer and API Access#
REST API#
| Endpoint |
Description |
GET /api/v1/ephemeris |
Calculate position of any celestial object |
GET /api/v1/stars |
Query star catalogs with filters |
GET /api/v1/constellations |
List all 88 constellations with boundaries |
GET /api/v1/events |
Upcoming astronomical events |
GET /api/v1/visibility |
Object visibility calculations for a location |
POST /api/v1/observation |
Log an observation record |
SDK and Client Libraries#
| Library |
Description |
@nyx/sdk |
Unified TypeScript SDK for all Nyx features |
@nyx/client |
HTTP client for the Nyx API |
@nyx/client-python |
Python client library for scientific and research use |
| Widget |
Description |
| Star Map Widget |
Embed an interactive star map in any website |
| Event Calendar |
Embed an upcoming events calendar |
| Sky Tonight |
Widget showing what is visible tonight |
| Moon Phase Widget |
Display current lunar phase |
Lilith Integration#
Nyx integrates with the Lilith consciousness platform for unique cross-domain
experiences.
Cross-Domain Features#
| Feature |
Description |
| Cosmic Meditation |
Meditation sessions set in realistic cosmic environments |
| Star-Guided Mindfulness |
Mindfulness exercises linked to celestial events |
| Astronomical Journaling |
Journal about observations with Lilith's journaling tools |
| Celestial Sound Healing |
Sound healing sessions synchronized with planetary positions |
| Moon Phase Meditation |
Meditation recommendations based on the current lunar phase |
Feature Summary#
| Category |
Feature Count |
Highlights |
| Star Map |
30+ |
Interactive WebGL, 6 projections, 15+ display layers |
| Celestial Database |
20+ |
Gaia DR3 (1.8B stars), Messier, NGC, exoplanets |
| Ephemeris |
15+ |
Multi-precision, 8 time systems, 7 coordinate transforms |
| Events |
15+ |
Eclipses, conjunctions, meteors, calendar, notifications |
| Observation Planning |
15+ |
Visibility, weather, light pollution, session planner |
| Telescope Control |
12+ |
ASCOM, INDI, GoTo, autoguiding, plate solving |
| Astrophotography |
9+ |
Exposure calc, framing, mosaics, FITS viewer |
| VR Planetarium |
12+ |
360-degree sky, multiplayer, 5+ guided experiences |
| AR Sky |
7+ |
Live overlay, point-and-identify, planet finder |
| Education |
15+ |
3 learning modes, 10 guided tours, quizzes |
| Mythology |
9+ |
Multi-cultural stories, illustrated, narrated |
| Solar System |
10+ |
3D orrery, planet close-ups, moon explorer |
| Satellite Tracking |
7+ |
TLE parsing, ISS, Starlink, pass predictions |
| Social |
10+ |
Observation sharing, groups, star parties |
| Gamification |
10+ |
Messier marathon, achievements, observation logging |
Nyx: Your window to the cosmos.