arrow_back Back to Home
TROUBLESHOOTING GUIDE

How to Record a Field Debug Session

By Peter Fridrich · Published August 30, 2026 · 5 min read

You said "turn on" and nothing happened. Or the weight jumped to the wrong number. Telling me about it in an email helps, but I still cannot hear what your phone heard. Field Debug fixes that: it records the voice pipeline and the audio during your workout, you flag every miss with one tap, and then you send the whole thing to me in a couple of taps.

This is the single fastest way to get a voice recognition problem fixed. Here is the whole flow, screen by screen.


What Field Debug actually records

While a Field Debug session is running, GMVoice stores what it needs to reconstruct exactly what happened:

About your privacy: nothing is recorded until you start a session yourself, and nothing leaves your phone until you tap Send Field Debug. The capture is used only to diagnose the problem you reported. If you would rather not send it over the internet, use Export Field Debug instead and pull the zip off your phone over USB or the Files app. Full details in the privacy policy.

Step 1: Open the advanced options

Everything starts on the main screen. Two buttons in the top row matter here:

GMVoice main screen with the GMVoice logo in the top-left corner highlighted as the way to open advanced options, and the shield icon highlighted as the way to open Voice Guard.
Tap the logo for advanced options, the shield for Voice Guard.

Step 2: Set up Voice Guard first

Before you record anything, it is worth doing the Voice Guard setup. Voice Guard checks every spoken command against a print of your voice so only you can drive the machine. A session recorded with it set up tells me a lot more than one without.

Tap the shield, then Set up voice. It is a short guided setup: you read aloud for about 30 seconds, then train your commands.

The GMVoice Voice Guard panel showing 'No voiceprint for this microphone' and the 'Set up voice' button highlighted, above an explanation of how Voice Guard works.
A voiceprint is tied to one microphone. Set it up on the mic you actually train with.

Two things from that panel are worth repeating, because they explain most "it did not hear me" reports on their own:

Step 3: Turn on Field Debug

Tap the GMVoice logo to open the advanced options panel and choose Field Debug: Start recording. From this moment the session is being captured.

The GMVoice advanced options panel with the 'Field Debug: Start recording' row highlighted, alongside Copy Activity Log, Export Field Debug and Send Field Debug.
One tap on Field Debug: Start recording and the capture is running.

Step 4: Start your voice commands

Close the panel. You should now see a red REC · tap = ignored pill floating above the command list. That pill is how you know Field Debug is active. If it is not there, the recording did not start; go back to Step 3.

Then tap START and train exactly as you normally would. Do not change your routine for the recording. I want to see the real problem, in the real conditions where it happens.

GMVoice main screen with the red 'REC · tap = ignored' pill visible, marked as the indicator that Field Debug is active, and the green START button marked as the way to start voice commands.
Red pill visible = recording. Now tap START.

Step 5: Flag every command that misses

This is the part that makes the whole capture useful. Every single time a command does not work, tap the red REC pill right away. Ignored, misheard, triggered the wrong thing, reacted far too slowly: all of it counts.

The tap drops a marker at that exact second, and the audio around it plus the pipeline details are stored with it. Without markers I have to guess where in a 40-minute recording something went wrong; with them I jump straight to it.

GMVoice listening for commands during a Free Lift workout, with the red REC pill highlighted as the button to tap each time a command does not work, and the STOP button marked.
Command missed? Tap REC. Do it as many times as you need. There is no limit.

Step 6: Add a one-line note

After each marker, a Marker recorded dialog pops up and asks what happened. Type one short line and tap Save note. You can also tap Skip and the marker is kept either way, but a note makes it far easier to work out what you expected.

Good notes are short and concrete:

The GMVoice 'Marker recorded' dialog showing an ignored / no response event with a timestamp and a text field asking 'What happened? (e.g. said turn on, nothing)', with Skip and Save note buttons.
Your short description is what I use to debug that exact moment.

Step 7: Stop the recording when you finish

When the workout is done:

  1. Tap STOP to stop voice commands.
  2. Tap the GMVoice logo to open the advanced options panel again.
  3. Tap Field Debug: Stop recording.
  4. Tap Send Field Debug.
The GMVoice advanced options panel showing the 'Field Debug: Stop recording' and 'Send Field Debug' rows, numbered in the order they should be tapped.
Stop the recording first, then send. Export Field Debug is the offline alternative. It just zips the session so you can copy it off the phone yourself.

Step 8: Add your email and a short summary

The last screen asks for two things. Both matter:

It can be two sentences. Something like: "Free Lift with AirPods, tried changing weight by voice about ten times, three were ignored, and those are the markers." Then tap Send.

The GMVoice 'Send to developer' dialog with an email field and a message field for session details, and Cancel and Send buttons.
Short is fine. Just say what you were testing.

How to make a capture that is actually useful

A few habits make a big difference to how quickly I can fix something:

What happens next

I go through the markers first, listen to the audio around each one, and compare it against what the pipeline detected. Most reports fall into one of a handful of buckets: the mic never picked the command up, the transcription was close but not close enough, Voice Guard rejected it as not-your-voice, or the command reached the machine and the machine was slow to respond. Each one has a different fix, and the capture is what tells them apart.

If you would rather write first, or you are not sure whether something is worth recording, just email me at contact@gmvoice.tech. And if you are still setting things up, the DIY start guide and the Dongle API guide cover the two things that most often cause trouble before voice recognition is even involved.


Related guides

Planning your next session? GM Manager builds Speediance workouts in your browser.

Buy me a coffee