Skip to main content

Troubleshooting

Problems grouped by where you notice them. If none of these help, open Settings > Contact and describe what you did and what happened.

Playback and review​

No sound during a review​

  1. Check the volume during the session with the hardware buttons, so you are adjusting media volume rather than the ringer.
  2. Check the output button in the player's now-playing bar points where you expect — speaker, headphones, or a car.
  3. Disconnect and reconnect Bluetooth headphones or speakers.
  4. Close the session and start it again.

On Android, if a card plays when you open it but not in a session, pull down the system tray and confirm audio is going to the media stream, then restart the app.

A card will not play, or shows no waveform​

If your library is in iCloud, the card's audio may not be on this device yet. Long press the card and choose Download Card, or tap the cloud button in the Library for Download All. See iCloud Sync.

The session moves too slowly or too quickly​

Pace is set per session. Edit the session and check Autoplay Sides — off, every side waits for you. With it on, adjust Answer Delay and Time Between Cards, or Restore Timing Defaults. See Card timing.

Autoplay keeps repeating the same cards​

Playing a card without grading it does not change its due date. Turn on the Passive Scheduler for that session so cards you only listened to are spaced out. See Passive scheduling.

There are no cards to review​

  • The session may be showing a folder with nothing due. Check the collection button at the top of the Review tab, or clear the focus to return to All Cards.
  • Due Cards Only may be on and everything is caught up. Well done — or turn it off to study ahead.
  • The folder may be deactivated. Check its Folder Settings.

The screen turns off during a review​

Turn on Settings > Session Behavior > Keep Screen on During Review. The session keeps playing with the screen off either way.

Voices and text-to-speech​

A voice I installed does not appear​

On iPhone and iPad, voices downloaded in the Settings app appear under My Voices > + > System Voice in the voice's language. If one is still missing, close Audio Flashcards completely and open it again.

On Android, restart the app after installing voices. If voices that used to be there have disappeared and only the default remains, restart the device to refresh the text-to-speech engine.

A cloud voice says it has no saved credentials​

Amazon Polly and OpenAI credentials are stored only on the device where you entered them. On a new or second device, edit the voice and enter the credentials again. See Amazon Polly and OpenAI.

A Kokoro voice will not preview or generate​

Check the model finished downloading under Model in the voice's settings, and that the voice itself is downloaded. If a download failed, tap Retry Download. A voice file reported as corrupt can be fixed by downloading it again.

A word is pronounced wrongly​

Respell it the way it should sound, or record that side yourself. See Pronunciation & SSML.

Importing​

CSV import is slow or seems stuck​

Every side is generated as audio, one at a time, so a large import takes a while, particularly with Kokoro or a cloud voice. The estimate under Import is timed with your chosen voices.

  1. On Android, and on iOS 26 or later, you can leave the app: the import keeps going and shows its progress in a notification or on the Lock Screen. On earlier iOS versions, keep the app open until it finishes.
  2. Check Review shows the cards you expect. If columns look merged or split, tap the separator under the file name and choose the right one.
  3. If accented characters look wrong, change the text encoding the same way.
  4. Try a small file, two columns and a few rows, to confirm your voices work.

Some sides are in the wrong place after a CSV import​

Check the Columns in Review before importing: each column's role decides what it becomes. Set a column to Title to name the cards with it, or Skip to leave it out. If the first row holds column names but was imported as a card, choose Header Row. A blank cell keeps its column, so a row with an empty side either makes a card with fewer sides or is skipped, as you choose under Needs Attention.

Audio clips were paired into the wrong cards​

The app guesses the pairing from the file names. In Review, tap Pairing, Sides, or Order to change it, or tap a side to move, swap, or leave out its clip. Names ending in -q and -a (or question and answer, front and back) pair most reliably. See Import audio files.

An audio file was left out​

Needs Attention says why. A file that isn't audio, or is empty, is always left out. A format your device can't decode is reported as can't be read on this device: convert it to MP3 or M4A and import it again.

Imported clips have no word highlighting​

Word highlighting comes from transcribing each side after the import. If the transcription model isn't ready, the cards are still imported and the Done screen says so. Download the model in Settings > Transcription, then use Start Transcribing there. See Search & Transcription.

A shared file will not import​

  • Import is disabled because the deck matches existing cards: you already have a copy. Delete it first if you want to import again.
  • The file is not valid: make sure it has the .share extension and was created by Audio Flashcards, and ask the sender to create it again if it was damaged in transit.

Voice commands​

Commands are not recognised​

  1. Check the listening indicator in the player. If it says Unavailable, allow Microphone and Speech Recognition for Audio Flashcards in your device's Settings app.
  2. Speak between clips. Recognition pauses while card audio plays.
  3. Check Settings > Voice Commands > Language matches the language you speak commands in.
  4. Use Test on that screen to see what is being heard, and change phrases that are not recognised reliably.
  5. Wear headphones with a microphone. On AirPods, switch noise control from Noise Cancellation to Adaptive, which recognised more commands in our outdoor tests.

See Voice Commands.

Voice commands do not start at all​

Voice commands are switched on per session. Edit the session and turn on Use Voice Commands.

Search does not find a recording​

Recordings are only searchable after they are transcribed.

  1. Check the card's folder has the right Folder Language.
  2. Open Settings > Transcription and look at the summary.
  3. Tap Start Transcribing for anything pending. With Whisper, download the model first.
  4. Files listed as Blank were transcribed but no words were found — often the wrong language for that side.

Storage and sync​

Cards are not syncing between devices​

  1. On each device, check Settings > iCloud > Enable iCloud Storage is on.
  2. Open Settings > iCloud > iCloud Status and check Account says Available.
  3. Look for Transfer Errors or Conflicts there and resolve them.
  4. Confirm each device is signed in to the same Apple ID, with iCloud Drive turned on.
  5. Give it a connection and some time, especially the first time a large library uploads.

My cards disappeared after changing iCloud storage​

The iCloud and on-device libraries are separate. Turn Enable iCloud Storage back to how it was and your cards will be there. See iCloud Sync.

Review counts or statistics look wrong​

Two settings deliberately leave reviews out:

  • Record Review Progress off on a session means nothing it does is recorded.
  • Deactivate Folder in Folder Settings excludes that folder from statistics and sessions.

I cannot edit a downloaded deck​

Collections from Shared Cards are linked and read-only so they can receive updates. Unlink the collection in its Folder Settings. See Linked folders.

A backup will not create​

If your library is in iCloud, every card must be on this device first. Use Download All from the cloud button in the Library, then try again.

Running out of space​

Settings > Manage Storage shows what old libraries, iCloud downloads, and the temporary cache are using, and clears them. Removing downloads and clearing the cache never deletes cards. See Manage storage.