Help & Documentation

1. Overview

Kexu Learning is a tool built for video-based study: import a local video or pick one from Photos, add bookmarks at key moments, capture key frames, extract clips, and write these learning materials directly into notes.

The system keeps timestamps automatically, so tapping a bookmark or screenshot jumps back to the matching video position — great for review and organizing study notes.

You can also simply use it as a plain video player with basic playback controls and progress seeking.

• Import study videos: import MP4, MOV and other formats from Files or Photos.
• Add time bookmarks: bookmark key moments and mark them General, Important, Question or Summary.
• Capture key frames: capture the current frame with one tap, or batch-extract multiple key frames as images.
• Extract video clips: pick start/end times to extract a clip into the project, as a short video or a Live Photo.
• Write into notes: write bookmarks, screenshots and clips into Kexu Notes with time positions you can tap to jump back.
• 2. Quick start & view modes
• One-minute start: enter Video Learning → on first launch the empty state shows "Import Video" → pick a video in the file picker (or from Photos) → it autoplays once loaded → pause at a spot you want and tap the bottom "Bookmark" → choose a type (e.g. Important) and confirm → tap the "Bookmark" tab in the right sidebar to see bookmarks → tap an item to jump back to that position.

Default mode: the video fills the main screen with a control bar at the bottom and a sidebar (bookmarks/notes) on the right — good for watching while noting.

Fullscreen mode: the video fills the whole screen and the control bar and sidebar auto-hide — good for focused viewing. Toggle by double-tapping the video or tapping the fullscreen button in the control bar.

Bookmark: marks a time position; four types (General, Important, Question, Summary); stored in the project database and can be written to notes.

Screenshot: captures the current frame as an image stored in the project's "video screenshots" folder.

• Clip: extracts a time range as a standalone short video or Live Photo, stored in the "video clips" or "live photos" folder.
• 3. Playback controls & buttons
• Playback control bar (bottom): play/pause (big center button), back 10s (left), forward 10s (right), progress bar (drag to seek, shows current time and duration), Bookmark (add a time bookmark), Screenshot (capture the frame), Clip (extract a clip, after picking start/end), Speed (0.5x/0.75x/1.0x/1.25x/1.5x/2.0x), and More (more actions).

Sidebar (right): the Bookmark tab lists all bookmarks of the current video and taps jump to the position; the Notes tab lists linked notes for quick switching or creating.

More menu: batch screenshots, extract clip, write to note, floating playback, fullscreen, import a new video (replaces the current one), and delete video (irrecoverable).

Playback speed: six speeds. 0.5x suits difficult points or shadowing; 0.75x fine study; 1.0x normal (default); 1.25x review of familiar content; 1.5x browsing learned content; 2.0x quick searching. Tap the "Speed" button to choose; the current speed is highlighted. The setting applies immediately, the system remembers the last speed for next playback, and speed does not affect extracted clips (they stay at original speed).

Progress display: current position / total duration. Short videos (<1h) use MM:SS; long videos (≥1h) use HH:MM:SS. Red dots on the bar mark bookmark positions; played parts are highlighted, unplayed parts are translucent.

Fullscreen behavior: the sidebar auto-hides, controls hide after 3s, tap anywhere to show them, status and navigation bars hide, and screen orientation locks to prevent accidental rotation.

4. Import & video management

Supported formats: MP4, MOV, M4V, AVI (partial codecs), MKV (partial codecs). MP4 (H.264) is recommended for best compatibility.

Import from Files: tap "Import Video" on the main screen → browse in the system file picker → choose one video → the system copies the file to the project directory and loads it.

Import from Photos: tap "Pick from Photos" → browse videos in the system album → choose one → the system reads it and starts playback.

Import rules: only one video per import (no batch); importing a new video replaces the current one; the old video's bookmarks and screenshots stay in the project; the video is copied into the project directory (the original file is untouched).

Storage layout: the project directory holds the main video, screenshots/, video_clips/, live_photos/ and related folders.

Replace video: More menu → Import New Video → choose a new file. After replacing, the old video file is deleted, the bookmark list clears (bookmarks link to the old video), screenshots and clips remain (they are separate files), and playback starts at the beginning of the new video.

Delete video: More menu → Delete Video → confirm. The main video is deleted, bookmarks clear, screenshots and clips remain, and you return to the empty state. Deletion is irreversible; bookmarks, screenshots and clips already written to notes are unaffected; export the project first if you want to keep the video.

Video info: the system reads file name, resolution, duration, file size, codec and frame rate. Aspect ratio handling: 16:9 landscape fills the area, 9:16 portrait centers with side bars, and 1:1 square centers.

5. Bookmarks

Bookmark types: General (grey — ordinary markers like chapter starts or transitions), Important (red — key content like core points or conclusions), Question (yellow — things you do not understand, to check or ask about later), Summary (blue — summary content like chapter summaries or reviews).

Add a bookmark: pause at the spot → tap the bottom "Bookmark" → choose a type (General/Important/Question/Summary) → confirm. Each bookmark has a time position (seconds), formatted time (HH:MM:SS), a type (icon and color) and a creation time.

View bookmarks: tap the "Bookmark" tab in the right sidebar; bookmarks are ordered by time (earliest first) and show type icon, formatted time and creation time. When empty, "No bookmarks" is shown.

Jump to a bookmark: tap any bookmark in the list and the video jumps to that time and starts playing. Jumping does not affect other bookmarks, and you can revisit the same one repeatedly.

Delete bookmarks: swipe left on an item in the list and tap delete. Batch deletion is not supported in this version; to clear all, delete them one by one or replace the video (which clears all). Deleting does not affect playback or bookmarks already in notes, and it is irreversible.

Write a bookmark to notes: switch to the "Notes" tab → select a target note (or create one) → tap a bookmark item → choose "Write to Note". It is written as a time label such as [05:30] Important · this is a knowledge point, and you can add your own notes after it.

Tap the time label: tapping a label (e.g. [05:30]) in a note opens Video Learning, loads the video and jumps to that position. The label only jumps if the video file exists; if the video was deleted, a "video file missing" message appears.

6. Screenshots

Capture the current frame: pause or play to the target frame → tap the bottom "Screenshot" → the system captures and saves it as an image with a "screenshot saved" notice. Resolution matches the video, format is JPG, the name includes a timestamp (e.g. screenshot_00-05-30.jpg), and it is stored in the project's "video screenshots" folder.

Batch-extract key frames: More menu → Batch Screenshot. Three methods: one frame per second (extract every second from start to end — quick browsing), custom interval (set seconds like 5s or 10s — control density), and manual selection (add time points by hand — precise key frames).

Manual selection: choose Manual mode → play or drag to the target frame → tap "Add" to add the current time point → repeat to add more → tap "Start" to extract them. The list shows all added points (HH:MM:SS), swipe left to remove one, and any number is allowed.

View screenshots: Archive → the project → the "video screenshots" folder, shown as a grid; tap one for a large view with its time position, zoom and share.

Export and share screenshots: open a screenshot detail in Archive and tap share (AirDrop, Messages, Save to Photos, etc.); to batch export, enter selection mode, check screenshots, tap export and choose a location.

Write screenshots to notes: long-press a screenshot in Archive → "Write to Note" → choose a target note. It appears as an image card with a thumbnail and a time label (e.g. [05:30]); tapping the label jumps back to the video position and tapping the image shows it large.

Delete screenshots: single — long-press in Archive and choose "Delete"; batch — enter delete mode, check and delete. Deleting does not affect the video or screenshots already in notes, and it is irreversible.

7. Video clip extraction

Extract a clip: More menu → Extract Clip. Pick start/end times by dragging the start and end sliders or using playback controls to position precisely; the system shows the clip duration in real time. Preview the clip to make sure the selection is right.

Clip types: video clip (standard MP4 short video, no duration limit, iOS/iPad) and Live Photo (a photo with 3 seconds of motion, max 3 seconds, iOS only).

Clip rules: minimum 0.5 seconds, no maximum (5 minutes recommended); a Live Photo is fixed at 3 seconds or less. Quality: resolution matches the original, H.264 encoding, quality 0.8 (high). Naming: clip_start_end.mp4 (e.g. clip_00-05-30_00-05-45.mp4).

Live Photos: an iOS-specific format with a 3-second video that shows as a motion photo in the album (long-press to play). To create one, choose the Live Photo type, pick a clip of 3 seconds or less, and tap "Extract"; the system generates HEIC and MOV files. iOS only; iPad can create but with limited display; Android cannot.

View and manage clips: Archive → the project → the "video clips" or "live photos" folder, shown as a grid; tap a thumbnail to play in the built-in player with fullscreen, speed and progress controls.

Export and share clips: open a clip detail in Archive and tap share, or long-press a clip and choose "Save to Photos". Video clips save as MP4 and Live Photos as Live Photos (iOS only), preserving original quality.

Write clips to notes: long-press a clip in Archive → "Write to Note" → choose a target note. It appears as a video card with thumbnail and duration, a start/end label (e.g. [05:30 - 05:45]), a play button inside the note, and a label that jumps back to the main video position.

Delete clips: single — long-press in Archive and choose "Delete"; batch — enter delete mode, check and delete. Deleting does not affect the main video or clips already in notes, and it is irreversible.

8. Note integration & writing

Select a linked note: tap the "Notes" tab in the sidebar to see the project's notes and tap one to select it; or tap "New Note" in the list, type a name, and it is created and auto-selected.

Write bookmarks: long-press a bookmark in the list → "Write to Note" → it is written to the selected note as [05:30] Important (time label + type), where you can add your own notes and tap the label to jump back.

Write screenshots: long-press a screenshot in Archive and write it to a note as an image card with a thumbnail and timestamp, expandable to a large view.

Write clips: long-press a clip in Archive and write it to a note as a video card with thumbnail and duration, a play button for in-note playback, and fullscreen support.

Organizing learning content in a note: use headings for chapters, bookmarks to mark key spots, screenshots to keep key frames, and clips to keep important passages, then add your own notes and understanding after each.

Jumping back from a note: tap a time label (e.g. [05:30]) in the note; the system checks whether the video exists, opens Video Learning and jumps to the position if it does, or shows "video file missing" if not. Supported formats: a single point [05:30] and a range [05:30 - 05:45] (clip), recognized and jumped to automatically.

9. Floating playback

In-app floating: More menu → Floating Playback → In-App Floating. The video shrinks to a floating window you can drag, pinch to resize, drag to the screen edge to collapse to an icon (tap to restore), and close with the close button.

While floating you can: edit content in notes, view and add bookmarks, switch projects, and use other Kexu features.

While floating you cannot: add video bookmarks (return to the main video screen), extract clips, or batch screenshots.

System Picture-in-Picture (PiP): More menu → Floating Playback → System PiP. The system starts PiP so you can switch to other apps or the desktop and keep watching; drag the PiP window to move it and tap it to return to Kexu.

Requirements: iOS 14.0 or later; iPad supports full PiP; iPhone only on PiP-capable devices. Limits: the PiP window is system-controlled (no custom size), some video codecs do not support PiP, and in PiP you can only control play/pause and progress.

10. Storage, backup & migration

Storage layout: the project directory holds main_video.mp4, screenshots/, video_clips/, live_photos/ and .kexu_learning/ (metadata including bookmarks.json).

Bookmark data: stored in .kexu_learning/bookmarks.json in JSON format; each record has id, positionSeconds, formattedTime, category and createdAt.

Full project backup: Archive → the project → tap "Export Project" → choose a location. The export includes the main video, all screenshots, all clips, all Live Photos, bookmark data and note files.

Restore a project: in Archive tap "Import Project" → choose the exported project file → the system unpacks and restores everything. Restoring overwrites same-name projects; bookmarks link back to the video, and time labels in notes automatically link to the restored video.

Migrate to a new device: export the project on the old device → transfer via iCloud, AirDrop or another method → import it on the new device. Videos are large, so prefer a wired transfer or a stable network; Live Photos may look different across devices; bookmark data migrates with it.

Storage space management: view project size stats in Archive. Space is mostly used by the main video (usually 100MB to a few GB), clips, screenshots (a few hundred KB each) and Live Photos (10–20 MB each). Reduce it by deleting unneeded clips, removing duplicate screenshots, exporting to Photos then deleting in-project files, and using lower-resolution videos.

11. Shortcuts & device support

iPad external-keyboard shortcuts: Space play/pause; ← back 10s; → forward 10s; ↑ volume up; ↓ volume down; F toggle fullscreen; Esc exit fullscreen; B add bookmark; S capture frame; 0-9 jump to 0%–90%. iPhone does not support external-keyboard shortcuts.

Supported devices: iPhone (iOS 14.0+), iPad (iPadOS 14.0+). Recommended: iOS 16.0+, at least 5GB free storage, and an A12 or newer chip for smooth 1080p playback.

