MorseReader

MorseReader Support

MorseReader is an iPhone utility for decoding short diagnostic messages sent by a flashing LED. Camera analysis and decoding happen locally, and no account or network connection is required.

Download MorseReader on the App Store

Quick start

1. Open MorseReader and allow camera access.
2. Select Classic Morse or High-Speed Teletype.
3. Point the rear camera at the flashing LED.
4. Keep the LED inside the central square while automatic detection evaluates the highlighted candidates, or tap the LED for a fixed manual selection.
5. Keep the camera and transmitter still while receiving.
6. Use Reset to clear the current transcript and timing state. Use Restart Auto Detect after moving to a different LED.

Mode guides

Each mode has its own protocol, timing, transmitter example, and animated test page:

• Classic Morse protocol and transmitter
• High-Speed Teletype protocol and transmitter

Troubleshooting

Nothing is decoded

• Confirm that the transmitter and MorseReader use the same mode.
• Tap the LED manually instead of waiting for automatic detection.
• Move closer and keep the LED away from the edge of the central square.
• Reduce strong reflections and other flashing lights.
• Keep the phone and transmitting LED stationary.
• Start with the slower timing recommended in the relevant mode guide.

Characters are wrong or intermittent

• Verify the transmitter timing against the relevant mode guide.
• Use Restart Auto Detect after the camera or LED has moved substantially, or select the LED manually when several sources are close together.
• Increase the timing period while diagnosing exposure or camera problems.
• Keep the complete LED brightness range visible without overexposing nearby surfaces.
• Prefer a physical LED. Display refresh, animation scheduling, and rolling shutter can distort an otherwise convincing on-screen test signal.

Camera permission was denied

Open iOS Settings → Apps → MorseReader → Camera and enable camera access.

Saved logs and diagnostics

Save Log writes decoded text and raw symbols to the MorseReader folder in Files under On My iPhone.

Diagnostic recordings are created only after explicitly selecting Record Diagnostic. They may contain camera video, so review them before sharing. Diagnostic files can be deleted using the Files app.

The matching CSV records timestamps, camera size, ROI, automatic/manual state, RGB samples, exposure and ISO, signal threshold, and detector scores. A movie is still useful without its CSV, but sending both makes a failure easier to replay.

Privacy

MorseReader processes camera frames locally. It does not require an account or upload camera data to a decoding service. Saved logs and diagnostic recordings remain under the user’s control unless they choose to share them.

Read the complete privacy statement.

Contact

When requesting support, include:

• iPhone model and iOS version
• Reader mode
• Dot duration or Manchester half-bit period
• Whether the LED was selected automatically or manually
• A short description of the transmitter hardware
• A diagnostic recording and matching CSV when practical

Do not include credentials, private keys, or confidential device data in a support request.

Questions and reproducible bug reports can be filed in the MorseReader issue tracker.