AirPods: fix audio dropouts (macOS)

AnkiWeb addon 676963607

Keeps a silent dithered audio stream running during reviews so macOS AirPods stay connected, preventing missing, broken, or dropped audio from short clips.
AI-generated summary; may contain mistakes.

bugfix-workaround

Open on AnkiWeb GitHub Find alternatives

AnkiWeb

Votes
3 (πŸ‘ 3 Β· πŸ‘Ž 0)
Updated
2026-08-06
Anki versions
26.08~
License
MIT (from the GitHub repository)
Virus scan
No ClamAV match A match does not prove malware. No match does not prove that the code is safe.
Languages
Python, JSON
Description language
en

Maintenance

active

  • Last update or commit: 2026-08-06 (87 days before the snapshot).
  • GitHub Actions workflows: 1.
  • The GitHub repo is shared with 1 other addon; its commits, issues and releases are not specific to this one.
  • Commits in the last year: 7.
  • Issues: 0 open, 0 closed.
  • Pull requests: 0 open, 0 merged.

Will it work on my Anki?

Version branches
Min AnkiMax AnkiUpdated
2.1.4526.08+2026-08-06
History across monthly snapshots

Loading…

Similar addons

Fix Windows Bluetooth Audio Lag (SoundKeeper)

Keeps Bluetooth headphones awake by playing an inaudible zero-audio stream via SoundKeeper, preventing cut-off card audio on Windows, running only while Anki is active.

bugfix-workaround

4 votes 51% approval πŸ‘ 4 Β· πŸ‘Ž 0 Anki 25.09.4~ Updated 2026-05-12
Bluetooth Anti-Lag Add-on

Loops silent audio while Anki runs to keep Bluetooth headsets connected and eliminate playback lag at the start of card audio.

bugfix-workaround

2 votes 34% approval πŸ‘ 2 Β· πŸ‘Ž 0 Anki 2.1.16~ Updated 2023-06-19
All your due cards in one deck

Gathers due review cards from chosen decks into one daily-rebuilt filtered deck with configurable order and card limit, preserving normal scheduling.

filtered-decksdeck-management

1 votes 21% approval πŸ‘ 1 Β· πŸ‘Ž 0 ⭐ 0 Anki 26.08~ Updated 2026-08-06

Description

Anki plays short audio clips, and on macOS that does not sit well with AirPods. The opening of a clip goes missing, playback breaks up partway through, and on a long session the connection can drop entirely. Short clips make it worse, and so does having something else playing at the same time.

The add-on holds a silent stream open so the connection never goes idle. I wrote it because nothing in Anki or in macOS fixed the problem.

How it works

While you review, an inaudible stream plays through your headphones, so the audio connection is never asked to start from cold. Bluetooth appears to suspend the stream between clips, and waking it repeatedly seems to be what unsettles the connection, though that part is inference rather than something I have confirmed.

The stream is not true silence. It carries dither, meaning random noise at roughly a millionth of full volume, because some Bluetooth stacks treat an all-zero stream as no stream at all and go idle regardless.

Requirements

macOS and Anki 2.1.45 or newer. On Windows and Linux the add-on loads and does nothing.

Install mpv with brew install mpv. Without it the add-on falls back on the system afplay, which cannot loop a file and so restarts it every ten minutes.

Settings

Tools β†’ AirPods audio fix β†’ Settings…

You decide whether it runs at all, and whether it runs only around audio or for as long as Anki is open. Running it continuously is more reliable but prevents your headphones from idling, which shortens their battery life noticeably.

Tools β†’ AirPods audio fix β†’ Test it plays a rapid burst of beeps. They should sound even. Choppy or missing beeps mean the connection is still dropping.

What it will not fix

A connection dropping for some other reason, such as a congested 2.4 GHz band or headphones low on charge.

It also runs a small background process, either mpv or afplay, for as long as Anki is open. That process stops when Anki quits and is cleaned up on the next launch if Anki crashes.

Support

Ratings on AnkiWeb are close to the only way anyone discovers an add-on, so leaving one is the most useful thing you can do.

Buy me a coffee at ko-fi.com

Report a bug

README

Anki add-ons

Two Anki add-ons I wrote for problems that were bothering me. Neither has any third-party dependency, only the Python standard library and Anki's own APIs.

Add-on Problem Platform Install
AirPods: fix audio dropouts Audio clipping and dropping out on AirPods during review. macOS AnkiWeb, code 676963607
All your due cards in one deck Reviews scattered across many decks. All AnkiWeb, code 1393821859

Installing

Tools β†’ Add-ons β†’ Get Add-ons in Anki, then paste the code. To run from source, copy the add-on's folder into your addons21/ directory and restart.

Building

./build.sh                      # both
./build.sh bt_audio_keepalive   # one of them

This checks the manifest, then writes a .ankiaddon with meta.json, user_files/ and the caches left out.

Working on these

CONVENTIONS.md covers the code and STYLE.md covers anything a user reads. python3 check.py enforces what can be enforced.

Support

Buy me a coffee if one of these saved you some trouble. I am also available for commissioned Anki add-on work.

Licence

MIT. Use it, change it, redistribute it, and keep the copyright notice.

Bugs

Open an issue.