Web Serial flasher

Install firmware over USB

Works from Chrome or Edge on any desktop, no software to install. Today this flashes the devkit bring-up build for an ESP32-S3-DevKitC-1 (N16R8); device firmware will ship here the same way.

  1. ConnectUse a USB-C data cable (many bundled cables are charge-only) into the port labeled USB on the DevKitC.
  2. InstallClick below. When the browser asks for permission, press Allow, pick the serial port for the device, and press Connect.
  3. Watch it bootThe boot log prints on the serial console at 115200 baud.

When you click Install, your browser shows its standard serial-port permission dialog. Every web-based flasher triggers the same dialog, including the chip maker's own. It grants this page access to one USB device that you pick, nothing more, and only until the tab closes. Press Allow and Connect when it asks; that is the whole approval.

Pocket Mushaf firmware
Version: see manifest

Flashing erases the app partitions only; the Quran data pack, fonts, and your reading position live on separate partitions and are untouched by updates.

Verify your download

Everything served here is self-hosted and signed. The checksums file lists the SHA-256 of every firmware file, and its signature proves the list came from the maintainer's key (public key). To check:

  1. Checksumsshasum -a 256 -c checksums.txt next to your downloads.
  2. Signaturessh-keygen -Y verify -f allowed_signers -I release@pocketmushaf -n file -s checksums.txt.sig < checksums.txt using allowed_signers.

Font card restore

The full mushaf font set lives on the device's memory card. If a card is ever lost or corrupted, a downloadable restore image will be provided here once production hardware ships.