Microwriter Chording Keyboard
📄 SiWriter Help (full PDF guide)
Chording basics. SiWriter is a five-pad chord keyboard. Press one or more finger pads together, then release; the character is typed when the last finger lifts. The on-screen code display shows the current chord as dots.
Caps / Nums / Del. Tap Caps or Nums once to shift for the next character, twice to lock. Del removes the last character.
Menu (⚙). Opens settings: Adjust Pads, Help, Edit Text, Toggle L/R Hand, Speech, Position, Background, Articles, New Article, Home Screen, Rotate Pads and Sign Out.
Rotate Pads. Tilt the eight chord pads (1–5 plus Caps / Nums / Del) by any fractional angle so they match the way you naturally hold the device. The text box, Menu, Back, status pills and chord display all stay upright. Pick Menu → 🎯 Rotate Pads, drag the slider or pick a preset, and tap Save. Saves per user. Tap the PDF link above for the full guide.
Adjust Pads mode.
• Choose Menu → Adjust Pads, or just sign in on a new device — the app drops straight into adjust mode when no layout is saved.
• Drag any pad by its body to move it under your fingertip.
• Drag the blue corner (bottom-right of each pad) to resize its width and height independently. Each pad remembers its own size.
• Done saves positions and sizes for the current user.
• Reset reverts to the last saved layout.
• Default clears custom sizes and restores the natural-hand layout for whichever hand (L/R) is active.
Natural-hand defaults. The default layout is not a straight row — it follows the resting shape of a right (or left) hand: middle finger furthest forward, ring & index a little back, little finger shortest, thumb below. Use Menu → Toggle L/R Hand to mirror the whole layout; the choice is remembered per user.
Articles and buffer. Typing is saved into the current dated article automatically. The visible text buffer normally shows only the last sentence. Use Menu → New Article to start a fresh dated article, or Menu → Articles to copy, edit, save, transfer or use existing articles.
Edit Text / Portrait mode. Rotate the device to portrait, or pick Menu → Edit Text, to edit the visible buffer with the OS keyboard. Use the Articles panel to edit the full article.
Text box. Drag the title bar to move it; drag the green corner to resize. The timestamp button stays on the text box; Speak Text and Position are now in the Menu popup.
Saved per user. Document text, pad positions, pad sizes, text-box position, and hand choice are all stored in the browser for the signed-in user.
🅱 Bluetooth Keyboard. SiWriter can drive any computer over Bluetooth by relaying through a small Wi-Fi-and-BLE bridge — either a Raspberry Pi Pico W (firmware in pico_bt_keyboard/), a plain ESP32 (esp32_bt_keyboard/), or an M5StickC Plus (m5stickc_plus_bt_keyboard/). Pair the bridge from your computer's Bluetooth pane (it advertises as SiWriter Keyboard), make sure your phone/tablet and the bridge are on the same Wi-Fi, then turn on Menu → 🅱 Bluetooth Keyboard → Send keystrokes to keyboard. Every chord-typed character — and Del/Enter — appears as a real keystroke on the paired computer.
🖱 Mouse mode (trackpad). The bridge can also act as a Bluetooth mouse. Tick Mouse mode in the Bluetooth Keyboard panel and adjust the sensitivity slider. A floating 🖱 button then appears only when the phone is in portrait orientation — never in landscape, so it can't interfere with chording. Tap 🖱 to open the trackpad overlay: one-finger drag moves the cursor, tap = left-click, two-finger tap = right-click, two-finger drag = scroll. The Click / R-Click buttons at the top of the trackpad also work. Tap Done to return.
Why isn't SiWriter the system keyboard? Apple does not allow web apps (or even most third-party native apps) to replace the on-screen keyboard inside other apps — only Apple-approved keyboard extensions can do that, and those have to be installed as native apps from the App Store. SiWriter therefore lives as a stand-alone writing surface. The good news: everything you chord here can be pasted into any other app. SiWriter copies your text to the system clipboard automatically as you type, so you can switch to Mail, Messages, Notes, WhatsApp, a browser, or any other app and just long-press → Paste. (You can also rotate to portrait and use Edit Text mode if you prefer to copy a selection by hand.)
Install as an app. SiWriter can run full-screen from your device home screen and works offline once installed.
http://<bridge-ip>/ in your browser and the app loads straight from the device. If you're using SiWriter that way, the URL above is already correct — same origin, no CORS issues.