Repository navigation
Troubleshooting and FAQ
Find clear answers to setup, speech audio, AAC Backup file migrations, and accessibility options for BridgeAAC (bridgeaac/core).
Tip
Fast Diagnostic: If speech is silent on an iPad, verify the Silent Mode Bell icon in Control Center is OFF and tap any button once on the screen to initialize Safari's Web Audio context.
-
Check the Silent / Mute Switch:
- On older iPads with a physical switch on the side, ensure the orange indicator is not showing.
- On modern iPads and iPhones, swipe down from the top-right corner to open the Control Center. If the Bell icon is red or crossed out, tap it to disable Silent Mode.
-
Audio Routing:
- In Control Center, check the media player box in the top-right. If it shows connected AirPods, hearing aids, or a classroom Bluetooth speaker, disconnect them or select iPad Speaker.
-
First-Touch Audio Activation:
- Apple iOS Safari requires one physical finger touch on the screen before web audio is unlocked. Tap any button once to initialize the audio subsystem.
-
Use Pre-Cached Vocabulary Audio:
- In BridgeAAC, tap Settings → Speech → Pre-Cache Active Vocabulary. This stores pre-generated WAV audio clips for all buttons directly in IndexedDB for instant, reliable playback.
-
Private Browsing / Incognito Mode:
- Safari and Chrome disable offline IndexedDB and OPFS file writing while in Private Browsing mode. Open BridgeAAC in a normal browser tab or as an installed Home Screen app.
-
School Wi-Fi Web Filters:
- Some school district firewalls restrict downloads from raw model CDNs (
huggingface.coorjsdelivr.net). Temporarily connect the tablet to a phone mobile hotspot or home Wi-Fi to download the ~25 MB voice model. Once downloaded, it stays on the device permanently and requires no internet.
- Some school district firewalls restrict downloads from raw model CDNs (
-
Storage Quota:
- Ensure the device has at least 100 MB of available storage (
Settings > General > iPad Storage).
- Ensure the device has at least 100 MB of available storage (
Yes. Export the vocabulary from AAC Backup on the iPad as a .ce file (via Files, AirDrop, or Google Drive). Then open BridgeAAC on your Android tablet or Chromebook, tap Vocab → Import File, and choose the .ce file. The vocabulary will load with identical button positions, colors, symbols, and folder navigations.
- If the AAC Backup file was created prior to 2012, it may use an older non-SQLite format.
- Open the file in a recent version of AAC Backup on an iPad, duplicate it, and export a fresh copy. Modern AAC Backup exports will always be formatted in standard SQLite.
- If you run BridgeAAC inside a standard Safari browser tab, clearing website data can delete local storage.
- The Solution: Add BridgeAAC to your Home Screen (Share → Add to Home Screen). When running as a standalone PWA, iOS treats BridgeAAC as an installed application with protected storage isolated from Safari’s cache clearing.
-
Best Practice: Always make regular backups by tapping Vocab → Export as BridgeAAC (
.bridge) and saving the file to Google Drive, iCloud, or a USB drive.
Yes. BridgeAAC includes native Pointer Dwell support:
- Tap Settings → Access.
- Locate Pointer Dwell and set a time (e.g.,
800 ms). - When the user rests their eye-gaze tracker or head-mouse over a button, a circular countdown timer animates over the cell. When the countdown completes, the button activates automatically without needing a physical click.
-
On iPad: Use Apple’s built-in Guided Access feature. Go to iPad
Settings > Accessibility > Guided Access, turn it on, set a passcode, and triple-click the top button inside BridgeAAC. -
On Android: Use App Pinning. Go to Android
Settings > Security > App Pinning, open BridgeAAC, swipe to recent apps, and tap the pin icon. - Inside BridgeAAC: Go to Settings → Privacy and set a PIN to prevent unauthorized access to Edit Mode or Settings.
BridgeAAC is 100% free and open-source under the MIT License. There are no subscription fees, no locked "pro" features, no in-app purchases, no advertisements, and no tracking. It was built by a 15-year-old developer for his 16-year-old sister who needed an affordable AAC device, and is dedicated to communicators and families everywhere.
- Immediate Family Support Email: Email us directly at support@bridgeaac.org.
- We understand how critical reliable communication is for daily life, school, and emotional regulation. We prioritize family and clinician bug reports and will work to fix issues as quickly as possible.
- GitHub Repository: Visit github.com/bridgeaac/core to submit bug reports, feature requests, or pull requests.
- Clinical & SLP Feedback: We actively seek guidance from Speech-Language Pathologists, educators, and AAC users to improve accessibility, layout fidelity, and clinical efficacy.
- Legal Terms: See our complete Legal & Medical Disclaimer.
BridgeAAC • 100% Free & Open Source AAC • Immediate Family Support: support@bridgeaac.org • Legal & Medical Disclaimer • bridgeaac.org • GitHub (bridgeaac/core)
- File Interoperability & Migration
- Offline Speech & Neural Voices
- Motor Access & Switch Scanning
- Grid Editor & Customization
- Settings & Configuration
-
Life & Learning Hub
- Daily Visual Planner
- Mood Tracker & Analytics
- Skill Games (Sentence & Emotion)
- "About Me" Passport
- Passcode Caregiver Notes
- Caregiver & Classroom Guide
- Privacy, HIPAA & Security
- Languages & RTL Localization
- Architecture & Build Guide
- Legal & Medical Disclaimer
Immediate Family Support
External Links