Documentation

Getting started

On first launch, OrbitDeck downloads a satellite catalog and sets a default station. To get useful results:

• Set your station location in Settings.
• Add a few satellites to your favorites from the Satellites screen (for example the ISS and an active FM or linear bird).
• Open Home to see live look angles and your next qualifying pass.

Setting your station

Your observer station drives every observer-relative screen: Track, passes, MUF, mutual visibility, and more. Open Settings → Observer station.

Location source

Choose how OrbitDeck resolves your position:

• Fixed site — a named location you enter and edit manually. This is preserved and is the default.
• Always use current location — OrbitDeck follows your device's GPS. While following, the station is named Current location, its fields are managed automatically, and your fixed site is preserved so switching back restores it exactly.

Entering coordinates

In fixed mode you can enter your position three ways:

• Type a latitude and longitude in decimal degrees.
• Type a Maidenhead grid square (4, 6 or 8 characters, e.g. FM18 or FM18lv) and tap Set. OrbitDeck places you at the grid center.
• Tap Use Current Location for a one-time fix.

Set your altitude in meters for the most accurate look angles.

Grid squares & VUCC

OrbitDeck shows your six-character Maidenhead locator wherever your station is displayed, including the Station card on Home.

Under ARRL VUCC rules, a station physically on the line between two grid squares may count both, and a station on the corner where four grids meet may count all four. When your position is on a boundary, the Home Station card lists every grid you may claim, labeled On grid line or On grid corner.

Satellites & catalog

The Satellites screen lists the catalog and lets you mark favorites, which drive the Home dashboard and all-sky radar. The New Launches screen surfaces recently launched objects.

Choose your element source in Settings → GP element source:

• AMSAT — the AMSAT daily bulletin GP feed (default).
• CelesTrak — select a group such as the amateur satellites set.
• Custom — a URL to your own OMM JSON.

You can also add manual satellites and transponders, and recover elements from a state vector using the Tools screen.

Passes & tracking

• Home — live look angles, the next qualifying pass, and your favorites' upcoming passes.
• Track — a real-time polar sky plot; toggle north-up or compass-up. AOS/LOS and the live position are shown as small direction-of-travel arrows.
• Daily Schedule — every favorite's passes grouped by day and ordered by AOS. It opens on today, scrolls back seven days, and extends into the future as you scroll.
• Next Passes and Pass Detail — pass lists with polar plots and elevation-vs-time profiles.
• Ground Track — the sub-point path and a live footprint/heading marker on a map.
• Pass Progression — passes across the coming days.
• Sky Radar — every favorite plotted on one all-sky chart.
• Grid Finder (Live) — a high-precision GPS tool that guides you onto a Maidenhead grid line or corner with a compass arrow and a proximity map, for VUCC roving.

Set the minimum elevation in Settings to filter marginal passes.

Radio & Doppler

The Radio screen provides:

• A four-dial DX Doppler display and a single-station RX/TX Doppler playbook.
• Per-satellite calibration. Your calibration is a single combined oscillator correction (radio plus satellite) that you can measure from either the downlink or the uplink; both offsets fold into the receive dial and nothing is added to the transmit dial. It is stored per satellite and applied to every live Doppler readout, with an unobtrusive note when it is in effect.
• A link budget with a per-elevation margin curve.
• Transponder listings from the SatNOGS database, with two-way transponders shown first.

The Calibrations screen (Catalog & Configuration) is a bulk editor: an editable downlink/uplink table for every satellite, favorites first and searchable, with CSV import and export for entering many calibrations at once.

Orbital analysis

The Analysis group includes orbital elements and derived quantities (J2 nodal and apsidal rates, beta angle, eclipse fraction, local time of the ascending node), equator crossings, Sun/Moon transits, illumination, orbital zones, conjunctions, AO-7 mode timing, mutual-visibility windows, and workable-grid discovery.

Space weather & propagation

Space Wx shows live values from NOAA SWPC: 10.7 cm solar flux, sunspot number, planetary Kp and the A index, along with geomagnetic condition and aurora likelihood. MUF / HF Prop and the operating outlook use these to summarize HF and 6 m conditions. Space weather refreshes automatically when stale and on returning to the app.

OSCARLOCATOR

The OSCARLOCATOR Sim reproduces the classic azimuthal-equidistant tracking overlay, in both polar and QTH-centered projections, with minute ticks along the ground track. Reference Orbits lists the schedule, and you can export printable OSCARLOCATOR sheets as PDF from Exports.

Bench tools

The Tools screen collects more than 60 calculators for antennas, feedline, RF, link budgets and orbits. It also includes:

• A receipt-tape scientific calculator with a DEG/RAD toggle, metric-prefix literals (for example 100k, 2.2n), an Ans register, and RF/orbit helper functions.
• A graphing calculator with trace, root finding, an integral readout, a data table, and CSV export.
• A grid ↔ lat/lon converter, a full Tiny BASIC interpreter with live satellite data and graphics, and a DXCC lookup.

Exports & alarms

The Exports screen produces PDF and CSV/XLSX files for passes, site comparisons and OSCARLOCATOR overlays, sharable via the standard iOS share sheet. You can also schedule a local pass alarm; OrbitDeck requests notification permission only when you first schedule one, using the lead time set in Settings.

Data sources

OrbitDeck retrieves data from public services and identifies itself politely:

Service	Used for
CelesTrak	General Perturbations (GP) orbital elements
AMSAT	Daily bulletin GP feed and status reports
NOAA SWPC	Solar flux, sunspot number, planetary Kp and A index
SatNOGS	Transponder database
hams.at	Upcoming satellite activations
QRZ (optional)	Callsign lookup, if you provide credentials
Space-Track (optional)	Archival elements for Orbital History, if you provide credentials

OrbitDeck honors CelesTrak's usage policy — at most one request per dataset every two hours, with back-off on rate-limit responses — so normal use will not get your address blocked. Catalog and transponder data also refresh automatically about once a week.

Troubleshooting

No passes or empty screens

Confirm your station location is set correctly and that you have added favorite satellites. Lower the minimum elevation if you expect marginal passes.

Space weather shows blank K or A

OrbitDeck refreshes space weather when it is stale or on returning to the app. If values are blank, tap the refresh control on the Space Wx screen; a connection is required for the first fetch.

Location not updating

If you chose "Always use current location," ensure OrbitDeck has Location permission in the iOS Settings app. You can switch back to a fixed site at any time without losing it.

Compass heading looks off

Compass-up mode uses true heading, which requires a location fix to correct for magnetic declination; allow a moment after enabling it.