Skip to content

tech-master33/baosp-screenreader

baosp-screenreader

Android CI — baosp-screenreader

An Android screen reader and TTS management application, built as part of the BAOSP project.

Download

Latest APK → github.com/tech-master33/baosp/releases/tag/nightly

A fresh build is posted there automatically every night alongside the TTS engine and launcher. You can also find standalone builds on the releases page of this repo.

Features

  • Screen Reader Service (AccessibilityService)
  • TTS (Text-to-Speech) Management
  • Braille display output via Bluetooth SPP
  • Braille keyboard input (dot pattern decoding)
  • Works out of the box with aoler — the BAOSP accessible home screen launcher

Installing on your device

  1. Download the APK from the nightly link above
  2. Transfer it to your Android device
  3. Install it — allow "unknown sources" if prompted
  4. Go to Settings → Accessibility → Downloaded services → baosp-screenreader and enable it

For the best experience, also install aoler (the BAOSP launcher) and baosp-tts (the TTS engine) from the same nightly bundle.

Building locally

git clone https://github.com/tech-master33/baosp-screenreader.git
cd baosp-screenreader
chmod +x gradlew
./gradlew assembleDebug
# APK will be at: app/build/outputs/apk/debug/app-debug.apk

Requires JDK 17 and Android SDK with API level 34.

CI/CD

Every push to main automatically builds a new APK and posts it as a GitHub Release. The badge above shows whether the latest build passed or failed.

Repository structure

baosp-screenreader/
├── .github/
│   └── workflows/
│       └── android.yml          ← CI build + auto-release on push
├── app/
│   └── src/main/
│       ├── java/com/example/andrd/
│       │   ├── ScreenReaderService.kt       ← Main accessibility service
│       │   ├── TtsManager.kt                ← TTS engine wrapper
│       │   ├── MainActivity.kt              ← Settings launcher
│       │   └── braille/
│       │       ├── BrailleDisplayManager.kt ← Bluetooth SPP output
│       │       ├── BrailleTranslator.kt     ← Text → Braille cell encoding
│       │       ├── BrailleInputDecoder.kt   ← Dot pattern → character
│       │       └── BrailleInputHandler.kt   ← Braille input → accessibility action
│       └── AndroidManifest.xml
└── build.gradle.kts

BAOSP Ecosystem

baosp-screenreader is one of four repos that make up BAOSP — an accessible Android platform for blind and visually impaired users:

Repo What it does
baosp Main project — nightly bundle, AOSP patches, release coordination
baosp-screenreader Screen reader (this repo)
baosp-tts SVOX Pico TTS engine — speech output
aoler Accessible home screen launcher

All four APKs are bundled together and published every night at
github.com/tech-master33/baosp/releases/tag/nightly

License

Apache License 2.0 — same as BAOSP and AOSP.

About

BAOSP Screen Reader — accessible Android screen reader with Braille display support, part of the BAOSP ecosystem

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors