NanoMouse · iOS 26

Getting started,
from input to creation

This guide groups each feature with every related entry point, gesture, setting, and real iOS 26 screen. Start with input, then explore AI, sync, documents, and customization.

Real main-app screensReal keyboard extensionNo network required
01

Enable the NanoMouse keyboard

Add the extension in iOS first, then enable the layouts you want inside NanoMouse.

Settings → General → Keyboard → Keyboards → Add New Keyboard → NanoMouse
  1. Add NanoMouse, open any text field, hold the globe key, and select NanoMouse.
  2. Enable Full Access only when a feature needs network access, shared containers, AI, sync, or Byte Paste.
  3. In NanoMouse, open Settings → Keyboard Layout and enable Chinese 26-key, Chinese 9-key, or a custom layout.
NanoMouse input settings in English
Input settings and feature entry points.
NanoMouse keyboard layout settings in English
Enable and manage real keyboard layouts.
02

Chinese 26-key keyboard

QWERTY keys, Pinyin composition, candidates, and tools share one real keyboard.

  • Tap the language key to switch Chinese and English; tap the smiley for Emoji.
  • Hold a letter for accented variants—useful for names and mixed-language input.
  • Save separate light, dark, and per-layout visual schemes in the main app.
Real NanoMouse Chinese 26-key keyboard extension in English
The real extension with toolbar, candidate area, and QWERTY keys.
Real NanoMouse keyboard showing alternate characters after a long press
Hold a letter to reveal alternate characters.
Chinese 26-key light appearance editor in English
Customize background, keycaps, text, and glass effects per layout.
03

Chinese 9-key keyboard

Larger T9-style keys make one-handed Pinyin input easier.

NanoMouse → Settings → Keyboard Layout → Chinese 9-key
  • ABC through WXYZ compose Pinyin; Reset clears the current uncommitted composition.
  • Punctuation, symbols, Space, and Return have dedicated regions.
  • The script/language area supports the same hold and four-direction gestures as the 26-key layout.
Complete Chinese 9-key keyboard preview in English
A complete real 9-key preview, not a schematic keyboard.
04

Toolbar: every tool explained

Scroll the toolbar horizontally, hide items, and reorder them by holding the real preview.

NanoMouse → Settings → Candidate Bar Settings → Toolbar
  • Candidate / Reset: manage composition and return to the normal keyboard state.
  • Cursor arrows: move the insertion point precisely.
  • AI Translation: translate text from the current field and replace it in place.
  • Byte Paste: use pinned text, rich text, images, files, and links.
  • Clipboard: use local history, same-Apple-ID history, and cross-Apple-ID channels.
  • Canvas: open the main app to draw, save, or share.
  • Markdown / HTML: select and preview documents in the keyboard; edit fully in the app.
  • Cipher: encrypt or decrypt with matching algorithms and passphrases.
  • AI Rewrite: adjust length, expertise, tone, emotion, Emoji, and structure.
  • Effects / Voice / Dismiss: change effects, begin dictation, or close the keyboard.
Real NanoMouse keyboard toolbar in English
The scrollable toolbar in the real keyboard extension.
Detailed NanoMouse toolbar settings in English
Reorder the preview and show or hide individual tools.
05

Candidate translation

Translations appear as real candidate rows while you are still composing Pinyin.

NanoMouse → Settings → Candidate Bar Settings → Candidate Translation
  1. Enable the candidate-translation button and prepare the required Apple system language packs.
  2. For AI candidate translation, add source-to-target pairs; each pair shows flags, language names, and direction.
  3. Type Pinyin. When candidates appear, translated rows are available for direct insertion.
Candidate translation settings with real flag icons in English
Real settings page with flag and language direction.
Real keyboard extension showing translated candidate rows
Chinese candidates with English and Japanese translations in the real extension.
06

AI Translation and AI Rewrite

Candidate translation handles words being composed; these tools handle a sentence, paragraph, or the current field.

ToolBest forResult
AI TranslationSentences and paragraphsChoose a target language, preview, then replace or edit
AI RewriteExisting textAdjust six dimensions and return the result in place
Real NanoMouse AI translation panel in English
Translate in place with flag and language labels.
Real NanoMouse AI rewrite panel in English
Combine length, expertise, tone, emotion, Emoji, and structure.
07

123: tap, swipe up, or hold

One key opens three distinct real interfaces.

Tap: symbolsSwipe up: verification rowHold: calculator keypad
Real numbers and symbols keyboard
Tap 123 for the standard symbol page.
Real verification-code number row
Swipe up for fast consecutive verification-code entry.
Real calculator numeric keypad
Hold for a keypad with temporary storage and arithmetic.
NanoMouse keyboard gesture settings in English
Check gesture switches and thresholds if an entry point is unavailable.
08

Delete gestures

Swipe left resets uncommitted composition; swipe up clears readable text before the cursor.