Landscape support: Kexu Learning fully supports landscape; on iPad the video area is larger in landscape, and iPhone can watch fullscreen video in landscape.

Multi-language: the UI follows the app language (Simplified/Traditional Chinese, English and more); bookmark type names are translated automatically.

Privacy: all video files stay in the local project directory, bookmark data stays on the device, and screenshots and clips are never uploaded. Extraction happens locally and no video content is collected or analyzed.

Performance tips: recommended 1080p, 30fps, H.264, 5–10 Mbps bitrate, AAC 128 kbps audio; close background apps, use wired headphones, avoid 4K, restart the device, and update the OS for smoother playback.

12. Troubleshooting

Video will not play: possible causes are unsupported format/codec, a corrupt file, or a file that is too large. Fix: convert to MP4 H.264, confirm the file is intact, or try a smaller video.

Bookmarks do not jump: the video file may have been deleted, moved or replaced, or bookmark data is corrupt. Fix: confirm the main video exists, re-add bookmarks after replacing, or re-import the video.

Black screenshots: the player may not be initialized, the video is buffering, or it is DRM-protected. Fix: wait for full loading, pause to stabilize the frame; protected videos cannot be captured.

Clip extraction fails: not enough storage, invalid start/end times (start later than end), or an unsupported codec. Fix: check storage, ensure start is before end, or convert the codec and re-import.

Live Photos cannot be created: the device is not iOS, the clip exceeds 3 seconds, or the OS is too old. Fix: use iOS, keep clips under 3 seconds, and update to iOS 14.0 or later.

Floating playback unavailable: in-app floating has no special requirements; system PiP needs iOS 14.0+ and some codecs do not support it. Prefer in-app floating.

No sound at high speed: the audio session may be occupied, the mute switch is on, or the codec does not support rate change. Fix: check mute, close other audio apps; some codecs may be silent at high speed.

Time labels in notes do not respond: the note may be in edit state, the format is wrong, or the video was deleted. Fix: exit edit state (save with the check mark), use [HH:MM:SS], and confirm the main video exists.

Bookmarks remaining after deleting the video is normal: bookmark data is stored separately from the video, deleting the video does not clear bookmark records, and bookmarks already in notes are kept.

Playback progress: this version does not auto-save progress, so the video starts from the beginning each time; use bookmarks to jump quickly to important spots.

It is normal for bookmarks to remain after deleting a video: bookmark data is stored independently of the video file, so deleting a video will not automatically remove bookmark records, and bookmarks that have been written into notes will also be retained.

Progress memory: The current version does not automatically save playback progress, so every time you open a video, it starts from the beginning; use bookmarks to mark important positions for quick jumps.

1. Overview

Kexu Transcription is built for audio recording workflows: import meeting recordings, lecture audio or other audio files, or record directly in-app. While playing you can extract key clips, convert audio to text, take text notes, and jump back to the original position via timestamps.

You can also simply use it as an audio player with a waveform. Advanced features like clip extraction and audio-to-text are available when you need them, so you do not have to learn everything at once.

One-minute start: create a project → import audio (load audio or record locally) → play → take notes → extract clips → transcribe, and a full transcription workflow is done.

• Import or record audio: import local audio (MP3, M4A, AAC, WAV, FLAC, OGG) or record directly in-app.
• Take notes while listening: write notes while playing and return to the matching audio position via time marks.
• Extract audio clips: capture key passages, save them to the project folder, and insert them into notes as audio-card index entries.
• Audio-to-text: choose an audio range and language, convert to text and insert it into notes, in whole-passage or per-minute-segment mode.
• Quick listen-back: use the waveform, progress bar and timestamps to jump to key audio positions.
• Structured output: combine with Kexu Notes' heading outline, media index and rich-text parsing to produce documents you can view and export long-term.

2. Layout & common buttons

The main screen has three areas: the audio player (left — waveform, playback controls, progress bar and audio info), the note editor (right — text, index and media cards), and a sidebar (left — expandable, with local audio info and audio-tool shortcuts).

The player always shows the current main audio; the note editor shares the same editor as Kexu Notes; the sidebar is collapsed by default and expands via the top-left icon.

Top bar: Back (save and return Home), + Add (import audio or start recording), the sidebar icon (expand/collapse), and "⋯" (delete main audio, new project, etc.).

Playback controls: play/pause, back 10s, forward 10s, speed (0.5x–2.0x), and a progress bar (drag to seek).

Audio toolbar (sidebar): Audio Clip (extract a clip into the note) and Audio-to-Text (convert audio to text into the note).

The note editing toolbar is shared with Kexu Notes; see the Kexu Notes manual for details.

3. Importing audio

Supported formats: MP3 (most common, best compatibility), M4A (common on Apple devices), AAC (high-quality compression), WAV (lossless), FLAC (lossless compression), OGG (open format). MP3 or M4A are recommended.

To import: tap + Add at the top left → choose "Load Audio" → pick a file in the file manager → the system loads it and extracts the waveform → the audio is ready to play.

Each project has one main audio; importing a new one replaces the old and resets the project folder; a confirmation prompt appears before replacing; the audio is copied into the project folder, leaving the original untouched.

Delete main audio: tap "⋯" in the top bar → "Delete Main Audio" → confirm, and the main audio is deleted and the project folder resets to blank. Note: this also deletes all audio clips and transcription records, but note content is kept.

4. Local recording

To record: tap + Add → "Record Locally" → on first use the system asks for microphone permission → recording starts automatically and shows a live duration and amplitude waveform.

Recording controls: Pause (keep what was recorded), Resume (continue from the pause), Finish & Save (stop and save as the main audio), and Cancel (discard without saving). You can resume after pausing without creating a new file.

Recording states: Recording, Paused, Saving…, Save failed (retry or discard), Too short (under 1 second, auto-discarded), and No space (cannot start). For long recordings the system suggests "recording is long, you can finish and save".

Recording parameters: AAC-LC encoding, 44100 Hz sample rate, mono, 128 kbps — a balance of quality and file size that suits most meetings and lectures.

Permission: recording needs the microphone. If refused, a dialog explains and guides you to system settings. iOS: Settings → Kexu → Microphone; Android: Settings → Apps → Kexu → Permissions → Microphone.

Recording tips: an external mic improves quality; keep 30–50 cm from the speaker; avoid noisy environments; test volume to avoid clipping; ensure battery before long recordings.

5. Playback & navigation

Basic controls: tap play to start (the button becomes a pause icon); tap "back 10s" or "forward 10s" to seek, and playback resumes automatically after seeking.

Playback speed: 0.5x–2.0x. 0.5x for fast speech or complex terms; 0.75x for accuracy (good for language learning); 1.0x normal; 1.25x for efficiency; 1.5x to skim and skip; 2.0x for extremely fast scanning. Tap the "Speed" button to choose and the audio plays immediately at the new speed. Pitch is unchanged, and the speed setting persists in the current project.

Drag the progress bar: hold the slider and drag to the target; the current time shows while dragging and playback resumes on release.

Tap the waveform: tap anywhere on the waveform to jump to that time and continue playing.

The waveform is extracted automatically when audio loads. It visualizes content (spot silent vs. loud sections by amplitude), enables quick positioning (tap to jump), and helps precise clip extraction (with time marks).

If waveform loading fails, a "cannot load waveform" message appears, but playback and seeking still work; re-importing may fix it.

iPad external-keyboard shortcuts: Space play/pause; ← back 10s; → forward 10s; ⌘+Z undo; ⌘+Shift+Z redo; ⌘+S save and exit edit; ⌘+N new note.

6. Extracting audio clips

An audio clip is a continuous segment cut from the main audio — useful for grabbing a discussion, keeping a key argument from a lecture, pulling an important interview answer, or saving a highlight from a live event.

To extract: play to the target passage → tap "Audio Clip" in the sidebar → set the start and end times → confirm the range → the system shows progress, extracts and saves the clip → it is inserted into the note as an audio card.

Setting times: use the time wheel (separate hour/minute/second wheels — precise to the second) or the timeline sliders (drag start/end to select a range quickly; the audio jumps as you drag). Combine them: use the sliders to find the general range, then the wheel to fine-tune.

The audio card shows the time range (e.g. "01:23-02:45"), a play button, the clip waveform (if available) and the duration. Tapping its time mark jumps to that position in the main audio.

Clips are saved as standalone AAC files in the project's "audio clips" subfolder and appear under the "Audio" tab of the note index.

To view clips: see the cards in the note editor; or open "⋯" → Index → Audio tab to list and jump to all clips; or in Archive switch to the "audio clips" tab to see the files and play, export or delete them.

Extraction can fail if the start/end times are invalid (end must be after start), storage is low, the audio file is corrupt, or the project folder has permission issues.

7. Audio-to-text transcription

Audio-to-text converts speech in the audio into text — handy for meeting minutes, turning lectures into text notes, extracting interview transcripts, or keeping a text version of a voice memo.

Results are automatically inserted into the note editor, keep sentence and paragraph structure, add punctuation per language rules, and can be output whole or per minute.

Supported languages (9): Chinese (zh-CN), English (en-US), Japanese (ja-JP), Korean (ko-KR), German (de-DE), French (fr-FR), Vietnamese (vi-VN), Hindi (hi-IN) and Russian (ru-RU). Default is Chinese. Accuracy depends on audio clarity, speed and accent; for mixed-language audio, transcribe in segments choosing the main language each time.

To transcribe: play to the target passage → tap "Audio-to-Text" in the sidebar → choose the language (default Chinese) → choose segment type (whole or per minute) → set the start/end times → confirm → watch progress (0%–100%) → the text is inserted automatically.

Whole mode: all speech in the range becomes one continuous passage. No time marks, suited to short audio (under 5 minutes), easy to copy and re-edit.

Per-minute mode: the audio is split by minute, each part recognized separately with a timestamp (e.g. "00:00", "01:00"). Tapping a timestamp jumps to that position; suits longer audio (over 5 minutes) and is easy to locate and re-listen to.

Duration limit: 30 minutes per transcription. If the range exceeds 30 minutes, the end time is adjusted automatically with a "single transcription is up to 30 minutes" message; split long audio into multiple runs.

Progress and streaming: short audio (<1 min) shows progress and inserts the text all at once (you continue after the bar closes); long audio (>1 min) writes incrementally — about a minute of text is inserted as soon as it is recognized, so you see text appear section by section with less waiting.

Permission: transcription needs speech-recognition permission on iOS. If refused, a dialog explains and guides you to system settings. iOS: Settings → Kexu → Speech Recognition; Android needs no extra permission.

8. Notes & organization

The note editor is shared with Kexu Notes and supports: four-level headings (auto outline), text formats (bold, italic, underline, strikethrough, size, alignment, color), inserting media (images, video, audio, documents, external assets), rich-text parsing (paste auto-detects headings, lists, tables, formulas, code and URLs), index jumping (outline/images/video/audio), and undo/redo.

Timestamps are clickable texts marking audio positions, e.g. "00:00" or "01:23". They come from per-minute transcription (auto) or manual entry (typing a time-format string in the note).

To jump, tap a timestamp (e.g. "01:23") in the note and the audio seeks there and plays — a quick way to re-listen to key moments.

Structuring with headings: for meetings use Level 1 for topics and Level 2 for speakers; for lectures Level 1 for chapters and Level 2 for sections; for interviews Level 1 for topics and Level 2 for Q&A. Steps: type text, place the cursor in a heading paragraph, tap the bottom "Body" button, choose a level, numbers are added automatically, then "⋯" → Index → Outline to jump.

Transcribed text is fully editable — just like ordinary text, you can change content, formats, heading levels, and cut/copy/paste/delete.

Transcription tips: split long audio into runs under 30 minutes; choosing the right language greatly improves accuracy; use per-minute mode for later locating; proofread after transcription; keep the original audio for cross-checking.

9. Export, backup & data management

Project structure: each project is an independent folder with the main audio (e.g. audio.m4a), an audio clips folder (AudioClips/), notes (Notes/) and a material library (MaterialLibrary/).

Export notes: tap "⋯" in the note editor and choose Export as PDF (reading/printing), Export as DOCX (further editing), or Scroll Screenshot (long image). The file is generated and shared via the system sheet. Note: audio cards appear as time-range text; the audio files are not embedded in exported files.

Export the whole project: Home → Archive → the project → "⋯" on the right → Export → choose the format (ZIP), and everything in the project folder is packed and exported.

Delete a project: Home → Archive → the project → "⋯" → Delete → confirm, and the folder and all contents are removed. Deletion is irreversible — be careful.

Data tips: regularly remove unneeded clips; back up important projects; never manually modify the project folder; confirm exports before deleting a project; keep storage available.

Offline use: playback, recording and clip extraction are fully offline; audio-to-text needs a network (cloud speech recognition) — use it on a good connection.

10. Troubleshooting & limits

