KindleBrowser-JB

A web browser shell for jailbroken Kindles that adds video playback and Bluetooth audio output, neither of which the stock system browser supports.

Targets Bluetooth-capable models: Paperwhite 4+, Oasis 2+, Scribe, Colorsoft. Video is a low-frame-rate slideshow on the e-ink panel with real-time audio over Bluetooth -- see docs/LIMITATIONS.md for why, and for the firmware-specific bits that need verifying on your device.

This does not implement a new browser engine (that's a multi-year undertaking). It wraps the device's existing system WebKit browser with:

• a local proxy that injects a small script to catch <video> elements the browser can't play, and hands them off to mplayer instead (docs/ARCHITECTURE.md)
• a Bluetooth audio helper built on the same bluetoothd/BlueALSA pipeline Amazon already ships for Audible/VoiceView

Two launch mechanisms are provided since KUAL is no longer available on current jailbreaks:

• Booklet: drop a .sh file into documents/, launch it like a book
• KPM: a package manifest for KPM-based installs

See docs/INSTALL.md to get it on a device, and docs/ARCHITECTURE.md for how the pieces fit together.

Status

Scaffolded and unit-tested (the proxy's HTTP/HTML logic) on a regular machine; not yet verified against real Kindle hardware or firmware. Expect to need at least the browser-proxy-config and browser-launch-intent adjustments called out in docs/LIMITATIONS.md before this actually works end-to-end on your specific device.

Layout

booklet/    "fake book" launcher script
kpm/        KPM package manifest + install/uninstall/run
src/
  launch.sh         orchestrator: start proxy, launch browser, cleanup
  proxy/            HTTP proxy + video-tag injection
  media/            mplayer/BlueALSA wrappers
  lib/              shared shell helpers
docs/       architecture, install, and known-limitations notes
tests/      unit tests for the proxy (runs on any machine, no Kindle needed)

Requirements on-device

• A jailbreak with shell access (usbnet/ssh)
• Python (2.7 or 3.x) for the proxy
• mplayer or ffmpeg, bluetoothctl, and BlueALSA -- either already present in your jailbreak's userland or built for your device yourself; see docs/INSTALL.md

License

MIT, see LICENSE.