DockTalkDOCKTALK
Stations Leaderboard Setup guide Station guide

Your station

Listen to your receiver live, tune it, and play back everything it recorded.

Your claim code

It's the code in the install command we sent you, like DT-AB12-CD34.

Keep the code private: anyone with it can change your box's settings. Lost it? Email hello@docktalk.app.

Your station

Public station page
Applying your settings. Your box restarts to pick them up, usually within 5 to 7 minutes, and is off the air for a few of those minutes.
Restart your box to apply your new settings. On the box, run sudo docker restart docktalk-node, or unplug its power for 10 seconds and plug it back in. It's back on the air within a couple of minutes, and this note goes away once it has your settings.

DockTalk Pro, free for hosts

Thanks for running a station. Your iPhone gets DockTalk Pro free, for life. Install DockTalk from the App Store first, then:

Open DockTalk and unlock Pro
QR code that unlocks DockTalk Pro

Point your iPhone camera at this code and tap the DockTalk link. It works for up to 5 phones. A new phone or a reinstall? Just scan it again.

Listen live

Your box's audio exactly as it sends it, before any DockTalk processing. A channel stays silent until someone transmits, so leave one playing.

Your moments

Stories your box captured that made it into the app. Tap one to replay it the way the app does: the chart, who's talking, and the real audio.

Latest published

  • Loading...

Made Top

  • Loading...

Settings

How your box is doing

Measured from what your box actually captured: openings over the last week (or since your box started on its current settings), clarity over the last week, noise over the last few hours. A suggestion appears only when these numbers show what it would do, and says what it's based on. After you change something, this page measures what the change did.

Gain

How much the radio amplifies the antenna. Lower it if loud boats sound harsh or distorted; raise it if calls arrive too quiet. Gain turns up the noise along with the boats, so more isn't better.

Squelch, per channel

How strong a signal must be, in dB above the noise, before your box records it. Higher records less static but can cut faint calls; lower catches fainter boats but records more static. Leave a box empty to use DockTalk's setting. Allowed: dB.

ChannelOpeningsClaritySquelchSuggestion

What happens when you save

  1. Your settings are stored at DockTalk right away. Only your box changes; nothing else on the network does, and nothing restarts on our side.
  2. Your box picks them up by restarting. Newer boxes restart on their own within 5 to 7 minutes and are off the air until they're back. Older boxes show a note at the top asking you to restart yours.
  3. Changes are spaced 30 minutes apart, because each one takes your box off the air for a few minutes.
  4. They stay until you change them. Your box updates its own software daily, and updates never reset your settings.
  5. Give a change 3 days. Then this page compares the days before it with the days since: calls with speech, openings, and clarity. If calls dropped by more than normal day-to-day variation, it offers to put the old setting back.

Your own receiver sets gain and squelch on this install; DockTalk relays what it publishes.

Recordings

Every call your box captured, and its full round-the-clock recording, kept since your box went on watch. Times are harbor time ().

    Everything the channel carried, silence included, one file per hour. Pick a channel above.

    HourChannelSize

    On your home network

    Your box can also play its channels straight to any phone or computer on the same network, with DockTalk out of the middle. It's off unless you turn it on, because it's the one thing on the box that accepts a connection (read-only, from your own network).

    Turn it on: on your box, run your install command again with --listen at the end. Nothing is lost; it takes a few minutes.

    
          

    Then open on any device on that network. To turn it off, run the same command with --no-listen instead.

    Some Windows PCs can't open .local names; use the box's IP address from your router instead, with :8800 at the end.

    Home-network listening runs on dedicated DockTalk boxes. On this install your own radio software already plays your receiver locally.

    Station guide

    How your box works

    Your box tunes every channel on its list at once with one radio dongle. When a channel's signal rises above its squelch, the box streams that audio to DockTalk over an ordinary outbound internet connection. DockTalk cuts each transmission into a call, transcribes it, and builds the stories in the app. Your box accepts no connections from the internet, and it updates its own software daily.

    Gain and squelch, in plain terms
    • Gain is the radio's volume knob for the antenna. Too high and strong nearby boats distort and the noise floor rises; too low and distant boats disappear. Most boxes sit between 22.9 and 38.6 dB.
    • Squelch is the gate. Below it, nothing is recorded. DockTalk sets it low (5 dB, 3 dB on Coast Guard channels) so weak calls make it through. If a channel records mostly static, often from a nearby charger, LED light or inverter, raise that channel a couple of dB.
    • Noise floor is the background hiss level the radio sees, in dBFS (0 is the radio's limit). Most stations sit between -45 and -33. Higher usually means gain is too high or something nearby is noisy.
    • Change one thing at a time, then give it a day. Your public station page shows reception quality and how far out your box hears.
    • Some locations have a minimum squelch set by DockTalk because of local interference. It's shown in the settings and always applies.
    When do settings take effect?

    Your box downloads its settings when it starts. On newer boxes, saving marks the box for a restart: within 5 to 7 minutes it restarts on its own and comes back on the air, and the banner at the top shows while that's happening. Older boxes can't restart themselves, so the banner asks you to restart yours. If the box is offline when you save, it picks up the settings the next time it starts. Your settings stay until you change them; software updates don't touch them.

    Recordings: what's kept and for how long
    • Calls: each transmission your box captured, with its transcript when there's speech. If two stations heard the same call, you get your own box's copy.
    • Full recording: one file per channel per hour, silence included, exactly as your box sent it.
    • Both are kept indefinitely. Play them here or download them (WAV for calls, MP3 for hours).
    Changing which channels your box tunes

    The channel list comes from your harbor's plan, and all channels must fit in one 2.4 MHz slice of the band. To add or drop a channel, email hello@docktalk.app; it's a settings change on our side and a restart on yours.

    Your box shows offline
    • Check power and that the network it uses is up. Boxes recover from WiFi drops on their own, and reboot once if an outage drags on.
    • Moved it or changed WiFi? Power it on away from your old network: it opens a setup hotspot named after the box. Join it from your phone and pick your new network.
    • Still dark after an hour? Email us your station number.
    Privacy

    Marine VHF is public airwaves. Your public station page never shows your name or address, only a call name and an area. This page is private to your claim code; keep that code to yourself.

    docktalk.app  ·  Setup guide  ·  hello@docktalk.app  ·  Marine VHF is public airwaves; we just listen well.