GestureScopeUse
Swipe left on DeletePinyin, codes, and candidates not yet insertedRestart a mistaken composition
Swipe up on DeleteAll preceding text exposed by the host appQuickly clear the readable range
Real composition before swiping left on Delete
Reset this uncommitted composition without deleting inserted text.
Real keyboard demonstrating swipe up on Delete
Confirm the range before clearing preceding text.
09

Emoji: people, symbols, and flags

Open the real Emoji keyboard and use the category strip to browse every group.

  • Recents, smileys and people, animals, food, activities, travel, objects, symbols, and flags are separate categories.
  • Use the bottom icons to switch categories; use Back to return to the previous NanoMouse layout.
  • The screenshots use real rendered system Emoji assets, including regional flags.
Real Emoji smileys and people category
Smileys and people.
Real Emoji symbols category
Symbols.
Real Emoji flags category
Regional flag Emoji—not question-mark placeholders.
10

Four gestures on the script/language area

The area beside Space switches more than Chinese and English.

  • Hold: manually switch Simplified and Traditional Chinese.
  • Swipe up: show temporary clipboard or preceding-text content.
  • Swipe left: contract the keyboard for the left hand.
  • Swipe right: contract the keyboard for the right hand.
Real keyboard after holding the script area
Hold: switch Simplified / Traditional.
Real temporary text row after swiping up
Swipe up: temporary clipboard or context row.
Real left-handed keyboard after swiping left
Swipe left: left-handed layout.
Real right-handed keyboard after swiping right
Swipe right: right-handed layout.
11

Byte Paste: pinned slots and Mac sync

Organize reusable content in the main app and insert it directly from the real keyboard.

  • Slots store plain text, rich text, images, files, and link previews; edit, reorder, and preview them in the main app.
  • The keyboard reads the same slots without leaving the current chat, mail, or editor.
  • With the same Apple ID and iCloud enabled, iPhone, iPad, and Mac merge pinned slots through CloudKit data synchronization.
  • The Periodic Polling switch controls periodic data synchronization only.
Real Byte Paste slots in the iOS app in English
Main app: organize reusable slots and attachments.
Real Byte Paste panel in the keyboard extension
Keyboard extension: insert a slot without leaving the current app.
Byte Paste synchronization settings in English
CloudKit data synchronization, polling, and management settings.
12

Clipboard: local, same Apple ID, and cross-Apple-ID

Clipboard history is separate from pinned Byte Paste slots.

SourcePurposeBoundary
Local historyRecover recently copied textCurrent device and account settings
Same Apple IDContinue history across iPhone, iPad, and MacPrivate CloudKit data synchronization
Cross-Apple-ID channelShare a designated clipboard with another accountInvitation, acceptance, and per-channel disconnect
Real clipboard management in the iOS app in English
Main app: local history and cross-Apple-ID channels.
Real clipboard history in the NanoMouse keyboard
Keyboard: use content copied on iPhone or Mac.
13

Canvas: handwriting, drawing, and sharing

Start from the toolbar and draw in the real PencilKit canvas in the main app.

  • Use pens, markers, erasers, colors, and widths for notes and sketches.
  • Continue editing, export, or share back to a conversation or document.
  • Complex drawing opens the main app because keyboard extensions have strict height, memory, and sandbox limits.
Real NanoMouse PencilKit canvas in English
A real PencilKit canvas, not a static illustration.
14

Markdown and HTML

Edit and render fully in the main app; find and preview documents in the real keyboard.

ToolContentCapabilities
MarkdownNotes, lists, instructionsStructured source, preview, and file saving
HTMLWeb snippets and rich documentsSource editing, live WKWebView rendering, and file preview
Real Markdown editor in the NanoMouse app in English
Main app Markdown editor.
Real Markdown document preview in the keyboard
Choose and preview a Markdown file in the keyboard.
Real HTML editor and preview in English
HTML source and real web preview.
Real HTML document preview in the keyboard
Choose and preview an HTML file in the keyboard.
15

Causal diagrams and mind maps

Use directed relationships for cause and effect, or branches for hierarchical thinking.

  • Causal diagrams connect variables with explicit direction, notes, assumptions, and outcomes.
  • Mind maps support child and sibling nodes, editing, deletion, centering, and saving.
  • Turn voice or text into a visual structure in the main app.
Real causal diagram editor in English
Causal diagram: make influence direction explicit.
Real mind map editor in English
Mind map: branch outward from a central topic.
16

iCloud files across devices

Keep Markdown, HTML, and other documents in iCloud Drive for iPhone, iPad, Mac, and Files.

  • The real system document browser can create folders, move, rename, and select documents.
  • Keyboard Markdown and HTML previews read the corresponding document directory.
  • iCloud Drive documents are a different storage path from CloudKit records used by Byte Paste.
