*******************************************
*                                         *
*          SimpleCW Support                *
*                                         *
*******************************************


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

  Version 0.6.0 / TestFlight:
  HamChat is becoming SimpleCW:
  Morse Decoder with version 0.6.0.
  Same app, same existing purchases.
  These instructions cover 0.6.0;
  version 0.5 is still called HamChat.

  No radio needed:
  1. Open the app on two devices
  2. Both set to the same mode
     and tone frequency (try CW)
  3. Open TRANSMIT, type a message,
     then tap TX or 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

  Olivia
    Forward error correction with
    selectable tones and bandwidth

  RTTY
    Baudot text with selectable
    baud rate and frequency shift

  CW decoder choices in 0.6.0:
    Otsu (default) and Bayesian
    Optional on-device ML with
    Premium Modes Unlock; requires
    iOS 18 or macOS 15 or later


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.

  How do I tune the receiver?
  --------------------------
  In 0.6.0, tap the waterfall or
  use Tune in Settings. CW Auto
  acquires a tone; manual tuning
  switches to Hold. Resume Auto
  starts automatic tuning again.
  Older 0.5 releases use colored
  stream tabs instead.

  What is free?
  --------------
  Classical receive in every mode
  and CW transmit are always free.
  Other transmit modes have a
  three-minute trial per session.
  Premium Modes Unlock adds
  unlimited digital-mode transmit
  and the optional ML CW decoder.
  Existing unlock owners get the
  added features in 0.6.0.

  How do I restore my purchase?
  ----------------------------
  Open the premium purchase sheet
  and choose Restore Purchase.
  Use the Apple Account that owns
  the original unlock.

  Input stopped or ML unavailable?
  -------------------------------
  Check the visible error message.
  Allow the requested permission
  in system Settings, then Retry.
  ML failures fall back to Otsu;
  select ML again in Settings to
  retry after resolving the issue.


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

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


PRIVACY
=======

  Signal processing runs on-device.
  No data is collected or shared.

  Full Privacy Policy


CONTACT
=======

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

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