Metadata-Version: 2.4
Name: quickpad
Version: 0.1.5
Summary: Pop-up scratchpad on numpad-minus double-tap-and-hold
Author: you
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pynput>=1.7.6
Requires-Dist: pystray>=0.19.5
Requires-Dist: Pillow>=9.0.0
Provides-Extra: cloud
Requires-Dist: pymongo[srv]>=4.0; extra == "cloud"

# QuickPad

A pop-up scratchpad bound to **double-tap-and-hold** on the numpad minus key.
Release the key and the window disappears. Use it to keep Telethon docs,
API snippets, half-finished thoughts, or whatever else close at hand.

## Install

```bat
pip install quickpad
```

## Run once

```bat
python -m quickpad
```

## Install as a Windows auto-start service

```bat
python -m quickpad --install
```

This writes `HKCU\Software\Microsoft\Windows\CurrentVersion\Run\QuickPad`
pointing at `pythonw.exe -m quickpad --tray`. From then on, QuickPad starts
silently on every logon, sits in the system tray, and waits for the gesture.

To remove it:

```bat
python -m quickpad --uninstall
```

## Usage

1. Double-tap and **hold** the `-` key on the numpad.
2. Window appears with your saved docs in the sidebar.
3. Click a doc (or use the search bar) to open it.
4. Type — autosave fires after ~1.5s of idle.
5. Release the `-` key — window hides.
6. Right-click the tray icon to show / hide / quit.

## Gestures

| Gesture | Action |
|---|---|
| Double-tap + hold numpad `-` | Peek (hides when key released) |
| Triple-tap numpad `-` | Pin (window stays open) |
| Triple-tap again | Unpin + hide |

## Storage

Docs are stored in `%APPDATA%\QuickPad\docs.db` (a SQLite file with FTS5
search). Backing up = copying that file.

## Cloud sync (optional)

```bat
quickpad --set-mongo "mongodb+srv://..."
```

Install with MongoDB support:

```bat
pip install "quickpad[cloud]"
```

## CLI reference

```
quickpad --tray          Run with system-tray icon
quickpad --install       Register Windows auto-start
quickpad --uninstall     Remove Windows auto-start
quickpad --status        Check if auto-start is registered
quickpad --set-mongo URL Save MongoDB URL to config
quickpad --clear-mongo   Remove MongoDB URL
quickpad --config        Show current config
quickpad --verbose       Print key events and gesture decisions
```