Real iCloud Drive document browser in English
The system document browser shared across Apple devices.
17

Voice: start from the keyboard, recognize in the app

Dictate long sentences or ideas, review the result, and return text to the original flow.

  1. Grant microphone and speech-recognition access on first use.
  2. Tap Voice in the keyboard; the main app opens to record and recognize audio.
  3. Review original dictation and the refined result, then insert, copy, or share.
Real NanoMouse voice dictation screen in English
Permissions, recording, recognition, refinement, and confirmation live in the main app.
18

Telegraph keyboard and cipher system

Telegraph handles Morse input; Cipher transforms ordinary text with agreed settings.

Telegraph

  • Tap for a dot, hold for a dash, and translate Morse from the buffer.
  • Enable Telegraph in input settings and decide whether the cipher system appears there.
  • Morse encoding is not encryption.

Cipher

  • Open Encrypt / Decrypt from Chinese, English, or Telegraph layouts.
  • Both parties need the same algorithm, parameters, and passphrase; never send the passphrase with the ciphertext.
  • This content transformation does not replace end-to-end encrypted communication or account security.
Real NanoMouse Telegraph keyboard
Tap dots, hold dashes, and translate the buffer.
Telegraph keyboard settings in English
Configure Telegraph behavior and cipher access.
Real cipher panel in the keyboard
The real Encrypt / Decrypt panel.
Cipher system settings in English
Choose algorithms, passphrases, and enabled layouts.
19

Appearance, motion, feedback, and icons

Customization combines background, glass, keys, type, effects, sound, haptics, and icons.

  • Light / Dark and per-layout schemes: save separate designs for 26-key, 9-key, and custom layouts.
  • Background and glass: use colors or SVG / PNG art and adjust glass tint.
  • Keycaps and labels: tune fill, border, radius, shadow, font, and pressed state.
  • Motion effects: select family, move, position, intensity, layering, and random playback.
  • Feedback and icons: configure sound, volume, haptics, app icon, and toolbar icon.
  • Import / Export: back up and move visual schemes as JSON.
Detailed visual effects settings in English
Background, glass, keycaps, type, and layout schemes.
Detailed dynamic effects settings in English
Effect family, move, intensity, layers, and playback.
Keyboard sound and haptic feedback settings in English
Key sound, volume, and haptics.
App and toolbar icon settings in English
Personalize the main-app and toolbar icons.
Real dark Chinese 26-key appearance preview
Dark 26-key schemes are saved separately from light schemes.
20

AI subscription, account, and BYOK

Use the built-in account for simple setup, or Bring Your Own Key for provider control.

MethodBehaviorBest for
AI subscription / accountSign in and use supported translation and rewrite features under a planReady-to-use setup
BYOKConfigure provider, key, model, and request parameters; billing belongs to that providerUsers with their own model account
Apple system translationUses system language resources and is separate from the AI subscriptionCandidate and offline-language scenarios
NanoMouse AI account and subscription settings in English
AI account, plan, and usage status.
NanoMouse BYOK provider settings in English
Manage provider, model, key, and request configuration.
21

Privacy, permissions, and sync boundaries

Each feature has its own data path and should be diagnosed independently.

  • Full Access controls network, shared-container, and extension features; basic input should remain available without it.
  • Same-Apple-ID Byte Paste and clipboard records use private CloudKit data synchronization; cross-Apple-ID clipboard uses invitation-controlled channels.
  • CloudKit data-change subscriptions signal record changes and drive change-token download, merge, and UI publication.
  • APNs user notifications are user-visible notification content, authorization, environment, and delivery. They do not explain Byte Paste or clipboard synchronization faults.
  • iCloud Drive files, CloudKit records, AI requests, and microphone audio are separate data paths.
22

Frequently asked questions

Match a symptom to the right setting or system boundary.

Why is a tool missing from the toolbar?

Open Candidate Bar Settings, confirm Toolbar is enabled and the item is visible, then scroll farther right or hold the real toolbar preview to reorder it.

Why are flags or language directions missing?

Re-add the pair in Candidate Translation. Each row should show flags, language names, and direction; screenshots use rendered system Emoji assets.

What is the difference between Byte Paste and Clipboard?

Byte Paste is intentionally pinned and organized for long-term reuse. Clipboard is recent copied history. Both work in the app and real keyboard and can cooperate with Mac, but their data meaning and controls differ.

Does cross-Apple-ID clipboard share all my private slots?

No. Private same-account slots remain separate. Cross-account clipboard uses an explicit relationship and channel that can be disconnected independently.

Why does Voice open the main app?

That is an iOS third-party-keyboard boundary. The main app owns microphone permission, recording, and recognition.

How do I reset an unreadable appearance?

Open Keyboard Visual Effects, choose the matching light/dark mode and layout, and restore defaults. Reset dynamic effects and feedback separately.