Sky Compass — Point Your Phone at the Heavens
The Sky Compass is one of KarmaWheel's most experiential features. Stand outside, hold your phone flat, point it in any direction — and the app shows you exactly which planets are in that part of the sky right now. As you rotate the phone, the compass rose rotates with it. Point south? South goes to the top. Point west? The rose follows. Each planet appears as a colored disc with its glyph and name, plotted at its real altitude (height above your horizon) and azimuth (compass direction).
This isn't a chart wheel. It's not a transit table. It's the living sky, observable through your phone, with every planet named and located.
Most astrologers never look up. They read about Saturn in Pisces from a book; they don't see Saturn. The Sky Compass changes that. And the change goes deeper than you'd expect. This article is mostly about why you'd use this — seven distinct ways the Sky Compass earns its place in a serious practitioner's toolkit.
Why use the Sky Compass — seven use cases
1. Naked-eye planet identification
You're outside at dusk and you notice a bright "star" in the southwest. You point your phone — the Sky Compass shows you that's Jupiter.
After a few sessions of doing this, something shifts: you start recognizing planets without checking. The bright "star" you see at dawn isn't Sirius — it's Venus, the morning star. The reddish dot to the south isn't a regular star — it's Mars. The slow, steady, dim point of light is Saturn.
This is a skill no chart wheel can teach. No matter how many years you've been computing charts, if you've never seen the planets, you don't really know them yet. An hour with the Sky Compass each week, over a season, builds an instinct that no software training can replace. You become someone who notices when Venus is the evening star vs. the morning star. You feel the rhythm of Mars' two-year synodic cycle in your bones because you've watched it move across the sky.
Classical astrologers all had this skill. It's been lost in the chart-wheel-on-a-screen era. KarmaWheel's Sky Compass quietly restores it.
2. Timing direct planetary observances
Many classical Vedic practices ask you to observe the actual planet, not just compute its abstract position:
- Surya Namaskar facing the rising Sun — Sky Compass confirms when the Sun is genuinely above your eastern horizon. Sunrise varies with season, latitude, and local terrain. In the depths of winter at higher latitudes, "sunrise" could be at 8:30am from the official ephemeris but blocked by your local hills until 9:15. The compass tells you when the Sun is actually visible from where you stand.
- Chandra darshan under a visible Moon — many Hindu observances explicitly ask the practitioner to see the Moon before performing the rite. Sky Compass tells you whether the Moon is above or below the horizon right now and which direction it's in. No more "I think it should be up but I can't see it through the clouds" — the compass tells you definitively.
- Aditya Hridayam recitation with the Sun visible — the classical instruction is to recite while looking toward the Sun (with eyes closed). Sky Compass confirms the Sun's compass direction so you face it correctly even when it's hidden behind buildings.
- Star and nakshatra observances — pointing toward the right region of sky for a specific nakshatra meditation. Hand the phone to a friend, ask them to face the rose toward "where the Moon is" — the compass tells them precisely.
- Tarpana / pitr offerings — many traditional offerings are oriented to specific compass directions (south for ancestors). Sky Compass gives you a precise compass direction without a separate compass app.
- Sandhya kala practices — twilight is a transition window the Sky Compass marks visually as the Sun crosses the horizon.
3. Real-time transit grounding — making the abstract visceral
Your chart says "Saturn is currently transiting your natal Moon in Pisces." Read on a screen, that's a sentence with concepts in it: Saturn, transit, natal, Moon, Pisces.
Now hold your phone up at night and notice: Saturn is right there, 30° above the southwest horizon, dimly glowing, slowly moving westward as the night progresses. Pisces is the band of sky around it. Your natal Moon's position is the same point of sky Saturn is now crossing.
Something changes when the transit becomes physically locatable. Practitioners who've used the Sky Compass for a few weeks report that:
- Their relationship to current dashas deepens — the Mahadasha lord is no longer just "Saturn" but that point of light over there.
- Visualization meditation becomes easier — try meditating on Jupiter's energy after you've actually seen Jupiter shining gold-bright in the night sky.
- Mantra practice gets a new dimension — recite Om Brihaspataye Namah while seeing Jupiter through your window. The mantra hits differently when its planetary referent is visible.
- Daily transits stop feeling abstract. When the Moon transits a sensitive point in your chart, you can step outside and see exactly where she is in the sky.
This is what classical practitioners had built-in. They didn't need to be told that the planets affect us — they saw the planets every clear night and felt them. The Sky Compass restores that channel.
4. Choosing direction for ritual, mantra, and meditation
Many traditions ask the practitioner to face a specific direction during practice:
- East at sunrise for Surya practices — easy.
- Toward your ishta-devata's planet for some advanced sadhanas — harder, because the planet's compass direction changes by the hour.
- Toward the Moon for Soma practices, especially during specific tithis.
- Away from a malefic that's currently angular for purifications.
Sky Compass tells you which compass direction to face right now for any of these. Open the app, find the planet you're working with, note its azimuth — that's your direction. Sit, orient your shrine, set up your seat.
For more advanced practitioners, this opens the door to directional sadhana: choosing the direction of practice based on which planets are angular, which are above the horizon, which are setting. A practice oriented toward a rising Sun has different energetics than one oriented toward a setting one — and you can know which without leaving your living room.
5. Eclipse and conjunction watching
When two planets are within a few degrees in the sky, they appear as a single super-bright "star" to the naked eye. This happens many times a year. When it's Jupiter and Saturn (the famous Great Conjunction of December 2020), it's a once-in-a-generation visual. When it's Venus and Jupiter, it's spectacular.
The Sky Compass tells you: - When the conjunction is closest at your location. - Where to look on the compass. - Whether it's above or below the horizon at viewing time — eclipses and conjunctions only matter visually if you can see them.
For eclipses specifically, the compass shows you when the Sun and Moon are at the same point near a node — the geometry of the eclipse is suddenly visible. You can confirm an eclipse is in progress at your location, or determine that the eclipse is happening on the other side of the planet and you won't see it directly (though the chart still applies).
This single use case takes the Sky Compass from "interesting toy" to "essential tool" for anyone who pays attention to eclipse cycles. Eclipses are some of the most powerful chart events in Vedic astrology — being able to see one happening, while reading what it means, is unforgettable.
6. Astronomy literacy — closing the loop between chart and sky
Most astrologers never connect the chart wheel to the actual sky. They know "Saturn is in Pisces" without knowing what direction Pisces is in tonight, or whether Pisces is even visible from their hemisphere right now. The Sky Compass closes that gap.
When you can: - Look at a chart and instantly know where in the sky those planets are right now. - Step outside and identify which planet you're seeing. - Watch Mercury rise just before the Sun and recognize its retrograde shadow period. - See Saturn move from sign to sign over years through your own observation.
…you've stopped being someone who uses astrology software and become someone who reads the heavens. This is the literacy classical Vedic astrologers had as their baseline. The Sky Compass restores it efficiently — a few months of casual use, and your astrological intuition is dramatically richer.
7. The wonder factor
Sit outside on a clear night. Hold your phone over your head. Watch the planet discs glow on the rose as you tilt the phone in different directions. Notice that what you read about in books — Mars activates the 7th house through its red, fiery, courageous nature — corresponds to that bright reddish point of light over there.
For most people the first reaction is:
"Oh. These things I've been studying are right there above me."
That's not nothing. Astrology is, in its origins, an awe practice. The reverence of ancient astronomers wasn't intellectual — it was visual. They looked up, every clear night, for years, and what they saw shaped their cosmology.
Modern astrology has been screen-bound. The Sky Compass plugs your practice back into the source. Even if you never use any of the other six points above, the experience of seeing the planets you've been computing — with names and labels — is itself worth the feature.
How the Sky Compass works
The compass shows planets at two coordinates:
- Azimuth = compass direction (0° = North, 90° = East, 180° = South, 270° = West). Determines where on the rose the planet appears.
- Altitude = angular height above the horizon. Determines how far from the rose's center the planet appears. At altitude 90° (zenith, directly overhead), the planet sits at the center. At altitude 0° (horizon), it sits at the outer ring. Below the horizon (negative altitude), it sits just outside the ring, dimmed.
Each planet appears as a colored disc with its glyph centered, and a small text label below showing the planet abbreviation and current sign (e.g. "Su · Ari"). The discs are sized large enough to be easily visible on a phone screen.
The colors are KarmaWheel's standard planetary palette:
| Planet | Color | Glyph |
|---|---|---|
| Sun | Gold | ☉ |
| Moon | Silver | ☽ |
| Mars | Red | ♂ |
| Mercury | Green | ☿ |
| Jupiter | Yellow-gold | ♃ |
| Venus | Pink | ♀ |
| Saturn | Steel blue | ♄ |
| Rahu | Purple | ☊ |
| Ketu | Brown | ☋ |
Setting it up — two permissions
The Sky Compass needs two grants from your device:
1. Location
Tap "📍 Use my location". The browser will ask permission. Once granted, KarmaWheel calls /api/sky_state with your latitude and longitude, and computes each planet's altitude/azimuth from your location.
You only need to do this once per session.
2. Phone heading (mobile only)
Tap "📱 Enable phone heading".
- iOS Safari: A permission dialog appears asking for motion sensor access. Tap "Allow". This is iOS 13+'s required gesture.
- Android Chrome: Heading typically activates automatically.
- Desktop: No heading sensor exists — the rose stays fixed with North up. Still useful, but you have to mentally rotate.
Once enabled, the compass rose rotates as you turn the phone. The yellow arrow at the top of the rose points "in the direction the top of your phone is facing."
Reading the table
Below the rose is a table of every planet's current position:
| Planet | Sign | Direction | Altitude |
|---|---|---|---|
| Sun ☉ | Aries | 270° W | ↑ 12° above horizon |
| Moon ☽ | Cancer | 95° E | ↑ 47° above horizon |
| Mars ♂ | Leo | 145° SE | ↓ 22° below horizon |
| ... | ... | ... | ... |
The table shows the same data as the rose, in plain numerical form. Use it when you want exact altitudes, or when the rose has multiple planets clustered.
Tips for accuracy
- Hold phone flat — heading sensors assume the phone is roughly level with the ground. Tilting vertically confuses the magnetometer.
- Move away from large metal — cars, magnets, steel-frame buildings can throw off the heading by 20–30°. Step into the open if your compass seems wrong.
- Use outdoors when possible — both for accuracy and so you can look up and visually confirm. The compass and the actual sky should match.
- Calibrate by figure-8 motion — if the heading seems stuck or wrong, wave the phone in a figure-8 pattern in 3D space for a few seconds. This re-calibrates the magnetometer on most phones.
- Refresh the position table after long pauses — sky data refreshes every 60 seconds automatically; tap "↻ Refresh now" if you want it sooner.
Coordinate systems quick reference
The chart wheel uses ecliptic longitude (zodiac sign + degrees). The Sky Compass uses horizontal coordinates (your local horizon). These are two different projections of the same sky:
| System | Origin | What it measures | Used in |
|---|---|---|---|
| Ecliptic longitude | The vernal equinox (sidereal: spica's correction) | Position along the zodiac | Chart wheel, dasha, transits |
| Equatorial (RA/Dec) | The vernal equinox | Position relative to Earth's equator | Astrocartography lines |
| Horizontal (Az/Alt) | Your local horizon | Where in your local sky | Sky Compass |
Each is a complete description. They're convertible to each other given your location and the moment. For Vedic chart purposes, you compute in ecliptic; the Sky Compass converts to horizontal so you can look up.
Browser compatibility
| Browser | Geolocation | Heading | Notes |
|---|---|---|---|
| iOS Safari (PWA) | ✓ | ✓ (with permission) | Best mobile experience |
| iOS Safari (tab) | ✓ | ✓ (with permission) | Works fully |
| Android Chrome | ✓ | ✓ | Auto-granted heading |
| Android Firefox | ✓ | partial | Some devices need Chrome |
| Desktop Chrome | ✓ | ✗ | No heading sensor |
| Desktop Safari | ✓ | ✗ | No heading sensor |
| Desktop Firefox | ✓ | ✗ | No heading sensor |
On desktop, the rose is still useful — you just have to mentally rotate (the rose stays with North up).
Refresh rate
Planet positions auto-refresh every 60 seconds. Within that window, the heading (compass rotation) updates in real time as you rotate the phone.
For most planets — Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn — the position barely changes in 60 seconds. The Moon moves the fastest (~13° per day, ~0.5° per hour). So a 1-minute refresh is more than fast enough.
Tap "↻ Refresh now" anytime for an immediate update.
What's NOT in the Sky Compass yet
Planned for future versions:
- Background stars and constellations — currently only the 9 planets appear; the underlying star pattern would help orient.
- Milky Way band outline.
- Sun and Moon visual size to scale (currently all planets are the same disc size).
- Eclipse markers when an eclipse is in progress.
- AR camera mode — overlay planet labels onto your phone's live camera feed of the sky. This is the obvious "Star Walk for Vedic astrologers" extension and it's on the roadmap.
- Bookmark a moment — save the current sky state to revisit later.
Practical workflows
Morning practice
- Wake before sunrise.
- Open Sky Compass. Tap "Use my location."
- Find the Sun's altitude — if negative, sunrise hasn't happened yet.
- As the Sun rises (altitude crosses 0°), face east — the compass tells you exact azimuth.
- Begin Surya Namaskar / Aditya Hridayam / morning sandhya kala.
Evening sky scan
- Step outside at twilight.
- Open Sky Compass.
- Identify which planets are above the horizon — these are the ones you can see tonight.
- Pick the brightest visible planet, point your phone at it, confirm the compass identifies it correctly.
- Spend a few minutes simply looking at it — letting the chart and the visible point of light merge in your awareness.
Eclipse check
- The chart says "lunar eclipse in 3 hours."
- Open Sky Compass.
- Find the Moon — is it above the horizon at eclipse maximum?
- If yes: plan to be outside. Check direction. Bring a friend.
- If no: the eclipse is happening on the other side of the planet for you — the chart still applies but you won't see it.
Ritual orientation
- Decide which planet to face for today's practice.
- Open Sky Compass.
- Read the planet's azimuth.
- Orient your seat / shrine / direction of practice toward that compass bearing.
- Periodically check — for fast-moving planets like the Moon, the direction shifts noticeably during a long sit.
In KarmaWheel
Open via Features → Sky Compass or the hamburger drawer.
You don't need to have a calculated chart open — the Sky Compass works from your current location and shows the current sky. It's a real-time tool, not a chart-specific one.
Relationship to your natal chart
The Sky Compass shows transit positions (where planets are now). These are the same planets that appear in your Transits & Hits view, just from a different angle:
- Chart wheel = ecliptic longitude (zodiac sign + degrees).
- Sky Compass = local horizon (compass direction + altitude).
Both views are different projections of the same underlying sky state. Use the chart wheel for meaning; use the Sky Compass for location.
A closing thought
The Sky Compass might seem like a curiosity — a feature you can live without. But for practitioners who do contemplative practice, ritual, or are training their astrological intuition, it slowly becomes one of the most-used features in the app. Not because it tells you anything the chart doesn't — it tells you nothing the chart doesn't. But because it does something the chart can't: it re-embodies astrology. After enough sessions, you stop separating "the chart" and "the sky" in your mind. They become the same thing — one interpreted, one experienced.
That's worth a feature. Try it for a week, ideally outside, before deciding whether it's for you.