Chartplotterearly · v0.1MIT
omahelm
NOAA's charts, in your Omarchy theme, with your boat on them. Soundings, contours and shading, buoys and beacons labeled the way a paper chart labels them, lights and their sectors, rocks and wrecks, traffic lanes and anchorages. The boat, its track and the AIS traffic come from omakeel; the wind comes from omawind.
What it does
- Reads the charts itself. The S-57 reader, the chart updates, the symbols and the renderer are all written from scratch in Rust, with no map library or GDAL in between. The reader is checked against GDAL on every California cell NOAA publishes: the same features and the same vertices, updates applied.
- Follows the boat. It opens following, and panning stops it. f follows again, c centers once.
- Says what's there. Click the chart for what's charted at that spot. With the wind on, the card leads with the forecast for that very spot and the nearest station within 10 nm.
- Wind, forecast and measured. HRRR barbs from omawind, and the wind NOAA's piers and buoys measured, drawn as accent barbs labeled like
7g11. The time bar shows when the breeze builds. - A waypoint. Right-click, or w, for bearing, range and ETA from the boat.
- Night Watch. n turns the window red on black, chart and all. Marks keep their meaning by brightness, shape and label.
In every Omarchy theme
The chart takes its colors from the active Omarchy theme and redraws when you switch. Colors that mean something at sea don't follow the theme: a green buoy stays green even when the theme's green is amber.
For after dark, Night Watch turns this one window red on black, whatever the theme, and leaves the rest of the desktop alone. Or choose palette = "paper" for the colors of a paper chart.
Keys
| Key | Does |
|---|---|
| h j k l | Pan; the arrows work too |
| + - | Zoom; so does scrolling |
| f | Follow the boat, or stop |
| c | Center on the boat once |
| Click, i | What's charted there, or at the center |
| w, right-click | Set a waypoint; W clears it |
| b | Wind barbs, forecast and measured |
| [ ] | The wind an hour earlier, later |
| t | The time bar: the forecast at the boat, hour by hour |
| space | Play the wind hour by hour |
| n | Night Watch |
| ? | Every key |
| q | Close |
Install
You need Rust and the Omarchy shell. Build it, add it to the shell, then download your waters. NOAA's charts are free:
$ git clone https://github.com/shieldsworks/omahelm ~/.local/share/omahelm/src $ cd ~/.local/share/omahelm/src $ cargo build --release --locked $ bash scripts/link-plugin.sh $ target/release/omahelm fetch CA # California, about 55 MB
Open it with omarchy shell shell toggle org.omahoy.helm "{}", or on its own with ./run.sh. Run fetch again each week for NOAA's corrections. The README covers settings: units, safety depth and contours.
Not yet
- No routes yet. One waypoint at a time.
- The track is kept for the session only, until omalogbook.
- Labels can crowd each other near busy harbor entrances.
- No touch gestures.