# DeskCapsule support

Support: [https://sovrest.com/profile/support](https://sovrest.com/profile/support).

## What to include

- DeskCapsule version and whether the build is Release or DEV PRO;
- Windows version, display count, scaling and primary display;
- exact steps and expected/actual result;
- the smallest redacted screenshot or bounded diagnostics file that demonstrates the issue.

Do not send license keys, access or refresh tokens, clipboard history, notes, screenshots containing private data, voice audio, transcripts, translation text or chat prompts in the first message.

## Local data capacity

All license states use the same technical safety maxima: 500 clipboard entries, 100 pinned entries, 250 screenshots and 500 notes. Capacity does not change with the license. At the clipboard or screenshot maximum, a new item rotates the oldest eligible item. At the note maximum, delete a note before creating another.

## Capsule or monitor issues

Use Settings to select Automatic, Primary or a specific monitor. Automatic follows the active-window policy; explicit Show uses the configured monitor and must not oscillate between displays. If the capsule is hidden, launch DeskCapsule again or use the configured show hotkey. Include display topology and DPI when reporting jumps or clipped controls.

## Clipboard is empty

Enable text capture in Settings, then copy new text. Capture is opt-in and may ignore privacy-marked or excluded source content. Images appear in Screenshots, not text history. Click an entry to copy it; use its pin and delete actions for management.

## Screenshot is missing

Enable image capture and copy a supported Windows bitmap. Check `%LOCALAPPDATA%\DeskCapsule\screenshots` or the isolated DEV PRO profile. Oversized, malformed or duplicate images can be rejected. The grid uses a fixed card size independent of item count.

## Notes

Create a note with the action above the list, provide a title and open the row to edit. Pin and delete are available directly in the list. If a note cannot be created, check the technical maximum and the profile directory permissions.

## Local translation

Free translation requires an installed and verified RU/EN model pack. If the model is missing, use the model-management action when available. Production model download remains unavailable until the signed catalog, artifact hashes, engine benchmark and notices are approved. Missing or invalid models must produce an actionable error without a network fallback.

## Pro AI translation

Cloud AI translation requires internet access, final SOVREST configuration and an active `Licensed` entitlement. Trial and Grace do not enable it. Connectivity, timeout, rate-limit and upstream failures may fall back to an installed local model. Authentication, entitlement, validation and policy errors do not.

If the cloud route remains unavailable in a production candidate, the remaining blocker is server-side enablement: Translate must be switched on for the final DeskCapsule application and the approved paid plan. A denial then arrives as a bounded entitlement error rather than as a translation.

## AI Chat

AI Chat is Pro-only. Its history remains in process memory and is cleared by New Chat or application exit. If it is unavailable, check active `Licensed` status, internet and production configuration. The feature must stay disabled until `/api/ai/chat` enforces paid DeskCapsule access server-side.

## Voice input

Enable voice input, install a verified Local Whisper model and choose a keyboard or mouse gesture. Supported gestures include modified keyboard shortcuts, `F1` to `F24`, middle mouse button, Mouse 4 and Mouse 5. Press once to start recording and again to stop and transcribe. The indicator should show recording and signal level.

Local Whisper is Free and offline after model installation. Pro cloud voice is implemented against the documented SOVREST `/api/ai/transcribe` contract and stays fail-closed until the final application metadata is embedded and STT is enabled for the approved paid plan. DeskCapsule has no personal provider-key field and does not use a direct Groq endpoint.

If recognition succeeds but insertion fails, keep focus in the same writable field from recording start through insertion. Password, read-only, elevated and unsupported targets are rejected. The modern packaged Windows 11 Notepad control `RichEditD2DPT` has a known Unicode insertion compatibility issue; use a browser field, Codex or legacy `Edit` while [KI-001](docs/KNOWN_ISSUES.md#ki-001-voice-insertion-in-modern-windows-11-notepad) remains open.

## Double Shift and automatic correction

Both features are independent opt-in settings. Double Shift converts a supported selected RU/EN token first, otherwise it changes the foreground thread layout. Automatic correction runs only after a supported delimiter and only when the completed token has a confident mapping. DeskCapsule does not synthesize `Win+Space` or `Win+L`.

Some elevated, password, read-only, virtualized or custom editor fields cannot be modified safely. If selection conversion fails, record the application and control type. Never repeatedly test global input against important unsaved work; use a disposable text document.

## License remains Free

Confirm that production SOVREST metadata is configured, the device time is correct and activation succeeded. DEV PRO is isolated and does not create a production license. Cloud entitlement requires exact `Licensed`; Trial and Grace intentionally remain local-only.

## Safe reset

Close DeskCapsule and rename `%LOCALAPPDATA%\DeskCapsule\settings.json` to a timestamped backup to reset settings without deleting content. For a complete reset, use Settings, Local data, preview the selected categories and confirm wipe. Do not recursively delete `%LOCALAPPDATA%`.

A legacy `groq.credential` file from an earlier development build is removed automatically without being read. There is no supported personal Groq credential to manage.

See [PRIVACY.md](PRIVACY.md), [SECURITY.md](SECURITY.md), [LOCAL_TESTING.md](docs/LOCAL_TESTING.md) and [KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md).