Cannot import audio: an unsupported format, a corrupt/incomplete file, low storage, or special characters in the path. Fix: convert to MP3 or M4A, re-download/export, free storage, or rename the file.

Waveform fails to load: the file is too large (over 500 MB), the format does not support waveform extraction, or memory is low. Playback and seeking still work without the waveform; re-importing may help.

Recording fails: no microphone permission, low storage, the mic is used by another app, or the OS is too old. Fix: enable the mic, keep at least 500 MB free, close other mic apps, and update the OS.

Recording length: there is no hard limit, but keep single recordings under 2 hours, ensure storage, and avoid switching apps while recording.

Transcription fails: no speech-recognition permission (iOS), a mismatched language, low clarity or high background noise, over 30 minutes in one run, or no recognizable speech.

Accuracy depends on clarity, speech rate (150–200 chars/min is best), accent, background noise and jargon. Improve it with a good recorder, a quiet environment, clear moderate-speed speech, and manual proofreading.

Audio cards will not play: the clip file was deleted or moved, the project folder is corrupt, or permissions are off. Fix: check Archive for the clip, re-extract if missing, and do not modify the project folder manually.

Tapping a timestamp does not jump: the main audio is not loaded, the format is wrong (use "00:00" / "01:23"), or the timestamp exceeds the total duration.

Deleting the main audio does not delete notes: the audio file is removed, the clip folder clears, but note content (text and audio cards) stays — though cards cannot play because the file is gone. Export the project first if you want to keep clips.

You cannot extract multiple clips at once, but you can chain them: extract one, wait for it to insert, then start the next. Each clip is saved independently.

11. Recognition engine & device requirements

Recognition engines: iOS uses Apple's native Speech Framework; Android uses the open-source WeNet engine.

Recognition traits: local-first (prefers on-device models), cloud-assisted (complex content may call the cloud), streaming output (long audio outputs as it recognizes, iOS), and automatic punctuation per language rules.

Privacy: audio data is used only for recognition and is not uploaded to Kexu servers; on iOS recognition is handled by Apple per its privacy policy; on Android it runs locally without a network (WeNet mode).

Minimums: iOS 14.0+, Android 8.0+, at least 500 MB free, 2 GB+ RAM recommended. Recommended: iOS 15.0+ on an iPhone 11 or newer, Android 11.0+ with 8 GB RAM, and 2 GB+ free.

Performance: long audio (>1 hour) takes longer to load; waveform extraction can take seconds to tens of seconds depending on length; transcription runs at about 1/3 real time (3 minutes of audio ≈ 1 minute to recognize); use Wi-Fi for audio-to-text.

1. Overview

Kexu Mind Board is an infinite-canvas tool: place text and image cards, move, scale and connect them freely, and organize information visually as you think through and structure ideas.

The canvas zooms and pans, holds a lot of content, and can be exported as an image or recorded as a narrated video. The canvas autosaves so you can keep editing anytime; exported images and recorded videos are kept in Archive.

Three-minute start: enter Mind Board → tap a blank spot and choose "Create Text Card" → type text and tap "Done" → the card appears → create more cards → long-press one card and drag it near another, then release to form a connector → pinch and pan to view the whole canvas → tap "⋯" at the top right → Export as Image → view it in Archive.

• Create text cards: type text to record ideas and key information.
• Add image cards: upload photos from Photos, or reference assets from the Shared Library.
• Connect cards: use connector lines to express relationships between cards.
• Free layout: drag cards anywhere and zoom the canvas for an overview or details.
• Snap to grid: drag and it aligns to the grid automatically to keep layouts tidy.
• Export images: export the canvas as a PNG image.
• Record video: narrate while moving the canvas to record a video with voiceover.
• Note conversion: convert Kexu Notes content into Mind Board cards.
• Summarize notes: export the text cards on the canvas as a text file.
• Undo & redo: multi-step undo and redo.

2. Concepts & common buttons

Three core concepts: infinite canvas (an endlessly extendable editing area with zoom and pan), cards (content units — text cards and image cards), and connectors (lines joining two cards to express relationships and logic).

Top bar: Back (return Home; the canvas autosaves), Undo (undo the last action), Redo (restore the last undone action), and "⋯" (the features menu).

More menu: Create Text Card, Upload from Photos, Load from Shared Library, Note Conversion, Summarize Notes, Export as Image, Record Video, and Fit to Window (auto-zoom so all content is visible).

Relations to other modules: Mind Board (canvas, cards, connectors, export, recording); Notes (provides content for note conversion into cards); Archive (view, export and delete exported images and recorded videos); Profile → Shared Library (manage image assets reused across projects).

3. Creating text & image cards

Create a text card (via the menu): tap "⋯" at the top right → Create Text Card → type text → tap "Done" → the card appears at the canvas center.

Create a text card (via the canvas): tap a blank spot → choose "Create Text Card" in the pop-up → type text → tap "Done".

Text-card rules: up to 60 cards per canvas; text cards support multiple lines; they auto-size to fit their content; blank text cards are not created.

Add image cards (upload from Photos): "⋯" → Upload from Photos → pick photos → they are arranged on the canvas automatically. Rules: up to 60 photos at once; photos are laid out on a grid automatically; uploaded photos are stored in the project folder; you can reposition them after.

Add image cards (load from the Shared Library): "⋯" → Load from Shared Library → choose images → they are added as references. Rules: shared-library images do not use project storage; they can be reused across projects; upload and shared-library loading cannot be used together — using one locks the other.

Upload via the canvas menu: tap a blank spot → choose "Upload Image" → pick photos → the photo appears near the tapped position. After using shared-library mode, canvas-menu upload is disabled; only one photo per upload.

Create cards by pasting: copy text or an image in another app → return to Mind Board → long-press a blank spot → tap "Paste". Pasting text creates a text card, pasting an image creates an image card; Paste is unavailable when the clipboard is empty; on iOS 16+ the system asks for "paste from other apps" permission, and you can choose "Always Allow" in system settings.

4. Editing, deleting & moving cards

Edit a text card: tap the card → enter edit mode → change the text → tap "Done". The card highlights while editing, resizes automatically after a change, tapping a blank spot cancels editing, and multi-line text is supported.

Delete a card: select it → tap it again to open the card menu → tap "Delete" → it is removed. Deleting a card also removes all connectors attached to it; deletion is undoable; deleting an image card does not affect the original in the project folder; deleting a shared-library reference does not affect the original.

Move a card: long-press → drag to the target → release. While dragging the card shows a translucent preview, a grid-snap hint appears, and connection points show when near other cards. Moving is undoable.

Resize cards: image cards can be resized — select the card, drag the edge handles, and adjust to the target size. Text cards are sized by content and cannot be resized manually; image cards keep their aspect ratio; resizing is undoable.

5. Managing connectors

Create a connector (drag a card): long-press a card and drag it near another → when a connection point highlights, release → a line appears between them.

Create a connector (use connection points): select the starting card → tap a connection point on its edge → drag to the target card's connection point → release to connect.

Connector rules: a line expresses a relationship; one card can connect to many others; you cannot connect a card to itself; two cards can have multiple lines between them.

Adjust a connector: select it → drag the control points → change its shape. Lines are Bézier curves by default; the control points set the curvature; adjusting them does not change the connection; adjusting is undoable.

Delete a connector: select it → tap it again to open the menu → tap "Delete" → it is removed. Deleting a line does not affect the cards; it is undoable; deleting a card removes its connected lines too.

6. Canvas operations

Zoom: pinch to zoom (in for detail, out for overview), double-tap to zoom quickly to a fixed level, double-tap again to return to the original. Range: 0.5x to 3x. The zoom center is the pinch midpoint or double-tap spot; zoom does not change real card sizes; exports use actual size regardless of zoom.

Pan: drag a blank area with one finger to move the view; the canvas extends infinitely in any direction. Dragging blank space pans the canvas; dragging a card moves the card, not the canvas; panning does not change card positions; the view position is not saved.

Fit to Window: "⋯" → Fit to Window auto-zooms and pans so all cards fit the view. The system computes all card bounds, adjusts the zoom level to show everything, and centers it; unavailable on an empty canvas.

Grid background: the canvas shows a grid for alignment and reference. The spacing is fixed, follows zoom, and never appears in exported images.

Snap to grid: dragging a card snaps it to the grid lines automatically within a few pixels, with alignment guides shown and the position fixed on release. Snapping keeps layouts tidy, is optional rather than forced, and manual fine-tuning is not overridden.

7. Undo, redo & autosave

Undo: the top-bar "Undo" button. Undoable actions include creating cards, deleting cards, moving cards, editing text, resizing cards, creating connectors, deleting connectors and adjusting connectors. Multi-step undo is supported; undo history clears when the canvas closes and is empty on re-entry.

Redo: the top-bar "Redo" button. Undo first, then tap Redo to restore the undone action. Redo only restores the last undone action; a new action after undo clears the redo history; redo history clears when the canvas closes.

Autosave: the canvas saves automatically — create/delete/move/edit operations save in real time, connector changes save in real time, and it saves when returning Home; no manual saving is needed. Autosave does not affect undo/redo; reopening the app keeps the canvas, but undo history is not saved.

8. Note conversion

Convert a note into the board: "⋯" → Note Conversion → pick a note from the list → confirm → wait → the note content becomes text cards on the canvas.

Converted content: the note name, headings Level 1–4, and body paragraphs. Not converted: image cards, video cards, audio cards, document cards, tables, formulas and web links.

Rules: each note paragraph becomes an independent text card; both headings and body convert; the cards are arranged automatically; blank paragraphs create no cards; card positions can be adjusted after conversion; the original note is unchanged; conversion is undoable.

9. Summarize notes & export images

Export the canvas as notes: "⋯" → Summarize Notes → wait → a text file is saved to Archive. It only extracts text-card content; image cards are excluded; connector relationships are not reflected; cards are ordered by their position on the canvas.

Summary format: the file is named "mind-map notes.txt", plain text, UTF-8, with each card's text as a paragraph. Each text card is its own paragraph separated by blank lines; blank cards export as blank lines; the file is saved in the Archive "mind map" folder.

Export the canvas as an image: "⋯" → Export as Image → wait → a PNG is saved to Archive. The export includes all visible cards, does not include connectors (current version), uses actual card sizes, is PNG with transparency support, and cannot be done on an empty canvas.

Export limits: the free version allows up to 60 cards and limited export counts; membership unlocks export limits. When over the limit, the interface shows the current card count and the limit and asks you to upgrade.

View results: Archive → the mind-map folder. Images are named canvas1.png, canvas2.png…; the text file is mind-map notes.txt; both support sharing and saving to Photos.

10. Recording video

Start recording: "⋯" → Record Video → allow microphone access (first time) → recording starts with the duration shown in the top bar → operate and narrate → tap "Stop Recording" → the video saves to Photos automatically.

Recording rules: it captures your voice narration via the microphone; the recording includes canvas actions, zoom, pan and card edits; you can keep editing the canvas while recording; there is no duration limit.

Permission: recording needs the microphone. You are prompted on first use; without it you cannot record a narrated video; you can re-enable it in system settings (Settings → Kexu → Microphone → Allow).

During recording: the top bar shows a "Recording" badge and the duration, and you can zoom, pan and edit cards; you cannot export images or switch projects while recording; failures show an error; success saves the video to Photos.

Result: the video saves to the system Photos (not the Archive folder), as MOV or MP4 at screen resolution. It needs photo-write permission, files are large (clean up periodically), and the video can be shared to other apps.

11. Troubleshooting & limits

"Card limit reached": each canvas holds at most 60 cards; delete unneeded cards or create a new project in Archive.

Cannot use Photos and Shared Library together: using one locks the other. Deleting all imported cards releases the lock so you can switch.

No Paste option on long-press: check the clipboard — Paste is hidden when it is empty.

iOS "paste from other apps" prompt: iOS 16+ asks on first paste; choose Allow or Not, or change it later in Settings → Kexu → Paste from Other Apps → Always Allow.

Text cards cannot be resized manually: they are sized by content and resize automatically when you edit the text.

Exported images do not include connectors: the current version exports only card content.

Cannot export an image: check whether the canvas is empty (empty canvases cannot export), whether cards exceed the free export limit, and whether you have upgraded.

Recording needs permission: recording requires the microphone (prompted on first use); manage it in system settings. Recorded videos are saved to the system Photos (Camera Roll or Videos), not the Archive folder.

Quantities and limits: up to 60 cards per canvas; up to 60 photos per upload; zoom range 0.5x–3x; snap within a few pixels; note conversion converts text only (no media); summarize notes includes text cards only; image export is limited on free and unlimited on membership; recording duration is unlimited (bounded by storage); undo history is not saved and clears on closing the canvas.

12. Devices, membership & permissions

