*******************************************
*                                         *
*           HamChat Support                *
*                                         *
*******************************************


GETTING STARTED
===============

  No radio needed:
  1. Open HamChat on two devices
  2. Both set to the same mode
     (PSK31 is a good default)
  3. Type a message, press Enter
  4. The other device decodes it
     from speaker audio

  With a radio:
  1. Connect a USB audio interface
  2. Select it as audio input/output
  3. Tune to a digital mode frequency

  With webSDR (macOS):
  1. Settings > Input > System Audio
  2. Grant Screen Recording permission
  3. Open any webSDR in your browser


AUDIO INPUT TIPS
================

  Built-in mics have hardware noise
  cancellation that fights constant
  tones like PSK31 carriers. The DSP
  classifies them as noise and kills
  them after 1-3 seconds.

  Solutions:
    - System Audio input (macOS) to
      bypass the mic entirely
    - USB audio adapter for clean
      audio from a radio
    - CW mode is less affected (the
      on-off keying doesn't trigger
      the noise gate as hard)


MODES
=====

  CW / Morse
    5-40 WPM, adaptive speed
    detection, free TX

  PSK31
    ~50 WPM, 31 Hz bandwidth,
    the ham radio classic

  PSK63
    ~100 WPM, double speed PSK31

  MFSK16
    ~23 WPM, FEC, best noise
    immunity


FAQ
===

  Do I need a ham radio license?
  ------------------------------
  Not for speaker-to-mic use or for
  decoding webSDR signals. You need
  a license only to transmit on
  amateur radio frequencies.

  Why can't the decoder lock?
  ---------------------------
  Most likely the built-in mic's
  noise cancellation. Try System
  Audio or a USB audio adapter.
  Check the waterfall — if the
  signal fades in and out, it's
  the noise gate.

  What are the colored tabs?
  --------------------------
  Each tab is a decoder stream at
  a different frequency. Click to
  set as TX frequency. Messages
  from all streams appear in the
  chat log, color-coded by channel.

  Why is CW TX free?
  -------------------
  It's the original digital mode.
  Free since 1895. All receive is
  always free too.


SYSTEM REQUIREMENTS
===================

  macOS 15.0 (Sequoia) or later
  iOS 17.0 or later
  Microphone access for decode
  Audio output for transmit


PRIVACY
=======

  HamChat operates entirely offline.
  No data is collected or shared.

  Full Privacy Policy


CONTACT
=======

  Bug? Feature request? Just 73?
  jeroen@strangeloop.nl

*******************************************