This is an old revision of the document!
MSeven M17 — Getting Started Guide
Ham Radio · Digital Voice · iOS
This content was produced for KJ7T by ClaudeAI on March 20, 2026, edits by KJ7T on March 21, 2026
Amateur License Required · Developer: Gregg Wonderly · Protocol: M17 Open Source
Intro: What Is This App?
MSeven M17 is an iOS app that turns your iPhone or iPad into a digital voice radio, connecting you to the M17 reflector network over the internet — no physical radio hardware required.
M17 is a fully open-source digital voice and data protocol for amateur radio, using the Codec 2 voice encoder. Think of it like D-STAR or DMR, but community-built with no proprietary licensing. Reflectors are internet servers that link users together, similar to how IRLP or AllStar works.
⚠ License Required: You must hold a valid Amateur Radio license to transmit. You can listen (monitor) without transmitting, but you must identify with your callsign to use PTT.
Step 1: Install the App
- Find it on the App Store — Search for “MSeven M17” on the Apple App Store, or search for developer name “Gregg Wonderly”. The app icon features the M17 logo.
- Download & Install — Tap Get and authenticate with Face ID, Touch ID, or your Apple ID password. The app is free to download.
- Grant Microphone Permission — When prompted, tap Allow to grant microphone access. This is required for transmitting. Without it you can still receive audio.
Step 2: Initial Configuration
Before connecting to any reflector, you need to configure your callsign and basic settings. Look for a Settings or gear icon in the app.
| Setting | What to Enter |
|---|---|
| Callsign | Your full FCC callsign in UPPERCASE (e.g., W7XYZ). This is your identity on the network — no registration needed, your callsign is your ID. |
| CAN (Channel Access Number) | Leave at 0 unless the reflector specifies otherwise. CAN 0 is the standard default. |
| Audio Input | Select your iPhone's built-in microphone, headset, or AirPods. The app includes built-in audio processing for clarity. |
| Audio Output | Speaker, headphones, or Bluetooth. CarPlay is also supported for in-vehicle use. |
✓ Tip: The app supports spectrum equalization for both transmitted and received audio — you may want to experiment with audio settings if you find the received audio sounds thin or boomy.
Step 3: Connecting to a Reflector
M17 reflectors are named with a prefix of M17- followed by up to 3 characters, and each reflector has lettered modules (A through Z) that act like separate rooms or channels.
- Add a Reflector — Tap the /+/ button or “Add Reflector” option. You'll enter a reflector name and module letter.
- Enter the Reflector Address — Type the reflector name (e.g., M17-M17) and select a module (e.g., C). The app will look up the server address automatically using the M17 reflector directory.
- Save It — Save the reflector to your list. You can save multiple reflectors and switch between them — including with the CarPlay prev/next track controls.
- Tap Connect — Tap your saved reflector and then Connect. The app will link to the reflector over your internet connection (Wi-Fi or cellular).
Good Starter Reflectors
| Reflector | Description |
|---|---|
| M17-M17 / C | Main M17 community reflector. Friday nets at 17:00 UTC. Great for newcomers. |
| M17-USA / A | US-focused general activity reflector. |
| M17-CAN / A | Canadian activity reflector. |
| M17-WW / A | Worldwide general linking reflector. |
✓ Find more: A full list of M17 reflectors worldwide is at m17project.org and the M17 Foundation Wiki.
Step 4: Transmitting (PTT)
- Press and Hold PTT — The large PTT (Push-To-Talk) button puts you in transmit mode. Hold it while speaking, just like a radio.
- Identify Yourself — Say your callsign at the start of each transmission
— this is an FCC requirement. Example: “W7XYZ monitoring” or “W7XYZ, good morning”. The actual FCC rule (97.119) says you must identify at the end of each communication and at least every 10 minutes during a communication. Identification must be given using your FCC-assigned call sign. You are not required to identify at the start of a transmission, but many hams do ID at the start out of habit or courtesy — it's good practice and helps others know who they're talking to. - Release PTT to Receive — Release the button to switch back to receive mode. The app shows you the callsign of whoever is currently transmitting.
- Watch for [DOUBLE] — If you see a [DOUBLE] indicator, it means two stations transmitted simultaneously. The app will automatically un-key your PTT after 3 seconds to prevent a stuck transmit situation.
⚠ Doubling: If [DOUBLE] appears frequently on a busy reflector, wait for a pause before keying up — same courtesy as on a repeater.
Step 5: Key Features to Know
| Feature | How It Works |
|---|---|
| Station Map | The app displays a map showing the geographic location of active stations on the reflector. Tap a pin to see their callsign and details. |
| Active Callsign Display | The currently transmitting station's callsign is prominently shown on screen in real time. |
| Transient Station List | A scrollable log of recent stations that have transmitted on the connected reflector — useful for seeing who's been active. |
| Contact Logging | Log contacts with comments directly in the app. Add notes to remember conversations — handy for mobile operation. |
| Mute Button | Mutes received audio without disconnecting from the reflector. Useful in meetings or noisy environments. |
| CarPlay Support | Full CarPlay integration. Use your car's screen to connect, monitor, and PTT. Step through saved reflectors with prev/next track buttons; play/pause selects and connects. |
FAQ: Common Questions
Do I need a hotspot or radio hardware?
No. MSeven M17 connects directly to M17 reflectors over your phone's internet connection. No MMDVM hotspot, Raspberry Pi, or physical radio is needed. Your iPhone is the transceiver.
Can I use it on cellular data?
Yes. The app works on both Wi-Fi and cellular (LTE/5G). Audio quality may vary on weak cellular signals, but it generally works well on any reasonable connection.
What's the audio quality like compared to FT8/FT4?
M17 is a voice mode, not a data-exchange mode like FT8. It uses Codec 2 at 3200 bps — think of it as similar quality to DMR or D-STAR, quite intelligible and clear on a good connection, with the app's built-in equalization helping further.
Can I monitor without transmitting?
Yes. Connect to a reflector and simply don't press PTT. You can listen all you like. No license is required just to receive.
The app shows a CRC error or "checking CRC" message. What do I do?
Newer versions of the app include a fix for CRC calculation issues that caused error messages on certain hotspots. Make sure you are running the latest version from the App Store.
How do I find active M17 nets and schedules?
The main M17 community net runs on M17-M17 module C every Friday at 17:00 UTC — a great place to test your setup and meet other M17 operators. Check m17project.org and the M17 Foundation Discord for more net listings.
Can I use Bluetooth headsets or AirPods?
Yes. The app supports Bluetooth audio output. AirPods and other Bluetooth headsets should work through standard iOS audio routing. For CarPlay, the car's microphone and speakers are used.
MSeven M17 — Getting Started Guide
Developer: Gregg Wonderly · Available on the Apple App Store
M17 Project: m17project.org · M17 Foundation Wiki: wiki.m17foundation.org
This is not official documentation. Always comply with FCC regulations and identify with your callsign when transmitting.