Device support: Kexu Mind Board works on iPhone and iPad. iPad uses a wider canvas area; the entry points and logic are the same on both; you can keep editing in landscape.

System requirements: recording needs iOS 14+; paste permission management needs iOS 16+; older systems may lack some features.

Multi-language: menus, buttons and prompts follow the app language; switching language does not change canvas content or card positions; folder names are translated automatically.

Permissions: uploading from Photos needs photo access; pasting images needs clipboard-read access (managed by the system on iOS 16+); recording needs microphone + photo-write access. Refused permissions stop the corresponding feature; follow the on-screen prompt to re-enable them in system settings.

Membership: the free version limits the canvas to 60 cards and caps image export; membership unlocks export limits, all export features, video recording, and the full Mind Board capability set. See membership details in Profile.

1. Overview & entry

Kexu Moments (shown as "Moments" on Home) is a date-centered photo and text journal that lets you add photos and words for each day to capture life moments.

Photos support regular images and Live Photos; text can capture your mood, thoughts or stories for the day. Everything is organized by date for quick browsing of any day, month or year.

Features include date-based recording, Live Photos, location, calendar view, fullscreen browsing, yearly summary, mail reminders and ZIP export/sharing.

Entry: open the Kexu app and tap "Moments" on Home. All records are stored in the project, organized in per-date folders for easy management and backup.

Related modules: Archive views, exports and manages record photos and files; Mail Reminder sets timed reminders to revisit history.

2. Quick start: create your first record

Open Kexu and enter "Moments" from Home. Tap the "Choose Date" button in the center and pick the date to record in the calendar.

Tap "Choose Photos", select up to 12 photos from your library, and wait for the upload to finish.

Tap the text input area below, type up to 1,000 characters, and tap Done. The record autosaves.

Full flow: choose date → add photos → enter text → save the record.

Three basic concepts: date record (photos + text per day), grid view (all records newest-first), and calendar selection (jump to a day).

3. Choosing a date

Tap the date in the top bar or the "Choose Date" button on an empty page to open the calendar; browse months, tap the target date, and the calendar closes to that date.

The calendar starts at the current month; dates with records are marked; both past and future dates are supported.

Switching dates autosaves the current content, and you can add records to future dates in advance for planning.

Use the calendar to quickly locate and view or add a day's record; dates with records are marked.

4. Adding photos & Live Photos

Entry: top-right "⋯" → "Choose Photos", or the "Choose Photos" button on an empty page. Pick up to 12 photos, confirm, wait for the upload, and they appear in the grid.

Rules: each date holds up to 12 photos; both regular photos and Live Photos are supported; photos appear in add order and the first one becomes the date's thumbnail.

Live Photo traits: keeps the short motion clip from before/after the shot; uploads at original quality without compression; plays in both grid and fullscreen.

Live Photo rules: must be fully downloaded from iCloud (otherwise you are prompted to download the original); uploading over WiFi is recommended.

When exporting, each Live Photo's still image (HEIC/JPG) and video (MOV) are saved in the same folder and play normally on supported devices and apps.

5. Entering text

Tap the text input area below, type your content, and tap Done. The text autosaves.

Rules: each date accepts up to 1,000 characters (Chinese, English, digits and punctuation); multi-line text is supported; text saves in real time and can be edited or deleted anytime.

A record with text but no photos shows a special text-only thumbnail, displayed as a text card in the grid.

To edit saved text, switch to that date, tap the text area, edit, and tap Done; changes save instantly.

6. Adding a location

Tap the location bar, enter a place name, and tap Save; the location appears on the record.

Rules: location is optional and does not affect photos or text; it marks places you visited; it appears in the yearly summary; it can be edited or removed anytime.

Keep location text to 50 characters or fewer.

Locations are included in the exported TXT file but are not embedded into the photos' EXIF data.

7. Browsing & reviewing

Grid view: records are listed newest-first; each shows the date, location and photo thumbnail; records with text show a text preview; tap to view details; the grid loads more automatically.

Fullscreen: tap a photo to view fullscreen, swipe left/right to switch photos of the same day, pinch to zoom; supports both orientations; Live Photos play automatically; the date and location show at the top.

Reorder photos: long-press and drag a photo in the record detail page; the first photo is the thumbnail; reordering affects fullscreen order and saves instantly.

Delete photos: select a photo in the detail page, tap Delete and confirm; deletion is permanent; if all photos are deleted but text remains the record is kept, and clearing everything empties that date.

8. Viewing dates with photos

Entry: top-right "⋯" → "Dates with Photos". See which dates have photo records and tap one to jump to its details.

Rules: grouped by month; only dates with photos are shown; text-only records do not appear; great for quickly locating past records.

9. Yearly summary (Book)

Entry: top-right "⋯" → "Book". The system generates a yearly summary automatically; view the content and stats, then export or share.

The summary includes: a year title (e.g. "2026 Year in Review"), photo count, days with records, locations, month-grouped records and daily text.

Rules: grouped by month with per-month counts; photos arranged by date; all text preserved in full.

The yearly summary only supports records from a single year, so cross-year projects must be exported separately; if a project mixes years, the summary and some features are limited — create a new project each year.

Export: tap Export on the summary page, choose a format, and wait; the export includes all photos and text; Live Photos become a still image plus a video; text exports as TXT; files are organized in per-date folders.

10. Mail reminders

Mail reminders are a timed revisit feature: schedule a reminder on a future date, and when it fires it opens that date's historical record — like sending a letter to your future self.

Use cases: revisiting the same day a year later, reviewing important moments after half a year, or regularly revisiting your child's growth records.

Create: on a date's record page tap "Mail Reminder", choose the reminder date and time, and save.

Rules: reminders need notification permission; the time must be in the future; multiple reminders can be set per date; a notification fires at the set time; reminders do not repeat.

Receiving: the system sends a notification; tapping it opens Moments and jumps to the linked date automatically.

View/manage: open "⋯" → "Mail Reminder" to see all reminders (sorted by date); expired ones are cleared automatically; swipe left or tap delete to remove. Reminders cannot be edited directly — delete and recreate. Deleting a reminder does not affect the original record.

11. Sharing & exporting

Share a single day: open that date's record, tap Share, and pick a method (e.g. WeChat, Moments); sharing includes photos and text; Live Photos are shared as stills; you can share only some photos.

Export as ZIP: go to Archive → Material Library → tap the share button, confirm the packing prompt, wait, then share or save.

Packing rules: subfolders per upload date; each Live Photo's still and video stay in the same folder; each date's text saves as a TXT file; original quality is preserved; dates without text produce no TXT; text-only dates produce only a TXT file.

Text format: named "record.txt" or "YYYY-MM-DD.txt", encoded UTF-8, containing that date's text (including location if set).

View in Archive: open the "Screenshots" folder to see photos grouped by date with fullscreen preview and sharing; Live Photos appear as static thumbnails.

12. FAQ & limits

Each date holds at most 12 photos; when the limit is reached you must delete some before adding more.

Common reasons Live Photo uploads fail: not fully downloaded from iCloud, low storage, or unstable network; download the original in the system Photos first, then upload.

Deleting photos or text is permanent — confirm before deleting; export backups of important records regularly.

The grid is fixed to newest-first order and cannot be custom-sorted; the first photo is automatically the thumbnail, changeable by reordering photos.

Export size depends on photo count and quality, especially Live Photos; export months in batches, remove unneeded photos, or transfer via cloud storage.

13. Permissions, devices & system

Permissions: adding photos needs Photos access; Mail reminders need notification permission; exporting to Photos needs write access. If denied, the related feature stops and you can re-enable it in System Settings.

Supported on iPhone and iPad; the iPad uses a wider grid; both devices share the same entry points and logic; you can keep viewing and editing in landscape.

Live Photos require iOS 9+; Mail reminders require iOS 10+; iOS 14+ is recommended for the best experience.

Languages: menus, buttons and prompts follow the app language; switching language does not change record content or photos; date format adapts automatically.

1. Overview & entry

Kexu Images (shown as "Images" on Home) is an image batch-processing toolbox. Upload photos from your library into a project and process them with batch crop, batch watermark, stitch, composite and 9-grid slicing.

Key features: batch crop to a uniform size; batch watermark/scrub to add text or mosaic; batch background removal onto transparency; horizontal/vertical stitching into a long image; fixed-template stitching; image compositing for posters; 9-grid slicing for social feeds; and loading assets from the shared library.

Entry: open the Kexu app and tap "Images" on Home. Processed images are saved in the project folder and can be viewed, exported and shared in Archive.

Related modules: Archive views, exports, batch-manages and deletes processed images; Profile → Shared Library manages image assets reusable across projects.

2. Quick start: your first edit

Open Kexu and enter "Images" from Home. Tap top-right "⋯" → "Upload Images", pick up to 60 photos from your library, and wait for the upload.

Tap "⋯" again, choose a tool (e.g. "Batch Crop"), adjust the crop frame, tap Apply, and wait for processing.

Full flow: upload photos → choose a tool → adjust parameters → apply → view results.

Three basic concepts: upload (import into the current project, up to 60), tool entry (via the "⋯" menu), and the Apply button (confirms parameters and runs the processing, saving results automatically).

Top bar: Back returns to Home; "⋯" opens the tools menu (upload, batch crop, batch watermark, stitch, composite, slice, load from shared library). Tool pages have Close (cancel) and Apply (confirm & process).

3. Uploading & managing images

Upload: tap "⋯" → "Upload Images", pick photos and confirm, then wait for the import.

Rules: a project holds at most 60 photos; both regular photos and Live Photos are supported; Live Photos keep motion when stitched; the interface warns you at the limit.

Load from shared library: tap "⋯" → "Load from Shared Library", pick images and confirm; they are added to the project as references.

Shared library rules: loaded images do not count toward the upload limit; they can be reused across projects; deleting the reference does not affect the original; upload assets to the shared library in Profile first.

View/delete: tap a grid photo for fullscreen preview with swipe and pinch-zoom; deleting happens in Archive (Archive → Images → delete mode → select → confirm), is permanent, and images referenced by other features cannot be deleted.

4. Batch crop

Entry: "⋯" → "Batch Crop" after uploading or selecting photos.

Set ratio: tap the bottom "Ratio" button to choose Custom, Square (1:1), 9:16, 16:9, 3:4, 4:3 and other presets; the crop frame adjusts automatically.

Adjust area: drag the frame corners to resize, drag inside to move, pinch to zoom the photo; swipe the bottom strip to switch photos, each adjusted independently.

Apply: after adjusting all photos, tap Apply at the top, wait, and the images save to the project folder.

Rules: cropping replaces the original; an original backup is saved before processing and can be restored in Archive; Live Photos become still images after cropping; failures show an error message and code.

5. Batch watermark & scrub

Entry: "⋯" → "Batch Watermark/Scrub". Static images only — Live Photos are skipped automatically; the button is disabled if every item is a Live Photo.

Add text watermark: type in the "Input content" box and the text appears on every photo; adjust direction (horizontal, vertical, diagonal), color (black, white, red, etc.), font size and position (independently per photo).

Mosaic brush: tap the "Mosaic" tool, set brush size, and swipe over the photo; one finger draws, two fingers zoom, Undo reverts the last stroke, Clear removes all scrubbing on the current photo.

Rules: mosaic and text watermark can be used together; scrubbing is kept when switching photos; empty watermarks are not applied.

Apply: after entering text or finishing scrubbing, tap Apply; if nothing was entered or drawn the button is disabled; skipped Live Photos show a count; processing replaces the original.

6. Batch background removal

Entry: long-press to select photos in the grid (continue tapping to select more), then tap "⋯" → "Remove Background" and wait.

Rules: static images only — Live Photos are skipped; it uses the system capability and requires a real device (not supported in the iOS simulator).

Options: "Add white edge" (auto-outline after removal so transparent areas stay visible) and "Auto crop" (trim transparent edges to shrink size); set in Profile → Settings → Image processing options.

Result: successful photos become transparent-bottom images, failed ones stay as-is; partial failures show a count and retry button.

Tips: needs a clear subject vs. background; people, products and animals work best; complex backgrounds or blurry photos may fail; results are PNG with transparency.

7. Horizontal & vertical stitching

Entry: "⋯" → "Stitch Horizontally" or "Stitch Vertically". Pick the photos to stitch (up to 12) and confirm to enter the editor.

Rules: horizontal stitches left-to-right, vertical top-to-bottom; Live Photos only stitch vertically, and up to 4 can combine into an animated long image.

Reorder: long-press and drag a photo in the bottom strip; the order determines placement in the long image.

Crop a single photo: tap a photo in the strip to enter single-crop mode, adjust, and tap Done to return; cropping does not affect the original and shows live in the preview.

Dividers: tap the divider between two photos and drag to set spacing (0 to max), per divider; 0 makes photos touch; divider color follows the system theme.

