01 / THE TASK

Start with a clear, small result.

This guide walks through one task: “When Email formatting fails.” The useful outcome is a complete, reviewable piece of text, rather than simply seeing an animation or a successful provider response. Use a synthetic example first, then repeat the task in the app and field where you actually work.

Troubleshoot a voice workflow in layers: permission, input signal, speech recognition, text formatting and insertion. A failure in one layer should not be described as a failure in every layer. Use the same short phrase, change one setting at a time and keep evidence of both the expected and actual result.

02 / A WORKED EXAMPLE

One thought. Check the words.

YOU SAY / SET UP
Hi Alex, please review the draft.
ILLUSTRATIVE EXPECTED RESULT
Hi Alex,

Please review the draft.

Use the example as a test case, not a promise of identical automatic output. Speak in your own natural voice and note the exact words you said. If the result differs, separate a speech-recognition mistake from a change introduced by formatting or a destination-field problem.

03 / THE PLAYBOOK

A repeatable way through it.

  1. 01

    Check whether the strip reaches Listening. If it does not, inspect setup, the recording shortcut and the selected audio input.

  2. 02

    Use the free microphone test. It shows recognized words without consuming a trial credit, writing into another app or creating History.

  3. 03

    Compare the speech result with the exact sentence you spoke. A moving waveform proves signal energy, not correct words.

  4. 04

    Test Dictation before Email or Rewrite. That isolates speech recognition from optional text-provider behavior.

  5. 05

    If the text exists in Sayloom but not at the destination, inspect insertion permissions and whether the original field changed.

  6. 06

    Record the app edition, build, chosen language, model and error text. Use a synthetic example rather than private audio when reporting the issue.

04 / FOLLOW THE FLOW

Know which layer you are changing.

THE WORKFLOW, AT A GLANCEDestinationYour voiceReviewYour words
Speech recognition, formatting and insertion are separate stages. Check each stage before moving on.
Check the workflow before using a real message
LayerWhat to checkWhat it proves
Device / editionDesktop · Full Mac when using full Mac controlsYou are testing the intended implementation
MicrophoneSelected input, permission and Listening stateCapture is ready, not that the words are correct
Speech / textOriginal transcript and optional formatting outputYou can identify where meaning changed
DestinationOriginal field, cursor and complete resultThe reviewed text reached the right place

A successful microphone permission check does not establish recognition accuracy. A good original transcript does not establish that an AI rewrite preserved meaning. A finished result in Sayloom does not prove that another app accepted the paste. These distinctions make a failure more specific and easier to resolve.

05 / BEFORE YOU MOVE ON

A short review is worth the pause.

  • ✓ The recording reaches Listening before the first word.
  • ✓ The first and last intended words are present.
  • ✓ Names, actions, dates and negation still mean what you intended.
  • ✓ The destination or copy result contains the complete reviewed text.
The detail that matters here

Optional AI failure should leave the transcript available; local Email layout can still preserve your words.

If the task still fails, keep the expected sentence, actual result, edition and build number together. Change one setting per attempt. Use the free microphone diagnostic for signal checks; do not repeatedly spend trial uses trying to diagnose an unrelated formatting problem.

06 / TWO USEFUL QUESTIONS

Keep the workflow honest.

Does this require an optional AI provider?

Plain Dictation does not require Ollama or a text-provider key. Email can use local layout. AI enhancement depends on the provider configured for that mode, and provider fees or privacy terms are separate. Check the original transcript before changing a writing provider.

Will this work the same way on every platform?

No. The full Mac Desktop, current Mac Store edition and mobile implementations have different capabilities. Mobile speech depends on device and language support. Review the relevant edition and use a supported editable field rather than assuming a Mac shortcut, model file or permission applies everywhere.

Product task guide · prepared from the Sayloom implementation and linked official references. Examples use synthetic text. Capabilities and prices can change; check the app and store before making a decision.

REFERENCES

Go to the source.