Add/remove photos: tap the "+" to add to the end; tap a photo then Delete to remove; at least 2 photos are required and removing the last one exits stitch mode; deleting does not affect the original.

Export: tap Export or "√" at the top; static photos produce a JPG long image, Live Photos produce an animated MOV; the result is a new file that does not replace the originals.

8. Fixed-template stitching

Entry: "⋯" → "Fixed Template Stitch". Pick 2–60 consecutive photos (in album order) and confirm to reach the template picker.

Pick a layout: swipe the top layout bar and tap a template; photos auto-fill the grid; different templates vary in cell count and arrangement; extras are hidden and empty cells show placeholders.

Spacing: tap the bottom "Spacing" control and drag the slider (0 to max), applied to all cells.

Edit a cell: tap a grid photo to crop its display area, apply a filter, or mirror it; each cell is independent and cropping does not affect the original.

Replace & swap: tap a photo then Replace to choose a new one; long-press one photo and drag onto another to swap (works across rows/columns); swapping keeps the count.

Empty cell style: tap an empty cell and pick a fill color (white, black, gray, etc.); empty cells export as solid blocks.

Export: tap Export or "√"; the ratio is 10:16 (phone-friendly) and the format is JPG; you must re-enter template stitching after switching projects to export.

9. Image compositing

Entry: "⋯" → "Composite". Pick a background photo and confirm; the first photo becomes the bottom background layer.

Add layers: tap the "+" on the right to add photos as layers at the canvas center; layers stack bottom-to-top in add order with newer ones in front; unlimited layers.

Adjust layers: one-finger drag to move, two-finger pinch to scale, two-finger twist to rotate; tap a layer to select it and show its border and handles; tap "Rotate" for a precise slider (-180° to 180°); only the selected layer is affected.

Layer order: select a layer, tap it in the right list, then Move Up or Move Down; Up covers layers below, Down is covered by layers above; the background cannot be moved.

Lock layers: tap "Lock" so a layer ignores gestures; tap again to unlock; locked layers can still be deleted and reordered.

Delete layers: select one and tap "Delete"; the background cannot be deleted; deletion is undoable and does not affect the original.

Alignment guides: dragging near another layer's edge shows horizontal, vertical and center guides automatically, which fade on release; alignment is within a few pixels and does not lock position.

Remove a layer background: select a layer, tap "⋯" → "Remove Background" to make it transparent; needs a real device (not simulator); on failure the layer stays as-is.

Export: tap Export or "√"; the export includes all visible layers at canvas size, in transparent-capable PNG.

10. 9-grid slicing

Entry: select one photo in the grid and tap "⋯" → "9-Grid Slice".

Rules: single photo only (disabled when multiple are selected); static images only.

Adjust area: view the grid lines in the preview, drag the frame to set the slice area, pinch and drag to position the photo; the frame is locked to a square and split into a 3×3 grid with live guides.

Export: tap Export or "√"; tiles are numbered left-to-right, top-to-bottom (row 1: 1,2,3; row 2: 4,5,6; row 3: 7,8,9); each is a square JPG, ready to post in order.

11. Viewing & exporting (Archive)

View results: Archive → Images → choose a folder. Folders include "Stitched Images" (static long images), "Live Stitch" (animated videos), "Composites" and "9-Grid" (9 tiles).

Share/export: open a photo in Archive, tap the share button, and share or save to Photos; sharing uses the system sheet (WeChat, Moments, QQ, etc.); saving creates a copy.

Batch export: open a folder, tap the select button, check multiple photos, then Share or Save to Photos; limited by the system, so split large batches.

Delete results: open a folder, tap delete, check and confirm; deletion is permanent but never affects originals; images referenced by other modules cannot be deleted.

Notes: batch crop, watermark and background removal replace the original (removal makes a PNG), producing no new folder; stitch and composite results go into their folders; folder names translate with the language.

12. FAQ & limits

A project holds at most 60 photos; delete unneeded ones and re-upload, or create a new project in Archive.

Live Photos can be batch-cropped (becoming stills) but are skipped by batch watermark; they stitch only vertically (up to 4) into an animated MOV.

Background removal fails on complex backgrounds, blurry photos or hard subjects; the iOS simulator does not support it — use a real device.

The composite background layer cannot be deleted, but you can cover it with new layers or re-pick the background; if a layer won't move, check whether it is locked and unlock it.

Images loaded from the shared library edit normally without affecting the original; deleting a shared reference does not delete the original.

If fixed-template export fails, check whether you switched projects — re-enter template stitching to export.

On failure the interface shows an error message and code; copy it to report. Prefixes: IMG_CROP_ (crop), IMG_WM_ (watermark), IMG_STITCH_ (stitch), IMG_COMPOSITE_ (composite), IMG_SLICE_ (slice), IMG_REMBG_ (background removal).

13. Permissions & system requirements

Permissions: uploading needs Photos access; background removal needs Photos access plus the system capability (real device); sharing/export needs Photos access (when saving). If denied, the related feature stops and you can re-enable it in System Settings.

System: batch and composite background removal need iOS 15+; Live Photo stitching needs device support for Live Photos; the iOS simulator does not support background removal.

Supported on iPhone and iPad; the iPad uses a wider content area and grid; both devices share the same entry points and logic; editing continues in landscape.

Languages: menus, buttons and prompts follow the app language; switching does not move stored photos, stitches or composites; folder names translate automatically.

1. Overview & entry

Kexu Audio (shown as "Local Music" on Home) is a local music player and manager. Import audio from Files or the Music app; metadata is read automatically and tracks are grouped by artist into a library.

Key features: import MP3, FLAC, M4A and more; automatic artist categories; scrolling LRC lyrics; editing track info and covers; loudness normalization; custom fullscreen player backgrounds (including GIF and Live Photos); and sequential, shuffle and repeat-one playback modes.

You can also simply use it as a lightweight local player — import a few songs and start listening.

Entry: open the Kexu app and tap "Local Music" on Home.

Related modules: Archive lists audio files, shares audio and batch-deletes audio.

2. Quick start: your first playback

Open Kexu and enter "Local Music" from Home. On first entry an empty-library screen shows an "Import Audio" button.

Pick one or more audio files in the system file picker; the files are copied into the project and metadata is read automatically.

After import the tracks are grouped by artist; tap any track to start playing.

A mini player bar appears at the bottom; tap it to expand the fullscreen player, where you can switch tracks, scrub the progress and change the play mode.

Full flow: import audio → auto-categorize → play music → fullscreen control.

3. Importing audio & lyrics

Supported formats: MP3, FLAC, M4A (AAC), WAV, OGG, OPUS, WMA and AIFF.

Import: tap "Import Audio" on the main screen, select one or many files (batch import with no limit), and confirm; a progress overlay appears.

Process: files are copied into the project (originals untouched), metadata (title, artist, album, duration, etc.) is read, and a content hash is computed for dedup; if same-named .lrc files were selected they are linked automatically.

Duplicate detection: if imported audio matches existing library content, a dialog offers "Skip duplicates" (don't import) or "Import anyway" (allow duplicates). Results report "N imported", "N duplicates skipped", "N lyrics linked" and "N lyrics unmatched".

Import lyrics together: a lyric file with the same name as the audio (minus extension, case-insensitive) — e.g. "Song.mp3" and "Song.lrc" — links automatically; unmatched lyrics are not imported and must be added manually.

Import lyrics individually: long-press a track → "Import Lyrics" and choose a .lrc file; if lyrics already exist, a "Replace lyrics?" confirm appears. After import the LRC header is parsed, and an artist (ar:) tag updates the track's artist and re-categorizes it.

Storage: audio lives in the project's audio_tracks folder with subfolders per artist. Lyrics are stored three ways: companion (same-named .lrc beside the audio), manual (.kexu_audio/lyrics/), and embedded (in the metadata — MP3 ID3v2 USLT / FLAC Vorbis Comment). Priority: manual > companion .lrc > embedded.

Lyric format: standard LRC with [mm:ss.xx] timestamps, optional [ar:] artist, [ti:] title and [al:] album headers, one line per lyric, UTF-8 recommended; the system highlights and auto-scrolls the current line in sync with timestamps.

Delete lyrics: in the fullscreen player tap "More" → "Delete Lyrics" (shown only when lyrics exist); this removes manual and companion lyric files, clears the DB lyric path and best-effort clears embedded lyrics; the player stops showing lyrics.

4. Category management

Auto artist categories: the system creates categories from the Artist metadata field, grouping same-artist tracks under the artist name, with the category cover taken from that artist's first track.

Special categories: "Unknown Artist" holds tracks without artist info and cannot be renamed or deleted; "Staging" is a temporary import category hidden from the grid — tracks migrate to their artist category after import.

Viewing: the grid shows artist category cards (name, representative cover, track count); tap a card to open that artist's list; tapping a track there plays from the current category queue.

Managing: enter via "Manage Categories" in the top bar. Rename categories ("Unknown Artist" cannot be renamed, names cannot be empty), delete empty categories or delete a category with its audio (permanent), and long-press-drag to reorder ("Unknown Artist" stays fixed).

Create manually: in category management tap "New Category", enter a name and create; it starts empty (0 tracks) and can receive tracks via the Move feature.

Move tracks: single — long-press a track → "Move" → pick a target; batch — long-press any track to enter multi-select, check tracks, tap "Move Audio", pick a target. Tracks already in the target are skipped; moving updates categoryId/categorySlug and physically relocates files.

5. Playback

Start: tap any track in a list and the current list loads as the queue, playing from that track; playback from search uses the full library as queue; playback from a category uses that category's list.

Mini player bar: shows the current cover, title and artist; the center button toggles play/pause; tapping the bar expands the fullscreen player; swiping down dismisses it (pausing playback).

Fullscreen player: shows a large cover or vinyl animation, track info and a scrubber; bottom controls include previous, play/pause, next and play mode.

Quick actions: tapping the current track in the bar again toggles play/pause without reloading the queue; the lock screen shows media controls; the Dynamic Island (iPhone 14 Pro+) shows the cover and playing state.

Play modes: sequential (plays the queue in order then stops), shuffle (random next until the queue is exhausted) and repeat-one (loops the current track); tap the mode button to cycle, and the mode is remembered.

Queue: from the main list it's the full library; from a category it's that category; importing new audio does not auto-update the queue, deleting removes from it, and switching lists reloads it; in sequential mode prev/next are disabled at the ends, while shuffle and repeat-one always allow switching.

Session restore: the current track, position, play mode and queue are saved; reopening restores the track and position but does not auto-play.

Background playback: continues in the background and on the lock screen; Control Center, lock screen and Dynamic Island work; Bluetooth and car systems control it; calls pause automatically, other apps pause it, and unplugging headphones pauses it.

6. Lyrics display

Location: the lyric area sits below the cover (or beside the vinyl), showing the current line and a few around it; the current line is highlighted, auto-scrolled and kept centered.

Full lyric viewer: tap the "Lyrics" button at the top of the fullscreen player (shown only when lyrics exist) to see all lyrics with the current line centered; scroll freely and tap any line to jump to that position.

Sync: lines match the playback position by timestamp, highlighting when the position passes a line; a tolerance of 100 ms prevents jumping; adjusting playback speed (e.g. 1.5x, 0.75x) keeps lyrics in sync automatically.

Styling: in the fullscreen player the current line is larger and higher-contrast, neighbors are smaller and translucent, and text contrast adapts to the background; the lyric area can be scrolled but snaps back. The viewer is a list with the current line centered.

Missing lyrics: with none, the player hides the lyric area and the "Lyrics" button and shows "Import Lyrics" in More; if a lyric path is recorded but the file is gone, a "lyric file missing" notice appears — re-import or delete the record.

Time calibration: in-app lyric offset adjustment is not supported in this version; if timing is off, edit the timestamps with an external LRC editor and re-import (which overwrites).

7. Unified loudness (normalization)

What it does: Loudness Normalization (a.k.a. Sound Check) analyzes each track's volume and adjusts playback gain so all songs sound consistent, avoiding constant volume fiddling.

How it works: the system analyzes integrated loudness (LUFS) and true peak (dB), computes the ReplayGain needed for the target loudness, and applies it dynamically without modifying files.

Toggle: in the fullscreen player More menu → "Unified Loudness"; on/off toasts confirm, and the setting is remembered.

Analysis: runs in the background after import; an unanalyzed current song is prioritized on first play, then idle time analyzes the rest; it is silent, results are saved to the DB, and the algorithm version triggers re-analysis when updated. Uses ITU-R BS.1770 for LUFS and true peak.

Gain: target is -16 LUFS (matching Apple Music/Spotify); boosting quieter songs is capped at +18 dB, reduction is unlimited; gain is lowered if it would cause clipping; a new gain applies on track change and resets to 0 dB when disabled.

States: pending (waiting), analyzed (done) and failed (unsupported format or damaged file); view LUFS, True Peak and Replay Gain under "File info" in the edit page.

8. Editing track info

Entry: long-press a track → "Edit Info", or in the fullscreen player More → "Edit Info".

Editable fields: Name (required), Artist (required), Album (required), Album Artist, Composer, Lyricist, Genre, Year, Track Number, Disc Number, Comment and Copyright.

Rules: name, artist and album cannot be empty; Year is numeric; Track/Disc numbers are positive integers; other fields have no length limit.

Change cover: tap the cover area in the edit page and pick from Photos; the image is cropped to a square; saving writes it into the track's metadata. There is no separate remove-cover in this version — use the app logo as a placeholder instead. Covers are stored in .kexu_audio/artworks/ with auto thumbnails for fast lists.

Change category: tap the "Category" picker, choose a target and save; the file physically moves to the new category folder and the DB updates. Editing the artist auto-creates or matches an artist category.

Save: tap Save at the top-right; it updates the DB, writes metadata into the file (MP3 ID3v2 / FLAC Vorbis Comment), writes the cover, migrates category files and marks metadataUserEdited so later scans don't overwrite. The write result is success, partial or failed; even on failure the DB record updates and in-app display is unaffected.

File info: the bottom of the edit page shows read-only file name, format, duration, bitrate, sample rate, channels, codec and size, plus loudness (LUFS, true peak, gain) when analyzed.

9. Customizing the player

Background system: the default derives a gradient from the current cover's dominant color for an immersive feel, with no setup; you can also upload your own image or GIF, per track or globally.

Import: in the fullscreen player tap "Background" → "Import Background" and pick images or GIFs from Photos (up to 30 at once); they are copied into the project's background folder.

Formats: static JPG, PNG, HEIF; animated GIF; and Live Photos (motion preserved). Thumbnails are generated, motion is kept, and large images are compressed to fit the screen.

Apply: tap a background in the picker; with "Apply to all songs" off it applies only to the current track, and on it applies to every track (including newly imported ones).

Priority: per-track background (highest) > global custom background > default cover ambience (lowest).

Manage: the picker shows all imported backgrounds with the active one highlighted; long-press to delete, which restores affected tracks to default and clears the global setting if it was global. Backgrounds live in .kexu_audio/player_backgrounds/ with settings in player_backgrounds.json and a unique ID per background.

Vinyl mode: decided automatically by layout — large screens (e.g. iPad) show a spinning vinyl animation, small screens show a large cover. The record spins while playing and stops when paused, speed tracks playback, and the tonearm lowers/raises with playback state.

10. Searching

Full-library search: entry is the search button in the top bar; it covers track titles and artists, independent of the current view or category filter.

Search behavior: real-time results, case-insensitive, fuzzy (substring) matching, supporting Chinese, English and multiple languages.

Results: a list of matches (cover, title, artist); tap to play (queue = full library); long-press for the action menu; empty results show "No results found".

Within-category: opening a category shows only its tracks and in-category search isn't available — use full-library search, note the artist, and return to the grid to find the category card.

Quick locate: in list view the currently playing track is highlighted for fast scrolling (grid has no highlight); tapping ✕ in a category returns to and clears the filter to show the full library.

11. Sharing & deleting

Share one track: long-press → "Share" and pick a method (AirDrop, Messages, Mail, etc.). What is shared is the audio file itself (no lyrics or cover), with metadata retained. Copyright-protected audio may not share to some platforms; large files (e.g. FLAC) may hit mail attachment limits — AirDrop is recommended for lossless.

Delete one: long-press → "Delete Audio" and confirm. This removes the file from disk, the DB record, linked lyrics, the cover cache, the entry from the current queue and its custom-background mapping — permanently.

Batch delete: via Archive → the project → "Audio Files" folder → the category subfolder → delete mode; check files and confirm. Deleting files syncs the DB records and cleans lyrics/covers; it cannot be undone.

Clean invalid records: the system auto-scans on launch, detects duplicates on import, and checks file existence on playback; there is no manual full-library scan — restart the app or delete files in Archive to trigger cleanup.

12. Data management

Storage: audio lives in audio_tracks/ (subfolders per artist); the metadata folder .kexu_audio/ holds audio.db (SQLite), artworks/ (cover cache), lyrics/ (manual lyrics) and player_backgrounds/.

Database: SQLite tables include music_tracks, music_categories, artist_aliases and preferences. Key fields: id, filePath, categoryId, contentHash (SHA-1 for dedup), lyricsPath, artworkPath, loudnessLufs and metadataUserEdited.

Backup & restore: full-project backup via Archive → the project → "Export Project" packages all audio, the DB, cover cache, lyrics, custom backgrounds and player settings; restore via Archive → "Import Project". Restoring overwrites a same-named project, keeps loudness data, and does not restore the playback session.

Migration: export on the old device, transfer via iCloud/AirDrop/etc., and import on the new one; relative audio paths survive device migration, backgrounds travel along, loudness results are kept, and sessions/queues are not migrated.

Space: see project size stats in Archive; usage is mostly audio (90%+), then cover cache, custom backgrounds and the DB (usually < 10 MB). Free space by deleting rarely-played audio, unused backgrounds, avoiding lossless imports, and cleaning duplicates.

13. Troubleshooting & system requirements

Imported audio missing: check the format is supported, the file isn't damaged, the import wasn't interrupted, and background scanning finished; restart the app to rescan, or confirm the file in Archive's "Audio Files" folder.

No category: tracks default to "Unknown Artist" when the Artist metadata is absent or malformed; fill in Artist under Edit Info and save — the system auto-creates or matches a category.

Lyrics not showing: check that lyrics were imported, they are .lrc, they sit beside the audio, encoding is UTF-8, and the LRC format is valid; try re-importing.

Volume inconsistent: enable Unified Loudness and wait for background analysis; if it persists, check the file itself.

Can't edit metadata: some formats (e.g. WAV) lack full metadata support, the file may be in use, or permissions are limited; convert formats or restart; the DB still updates even on write failure.

Blurry/warped covers: source resolution is too low (use 1000x1000+) or non-square (auto-cropped); use high-res, pre-cropped square images.

Background not applying: check the "Apply to all songs" toggle, whether a per-track background (higher priority) exists, and whether Apply was confirmed; reselect and confirm.

GIF background static: low-end devices may disable animation, the GIF may be damaged, or animations are off (Accessibility → Motion); re-import or use a still image.

Loudness analysis failed: unsupported format, damaged file, or oversized file; failure doesn't stop playback — disable normalization, adjust manually, or convert and re-import.

Devices: iPhone (iOS 14.0+) and iPad (iPadOS 14.0+); iOS 16.0+ recommended for analysis performance, 2 GB+ free storage; full landscape support.

iPad keyboard shortcuts: Space play/pause, → next, ← previous, ⌘F search, ⌘N new category, ⌘I import audio, Esc close/back (iPhone not supported).

Privacy: all audio is stored in the local project, the DB stays on-device, and nothing (audio, lyrics or covers) is uploaded; loudness analysis runs locally.

1. Overview & entry

Kexu Outfit (shown as "Outfits" on Home, also called "Four Seasons Outfits") is a smart wardrobe manager and outfit recommender. Photograph items, tag them by category, occasion and season, and let the system recommend daily outfits from your closet.

Key features: build a wardrobe (photograph and organize items by category); tag attributes (color, occasion, season, price); smart recommendations (based on date, season and closet contents); quick outfits (manually pick items into a collage); outfit stitching (auto-arranged magazine style); weekly preview; outfit notes; statistics (usage frequency, idle days); and export/share.

Wardrobe data and outfit records live in the project, and you can create multiple projects for different scenarios (e.g. work outfits, everyday outfits).

Entry: open the Kexu app and tap "Outfits" on Home.

Related modules: Archive views, exports and deletes outfit collages and note files; Profile → Size Info sets your measurements to support clothing management.

2. Quick start: your first outfit

Open Kexu and enter "Outfits" from Home. Tap the "+" in the left wardrobe panel, choose a category (e.g. "Tops"), and take a photo or pick one from your library.

Set color, occasion and season for the item, then tap Save. Repeat to add bottoms and shoes.

Tap top-right "⋯" → "Today's Pick"; the system recommends an outfit automatically; review and export the result.

Full flow: add items → set attributes → get recommendations → view outfit.

Four basic concepts: Wardrobe (the categorized area holding all items), Canvas (the central outfit display area), Smart Recommendation (auto suggestions from your closet, season and occasion), and Quick Outfit (manually assembling items into a collage fast).

Top bar: Back returns to Home (content autosaves); Date switches days; "⋯" opens the tools menu (Quick Outfit, Today's Pick, Weekly Preview, Outfit Stitch, Manage Assets, Full Set — in development). The wardrobe panel has a "+" to add items, category tabs, and thumbnails (tap for details or drag to canvas).

3. Building the wardrobe

Add an item: entry is the "+" in the left wardrobe panel. Choose a category (tops, bottoms, shoes, etc.), take a photo or pick from Photos, wait for upload, set attributes in the detail page, and tap Save.

Rules: photograph items on a solid background; backgrounds are removed automatically to keep the subject; item count per project is set by membership tier; added items appear under their category.

Categories: Tops (T-shirts, shirts, sweaters, coats, etc.), Bottoms (pants, shorts, skirts, etc.), Shoes (sneakers, dress shoes, heels, etc.), Accessories (hats, bags, scarves, etc.) and Base layers (camisoles, tank tops, etc.). A major category is required when adding; subcategories are optional for finer sorting; recommendation respects major-category pairing rules.

Color tag: tap "Color" in the detail page; the dominant color is detected automatically and can be adjusted manually; colors drive color-harmony analysis and support a primary + accent; clear photos are needed for detection.

Occasion: choose Commute, Casual, Sports, Formal, Date, etc. (multi-select); untagged items are available in all occasions, tagged ones appear only in matching ones.

Season: Spring (Mar–May), Summer (Jun–Aug), Autumn (Sep–Nov), Winter (Dec–Feb) and Multi-season (cross-season, multi-select); the system infers the current season from the month and filters unsuitable items in recommendations.

Price: tap "Price" in the detail page to enter the purchase price for wardrobe-value statistics; optional and does not affect recommendations, stored locally only.

Purchase date: pick it in the detail page to calculate idle time and decide when to retire older items.

4. Editing & deleting items

Edit info: tap an item's thumbnail in the wardrobe panel, change color, occasion, season, etc., and tap Save; changes apply immediately and updating occasion/season affects recommendations.

Photos cannot be edited — delete and re-add to change them.

Delete: tap "Delete" in the detail page and confirm; it is permanent and affects existing outfit records; check whether an item is referenced by an outfit first.

5. Today's pick

Get a pick: entry is "⋯" → "Today's Pick". After the system analyzes your closet it recommends today's outfit — review the tops, bottoms and shoes.

Conditions: based on the current date's season; considers occasion tags; analyzes color harmony; requires at least one top, one bottom and one pair of shoes.

Requirements include: core items (one each of top, bottom, shoes), season fit (tags match the current month), color analysis (items have color tags), and occasion availability (at least one occasion has a usable combo).

Quality report: shown automatically when a recommendation fails; it includes an overall grade (fully qualified / basically qualified / unqualified), entry conditions (core-item count and color-analysis progress), occasion availability, recommendation capability (whether a full three-piece set is possible and how many) and itemized suggestions; it can be exported as a text file.

Accept: a successful pick appears on the canvas automatically; adjust positions/sizes manually and tap "⋯" → "Outfit Stitch" to arrange; the pick replaces current canvas content, individual items can be swapped, and it autosaves to that day's record.

6. Quick outfits

Manual pick: entry is "⋯" → "Quick Outfit". Choose items in the picker across categories, tap Confirm, and they appear on the canvas.

Rules: pick any items freely with no season/occasion limits — great for recording what you actually wore; the layout can be adjusted afterward.

Drag from wardrobe: long-press a thumbnail in the left panel and drag it onto the canvas; intuitive and precise for initial placement, supports cross-category adds, and the canvas highlights the drop zone.

Adjust canvas items: tap to select and drag to move; drag an edge handle to resize; tap then Delete to remove. The canvas holds a reasonable number of items, supports overlap, saves changes live, and deleting never removes wardrobe items.

7. Outfit stitching & exporting

Auto-stitch: entry is "⋯" → "Outfit Stitch" after placing items on the canvas; items are re-arranged automatically in magazine style, keeping proportions for a tidy look; the action is undoable.

Export: after finishing a layout the outfit autosaves to that day's record; view exported images in Archive.

Rules: outfits autosave as images; they are stored in the "Daily Outfits" folder; file names include the date; they can be shared and exported from Archive.

Clear canvas: select items and delete them one by one or all at once to return to a blank canvas; clearing does not affect the wardrobe, empties the day's record, and items can be re-added.

8. Dates & weekly preview

View different dates: tap the date in the top bar, pick one in the calendar, and the canvas switches to that day's outfit. Each date has its own outfit; switching autosaves; future dates can be planned ahead and past ones revisited.

Quick switching: tap "Today" in the calendar to return, use the arrows for adjacent days, and long-press the date display to jump. Today is highlighted, dates with outfits are marked, and future days can be pre-planned.

Weekly preview: entry is "⋯" → "Weekly Preview". See thumbnails for each day of the week, tap a day to jump to details, and view each day's notes. It runs Monday to Sunday; blank days show "Not configured"; days with notes show them; ideal for whole-week planning.

9. Outfit notes

Add: after building an outfit, tap the note input below the canvas, type the day's story or thoughts, and tap Done; the note autosaves. One note per day, multi-line supported, saved to that date, editable and deletable.

View: check the day's note on the canvas, the week's notes in the weekly preview, and the note text file in Archive. Notes show below the outfit; the preview shows only part and details need opening.

Note file: notes save to "outfit-notes.txt" in the format "date|note" at the project root; it can be viewed, exported and shared in Archive, and updates in real time when you edit a note.

10. Clothing statistics

Usage: in the item detail page see usage count (times it appeared in outfits), last used (most recent date) and idle days (days since last use); stats update in real time and any placement on the canvas counts as one use.

Wardrobe overview: in Manage Assets see total item count, per-category counts and total value (sum of prices if filled in); these show scale and structure.

Occasion analysis: the system measures coverage per occasion (commute, casual, sports, etc.) to balance the wardrobe, spot gaps and guide shopping decisions.

11. FAQ & limits

Can't add items: check the project's item cap, Photos permission, and that the photo meets format requirements (JPG, PNG, etc.).

Today's pick failed: the closet lacks items (need one each of top, bottom, shoes), season tags don't match the month, no color tags, or no usable occasion combo — check the quality report.

Quality grades: fully qualified (all conditions met), basically qualified (partial — recommendable but maybe lower quality) and unqualified (key conditions unmet, cannot recommend).

Deleting items is permanent — check for outfit references first; photos can't be edited — delete and re-add.

Background removal fails on unclear photos, non-solid busy backgrounds or unclear subjects; shoot on white/light backgrounds and avoid shadows and glare.

Quick Outfit vs. Today's Pick: Quick is manual, unrestricted and for recording what you wore; Today's Pick is smart, needs season/occasion conditions and gives styling inspiration.

Outfit Stitch rearranges everything and overrides your layout; skip it if you like the current arrangement.

Notes are saved two ways: on-screen (below the canvas and in the weekly preview) and as a text file ("outfit-notes.txt" at the project root).

Usage counts every placement on the canvas (recommendation, quick outfit or manual drag); idle days reveal long-unworn items to help decide on retiring or donating.

Multi-season items: check multiple seasons or "Multi" — they qualify in every season's recommendations; occasion tags filter recommendations, and untagged items work in all occasions.

12. How smart recommendations work

Pipeline: season filter (drop items unsuitable for the month) → occasion match (filter by tags) → color analysis (harmony) → combination generation (build top/bottom/shoes combos) → scoring and best pick.

Factors and weights: season fit (high), color harmony (high), usage frequency (medium), occasion match (medium) and idle time (low).

To improve recommendations: complete item tags (accurate color, occasion, season); balance wardrobe structure across categories; refresh regularly (retire stale items, add new ones); and consult the quality report to tune your setup.

Limits: item count per project is set by membership; keep the canvas to ~10 items; categories are tops, bottoms, shoes, accessories and base layers; occasions include commute, casual, sports, formal, date, etc.; seasons are spring, summer, autumn, winter and multi; notes should stay under 500 characters; recommendations need at least one top, one bottom and one pair of shoes.

13. Permissions, devices & system

Permissions: adding items needs camera and Photos access; background removal needs Photos access (plus the system capability); exporting outfits needs Photos write access (when saving). If denied, the feature stops and you can re-enable it in System Settings.

Supported on iPhone and iPad; the iPad uses a wider wardrobe panel and canvas; both share the same entry points and logic; editing continues in landscape.

System: background removal needs iOS 15+ and a real device (not the simulator); iOS 14+ is recommended for the best experience.

Languages: menus, buttons and prompts follow the app language; switching does not change wardrobe contents or outfit records; category, occasion and season names translate automatically.

1. Quick start

kexu Paste (shown as "Text Collection" on Home) is a lightweight text-collection tool for quickly saving important text while browsing, reading, or working on documents.

One-minute start: go to Text Collection from Home → tap "Start a category" the first time to create one (e.g. "Work notes") → copy text in any app → return and tap "Paste" at the bottom → it is saved and shown in the list → tap an item to expand it, and use "List" in the top bar to switch or create categories.

Three core concepts: Category (a container that organizes text, each with its own TXT mirror file), Original text (the pasted content, up to 50,000 characters), and Supplement (a personal note per item, at most one per item, up to 500 characters).

• Organize quickly: create multiple categories to file copied text, e.g. "Materials", "Quotes", "To-do".
• Add notes: attach your own remarks, judgments, or ideas to each item to separate the original from your thoughts.
• Keep time context: every record is time-stamped automatically for later tracing.
• Bulk copy & export: copy an entire category at once, or export to a TXT file for backup and sharing.
• Keyboard integration: with keyboard saving enabled, text copied anywhere on the system is stored automatically into the chosen category.
• You can also use it purely as a temporary clipboard, saving on the fly without building a category system.

2. Create & switch categories

First use: enter kexu Paste, tap "Start a category", enter a name (up to 50 characters), and confirm to create it.

With existing categories: tap "List" in the top bar, tap the "New category" button at the top, enter a name, and confirm.

Switch categories: tap "List" in the top bar, tap the target category, and the app loads its content automatically.

The category list shows the name, item count ("N items"), and last-updated time (today shows HH:mm, yesterday shows "Yesterday", older shows month/day).

• Category names are normalized: leading/trailing spaces are stripped; empty or space-only names cannot be created.
• Category names may repeat; the system auto-generates distinct export filenames.
• The number of categories per project depends on your current membership tier.
• Categories are sorted by creation time (newest first); when bound to a keyboard save target, "Temp Clipboard" is pinned to the top.
• The last-viewed category is remembered and reopened next time; after creating a category the app switches to it automatically.

3. Paste text

Steps: copy text in any app → return to kexu Paste → confirm the current category shown in the top bar → tap "Paste" at the bottom.

Behavior: it reads the clipboard plain text, records a timestamp, appends the item to the bottom of the category, updates the TXT mirror, and shows an "Saved" confirmation.

Limits: only plain text is accepted (images, links, and rich text are ignored); a single item is limited to 50,000 characters; an empty or space-only clipboard shows "No text in clipboard".

4. View, expand & collapse

New items start collapsed; tap the item body to expand it for the full content, and tap again to collapse.

Collapsed: shows the save time in HH:mm, the first three lines (about 90 characters), and a "Note:" label with a preview if a supplement exists.

Expanded: shows the full original text and the full supplement (if any), separated by a divider.

Swiping does not affect the expanded/collapsed state.

5. Edit original text & move categories

Steps: swipe the original area left → tap "Edit" → modify the text on the edit page → optionally move it to another category → confirm to save.

Edit page: a multiline text box for the content, a category picker to switch the target category, and a live character count / maximum.

Rules: an item is limited to 50,000 characters (saving fails above the cap); editing updates the category updated_at timestamp; moving updates item counts in both source and destination categories.

6. Supplements

Add a supplement: swipe the original area left → tap "Supplement" → enter text in the popup → confirm.

Edit a supplement — method 1: swipe the supplement area left → tap "Edit" → change and save; method 2: swipe the original area left → tap "Supplement" → edit the existing text and save.

Rules: at most one supplement per item; up to 500 characters; a supplement that is empty or space-only is removed on save; supplements are written into the TXT mirror.

7. Copy text

Copy an item: swipe the original area left → tap "Copy" → the app shows "Copied"; copy a supplement: swipe the supplement area left → tap "Copy".

Copy the whole category: make sure it has content, tap "Copy all" in the top bar, and the app shows "Copied".

The whole-category copy is ordered by time ascending (oldest first): it starts with the category name, then each item shows its time, text, and supplement; items without a supplement omit the "Supplement:" part.

Copies contain plain text only, with no formatting.

8. Delete content

Delete an entire record (text + supplement): swipe the original area left → tap "Delete" → confirm with "Delete this item? The text and supplement will be removed."

Delete only the supplement: swipe the supplement area left → tap "Delete" → confirm with "Delete this supplement? The supplement will be removed, the original text stays."

After deleting, the category item count and the TXT mirror update automatically; the action cannot be undone, so proceed with care.

9. Bulk operations

Clear a category: make sure it has content, tap "Clear all" in the bottom bar → confirm with "Clear all items? All text and supplements in the current category will be removed." It clears only the current category (not the category itself), resets the count to zero, updates the TXT mirror to just the name and update time, and cannot be undone.

Import from a file: tap "Import" in the bottom bar → pick a TXT file in the system picker → paragraphs are split on blank lines and imported → the app shows "Imported N items".

Import rules: TXT only; paragraphs are split on consecutive newlines (blank lines); each paragraph becomes one item; empty and space-only paragraphs are filtered; paragraphs over 50,000 characters are skipped; imported content is ordered by time.

Import errors: missing file shows "File not found"; empty file shows "File is empty"; read failure shows "Import failed, try again".

Pagination: the first 50 items load on entry, the next page loads automatically when scrolling to the bottom (50 per page) with a loading indicator; no manual action is needed.

10. Export & TXT sync

The app maintains a TXT mirror for every category in the project root, named from the category to avoid collisions, and writes it 400 ms after any add, edit, or delete.

TXT format: it begins with the category name and update time, then each item shows time, text, and supplement — matching the whole-category copy format.

The TXT file stays in sync with the database; deleting a category also deletes its TXT file; TXT files can be viewed and shared from Archive.

• Export: Archive → select the text-collection project → view the category TXT list → tap a file to view it → use the system share sheet to export or send.
• Archive supports viewing TXT (read-only), sharing to other apps, and bulk-deleting TXT files.
• Filename rules: unsafe characters (/ \ : * ? " < > |) are removed, names are capped at 100 characters, a category-ID suffix is added when needed to avoid duplicates, and .txt is appended. Examples: "Work/Materials" → "Work_Materials.txt", "Study notes" → "Study notes.txt".

11. Keyboard integration

With keyboard saving enabled, text you copy anywhere on the system is stored automatically into the chosen text-collection project — into "Temp Clipboard" or a custom category — and saved fragments can be viewed and sent from within the keyboard.

Set the save target: create or pick a kexu Paste project → choose "Save copies to kexu Paste" in keyboard settings → select the target project → turn on "Save to text-collection project" in the keyboard "More" menu.

Choose the save category: on the keyboard send-library screen, tap the "Save copies to kexu Paste" picker at the top and select a category (e.g. "Temp Clipboard" or a custom one).

Keyboard–app sync: text pasted in the app syncs to the keyboard instantly, keyboard-captured content syncs to the app, and edits or deletions in the app update the keyboard automatically.

Refresh data: the keyboard refreshes on app launch, 400 ms after a content change, and when the app returns to the foreground; you can also tap "Refresh keyboard data" on the keyboard settings page.

• "Temp Clipboard" is a special keyboard category: pinned to the top, protected from deletion in Archive, built for fast keyboard capture, and editable/organizable/exportable in the app.
• Uses: temporarily hold keyboard-copied fragments, act as a staging area to sort into other categories later, and quickly accumulate text to process.
• In the keyboard, tap the fragment list to view saved text, filter by "All", "Recent", or "Frequent", and tap a fragment to send it to the current field.

12. Storage, sync & backup

Storage: structured data lives in .kexu/paste.db (SQLite) and TXT mirrors live as .txt files in the project root; tables include paste_categories (categories), paste_items (items), paste_supplements (supplements), and paste_settings (settings).

Auto-save: pasting writes to the database immediately, edits/deletes update it immediately, and TXT mirrors are written 400 ms after database changes; nothing needs to be saved manually.

Consistency: the database is the source of truth, TXT is a read-only mirror (manual edits are overwritten); the app validates the schema on launch and rebuilds if it mismatches (old data is lost).

App lifecycle: on background it saves state and flushes pending TXT writes; on foreground it merges new keyboard-captured items and refreshes lists; on screen destroy it flushes pending TXT writes without closing the database (the keyboard may still write in the background).

Database maintenance is automatic: indexes on (category_id, created_at), soft deletes (deleted_at), auto-updated category counts, and cleanup of stale capture-queue data.

• Project backup: Archive → select the project → "Export project" → choose a location; this includes the database file, all category TXT mirrors, and project metadata.
• Restore: tap "Import project" in Archive → pick the exported project file, and the app restores the database and TXT files; restoring overwrites a same-named project, so back up first.
• TXT-only backup: in Archive, long-press a category TXT file → "Share" or "Save to Files"; it can be sent by email/message or saved to cloud storage.
• Migration: export on the old device → transfer via iCloud/AirDrop → import on the new device; or move items one by one with the edit function, or export a TXT and re-import it with the import feature.

13. Limits & FAQ

Length limits: an item up to 50,000 characters, a supplement up to 500, a category name up to 50, and an export filename up to 100 characters (after removing unsafe characters).

When exceeded: pasting too-long text shows "Text too long" and refuses to save; typing an over-long supplement disables the save button with a live count; over-long category names are capped in the input box.

Performance limits: 50 items per page, auto-load 120 px before the bottom, 400 ms TXT-write debounce, 400 ms keyboard-sync debounce.

Project count: how many text-collection projects an account can create is set by the membership tier (Free: 1 project); Home shows a notice at the limit.

• "No text in clipboard" on paste: the clipboard is empty or not plain text (e.g. an image or link); copy plain text and paste again.
• "Text too long": an item is capped at 50,000 characters; split long text into several pastes or use file import, which splits paragraphs automatically.
• Supplements are capped at 500 characters: keep them concise, or paste the detailed note as a new item.
• Category names cannot be renamed directly: create a new category, move items with the edit function, then clear and delete the old one.
• Deleted content cannot be recovered: deletion is immediate and irreversible; confirm before deleting and back up TXT files regularly.
• TXT not showing the latest content: writing is debounced by 400 ms; wait about a second or refresh the file list in Archive.
• "Temp Clipboard" cannot be deleted: it is a protected keyboard category; to stop using it, turn off "Save to text-collection project" in keyboard settings or unbind the project.

1. Enable the keyboard (iOS)

Open kexu, go to Quick Keyboard from Home, and tap "Open system settings".

In iOS Settings go to General → Keyboard → Keyboards → Add New Keyboard and choose "kexu" from the list.

Return to the keyboard list, tap "kexu", and turn on "Allow Full Access".

Done. In any app's input field, long-press the globe key or tap it to switch to the kexu keyboard.

• Keyboard ready: the keyboard is added with Full Access enabled and works normally.
• Added but Full Access not enabled: the keyboard cannot read or insert content.
• Follow the steps below: the kexu keyboard has not been added yet.

2. Enable the keyboard (Android)

Open kexu, go to Quick Keyboard from Home, and tap "Open system settings".

In Android Settings go to System → Languages & input → Virtual keyboard → Manage keyboards and enable "kexu Paste".

Return to kexu and tap "Switch input method"; in any input field long-press the space bar or tap the keyboard icon to switch to the "kexu Paste" input method.

The Settings path can vary by device; if you cannot find the option, search for "input method" or "keyboard" in Settings.

3. Configure save-copies

In kexu, go to Quick Keyboard from Home and pick a text-collection project as the save target in the "Save copies to" list.

On the kexu keyboard (open any app's input field and switch to it), tap "More" and turn on the "Save copies to paste" switch.

Once on, text you copy in other apps is written automatically to the selected project's "Temp Clipboard" category, not into the keyboard's own send library.

• You must choose a save target before the save feature can be enabled.
• Keep the kexu app running in the background while saving is on.
• Copied content is saved only to the selected text-collection project and is never uploaded to the cloud.

4. One-minute quick start

In kexu, go to Quick Notes (the kexu Paste module) from Home, create a text-collection project, add categories, and save some text.

Return to Quick Keyboard from Home, enable the keyboard as described, and select the project you just created in the "Save copies to" list.

Open an app such as WeChat or Notes, enter a field, and switch to the kexu keyboard (long-press the globe on iOS, long-press space or tap the keyboard icon on Android).

Tap a category name at the top of the keyboard to browse, then tap any item to insert it into the field.

Tap "More", turn on "Save copies to paste", copy some text in another app, and return to the text-collection project to see it saved automatically.

• Full flow: enable the keyboard → set a save target → use it in other apps → insert text → auto-collect copies.
• The keyboard sources its content from the kexu Paste module; it is recommended to create a text-collection project and organize categories before enabling it.

5. Switch to the keyboard in other apps

iOS method 1: long-press the globe key 🌐 in a field and choose "kexu" from the keyboard list; method 2: tap the globe key 🌐 repeatedly until the kexu keyboard appears.

Android method 1: long-press the space bar in a field and choose "kexu Paste" from the input-method list; method 2: tap the input-method icon on the keyboard (usually a keyboard shape) and choose "kexu Paste".

6. Browse and select content

The keyboard has three areas: the category bar (top, showing all category tabs; tap to switch), the content list (middle, showing items in the current category with a title and preview each), and the action bar (bottom, with Send, Clear, Space, Delete, and More buttons).

Browse: tap a category tab at the top to switch, scroll up and down through the items, and tap an item's expand button (if shown) to see the full text.

Insert: tap any item in the list and it is inserted immediately at the cursor in the current field.

• The Temp Clipboard category shows recently copied content in reverse chronological order, for temporary items you do not want to keep.
• Other categories appear under the names you created in the text-collection project.
• Empty categories still show their tabs at the top so you can see the full category structure.
• Longer items collapse; tap the expand button to view the full text and collapse to restore.

7. Basic keyboard actions

Send: sends the current field content directly (same as the Return key).

Clear: clears everything in the current field.

Space: inserts a space character; Delete: removes the character before the cursor.

More: opens more settings, where you can turn the save-copies feature on or off.

8. Refresh keyboard data

After you add, edit, or delete content in the kexu app, the keyboard does not sync immediately — you need to refresh manually.

How to refresh: open kexu, go to Quick Keyboard from Home, tap "Refresh keyboard data"; when "Keyboard data updated" appears it is done, then return to any app and switch to the kexu keyboard to see the latest content.

Refreshing regenerates a keyboard data snapshot — packing the categories and items into a keyboard-readable format — and syncs it to the keyboard extension.

• Refresh when: you create or rename categories, add/edit/delete items, switch the save-target project, or the keyboard content does not match the app.

9. Auto-save copied content

To enable: go to Quick Keyboard from Home → pick the target project in "Save copies to" → open any app's input field and switch to the kexu keyboard → tap "More" → turn on the "Save copies to paste" switch.

Once on, the keyboard watches the system clipboard and writes copied text into the selected project's "Temp Clipboard" category automatically.

To view saved content: open kexu → Quick Notes, open the target project, tap the category list at the top-left and choose "Temp Clipboard" (newest first); or tap the "Temp Clipboard" tab at the top of the keyboard directly.

To turn it off: switch to the kexu keyboard in any field, tap "More", and turn off the "Save copies to paste" switch.

• Turning it off does not delete already-saved copies; they remain in the project.
• The switch state is kept across app restarts, so you do not need to re-enable it each time.
• Saving only works while the keyboard extension is running; if the system clears its background process, switch back to the kexu keyboard to reactivate it.
• If no save target is chosen, enabling it in the "More" menu shows "Please select a text-collection project to save to".

10. Choosing & switching the save target

In kexu, go to Quick Keyboard from Home; the "Save copies to" list shows all text-collection projects — tap the radio button next to a project to make it the target.

The target must be a text-collection project (not the keyboard's own send library); copied content is written to that project's "Temp Clipboard" category.

If the project has no "Temp Clipboard" category, the system creates one automatically; you can switch targets at any time, but refresh the keyboard data afterward.

• The send library is the keyboard's default project, named "kexu Keyboard"; it cannot be renamed or used as a save target.
• Only one text-collection project can be the save target; all of its categories and items are shown in the keyboard.

11. Managing keyboard content

The keyboard displays content from the selected text-collection project; it stores nothing itself but reads the project's database.

Add content: open kexu → Quick Notes, open the source project, tap the ⋯ menu at the top-left and choose "New item" or type directly, pick a category and save, then return to Quick Keyboard and tap "Refresh keyboard data".

Edit: open the item in the project, change and save it, then refresh keyboard data; Delete: long-press or swipe the item left in the project, choose "Delete", then refresh keyboard data.

The keyboard cannot add, edit, or delete content directly — all content management is done in the kexu app.

• Create a category: tap the category list at the top-left of the project → "New category" → enter a name → refresh keyboard data; the new category appears in the keyboard's category bar.
• Rename a category: tap or long-press it in the category list → "Rename" → enter a new name → refresh keyboard data.
• Delete a category: long-press it → "Delete category" → all its content is deleted too (confirm if prompted) → refresh keyboard data.
• "Temp Clipboard" is a built-in category that cannot be deleted or renamed.

12. Keyboard data limits

To keep the keyboard extension fast and responsive, limits are: 32,768 characters (~32 KB) per item, 80-character previews, a 512 KB total snapshot, and 20 items each in the Recent/Frequent bars.

When exceeded: a single item over 32 KB is truncated; if the snapshot exceeds 512 KB, empty category tabs are kept first (to preserve the top bar) and then each category's content is trimmed in order until it fits; trimmed content is not removed from the project, it just does not show in the keyboard.

• Put frequently used content in its own text-collection project and use it as the data source to avoid heavy trimming.
• Clean expired content out of Temp Clipboard regularly.
• The Recent and Frequent bars are configured in the text-collection project; the keyboard only displays them and does not generate them.

13. Permissions & privacy

On iOS, the kexu keyboard requires "Allow Full Access" (an iOS restriction on third-party keyboard extensions).

Why Full Access is needed: to read saved text from kexu for display, insert tapped text into the current field, watch the clipboard for auto-save, and sync data between the extension and the app.

Without Full Access: the extension cannot read content (empty list), cannot insert text, and the save-copies feature is unavailable.

• Privacy promises: kexu never records or uploads what you type in other apps; it only reads content you actively save in kexu; clipboard watching works only while "Save copies to paste" is on and saves only to the local project; it does not collect typing habits or sensitive information.
• Storage: all data stays on the device and is never uploaded; the extension reads the project database through shared storage without copying or moving data; auto-saved copies are written directly into the project, sharing one database with the app.
• Data sharing: the extension and the app belong to the same developer and share the same App Group; data is not shared with third parties.
• Uninstalling kexu removes the keyboard extension and clears local data; removing the keyboard in Settings stops the extension but does not affect the app's data.

14. FAQ

Cannot find the kexu keyboard: add it in Settings as in Section 1 (iOS: Settings → General → Keyboard → Keyboards → Add New Keyboard → kexu; Android: Settings → System → Languages & input → Virtual keyboard → Manage keyboards → enable kexu Paste).

"Full Access required" and unusable: on iOS enable it at Settings → General → Keyboard → Keyboards → kexu → Allow Full Access.

No project in "Save copies to": create at least one text-collection project in Quick Notes first; only such projects can be save targets.

Cannot enable "Save copies to paste" (prompt to choose a project): choose a save target on the Quick Keyboard page first.

Empty content list after switching: you may have no project or content, or you have not refreshed; add content and tap "Refresh keyboard data".

• Editing in the keyboard does not change the app: the keyboard cannot edit directly; do all add/edit/delete in the app, then refresh.
• App changes do not reach the keyboard: go back to Quick Keyboard and tap "Refresh keyboard data" to sync to the extension.
• Tapping an item does not insert: check Full Access (iOS), confirm the field supports pasting (some password/special fields restrict third-party keyboards), or switch to the system keyboard and back.
• Saving is on but copies are not saved: the app is not in the background, the copied content is not plain text, or the switch in the "More" menu is off.
• Temp Clipboard vs. save-copies: when on, copied text is saved to the selected project's Temp Clipboard, viewable and insertable from that keyboard tab.
• Is saved content uploaded to the cloud? No — everything stays local; the keyboard is offline and collects neither input nor copied content.
• Can you delete an item in the keyboard? Not yet — delete it in the app (long-press or swipe), then refresh.
• Some apps (e.g. banking or password managers) disable third-party keyboards for security; that is the app's own policy and cannot be bypassed — switch to the system keyboard there.
• Keyboard disappears after an iOS update: updates can reset extension permissions; re-check the keyboard list and confirm Full Access.
• Android keyboard exits after switching: possibly low memory; add the app to the background whitelist, disable power-saving mode, and reduce background apps.
• Supports iPad / Android tablets: usage matches phones, with the layout adapting to the screen size.

15. Device requirements & limits

Permissions: iOS needs "Allow Full Access" (required, for reading content, inserting text, and watching the clipboard); clipboard access is optional and used only while saving is on.

Limits: 32,768 characters per item, 80-character previews, 512 KB snapshot, 20 items in each of Recent/Frequent, one save target, and unlimited categories (bounded by snapshot size).

Device & system: iOS 14.0+, Android 7.0+; iPhone, iPad, iPod touch, Android phones and tablets; leave at least about 10 MB of storage.