How riyanj220/pookie-paste works
Pookie Paste is a Linux clipboard-history application. A global shortcut opens its UI; users browse text and image clips, manage pins or deletions, and activate an item for clipboard restoration and, where supported, focus restoration and direct paste. The daemon handles capture, history, IPC, shortcut/platform services, and activation; storage persists metadata and images. The UI and daemon communicate over IPC. Major capability branches are represented, but many platform adapters and UI details are unsampled, so uncertain implementation links are omitted.
Main entry points: app.rs History popup · activation_service.rs Item activation · main.rs Daemon runtime · service.rs History service
Components 27
Popup UI
- History popup
crates/ui/src/app.rs - Clip rows
crates/ui/src/rows.rs - Clip actions
crates/ui/src/actions.rs - Shortcut settings
crates/ui/src/shortcut_view.rs - Image previews
crates/ui/src/image_thumbnail.rs - Popup platform
crates/ui/src/platform/mod.rs - Theme and style
crates/ui/src/ui_style.rs
Daemon services
- Daemon runtime
crates/daemon/src/main.rs - Request handler
crates/daemon/src/request_handler.rs - Clipboard capture
crates/daemon/src/clipboard_service.rs - Clipboard state
crates/daemon/src/clipboard_state.rs - Item activation
crates/daemon/src/activation_service.rs
Clipboard history
- History service
crates/history/src/service.rs - History repository
crates/storage/src/repository.rs - SQLite database
crates/storage/src/database.rs - Image store
crates/storage/src/image_store.rs - Content processing
crates/pookie-core/src/processor.rs
Platform integration
- Native clipboard
crates/pookie-clipboard/src/backend.rs - Clipboard watcher
crates/pookie-clipboard/src/watcher.rs - Global shortcut
crates/daemon/src/shortcut_listener.rs - Focus backends
crates/daemon/src/focus_backend.rs - Paste backends
crates/daemon/src/paste_backend.rs
IPC transport
- IPC server
crates/daemon/src/ipc_server.rs - IPC protocol handler
crates/daemon/src/request_handler.rs - UI IPC client
crates/ui/src/ipc_client.rs - IPC client and protocol
crates/ipc/src/client.rs
Other components
- Desktop user
Connections 27
- Desktop user → History popup: opens popup
README.md - History popup → Clip rows: renders history
crates/ui/src/app.rs - Clip rows → Image previews: renders previews
crates/ui/src/rows.rs - History popup → Clip actions: dispatches actions
crates/ui/src/app.rs - History popup → Shortcut settings: renders settings
crates/ui/src/app.rs - History popup → Popup platform: requests focus
crates/ui/src/app.rs - History popup → Theme and style: applies style
crates/ui/src/main.rs - Desktop user → Global shortcut: presses hotkey
README.md - Daemon runtime → IPC server: starts server
crates/daemon/src/main.rs - IPC server → IPC protocol handler: dispatches requests
- History popup → UI IPC client: requests history
crates/ui/src/app.rs - UI IPC client → IPC client and protocol: sends requests
crates/ui/src/ipc_client.rs - IPC client and protocol → IPC server: connects over socket
crates/ipc/src/client.rs - IPC protocol handler → History service: manages history
crates/daemon/src/request_handler.rs - IPC protocol handler → Item activation: activates clip
crates/daemon/src/request_handler.rs - Item activation → History service: loads clip
crates/daemon/src/activation_service.rs - Item activation → Native clipboard: restores content
crates/daemon/src/activation_service.rs - Item activation → Focus backends: restores focus
README.md - Item activation → Paste backends: pastes content
README.md - Daemon runtime → Clipboard capture: starts capture
crates/daemon/src/main.rs - Clipboard capture → Clipboard state: tracks clipboard
crates/daemon/src/clipboard_service.rs - Clipboard capture → Clipboard watcher: observes changes
- Daemon runtime → Content processing: processes events
crates/daemon/src/main.rs - History service → History repository: persists records
crates/history/src/service.rs - History service → Image store: stores image data
crates/history/src/service.rs - History repository → SQLite database: uses database
crates/storage/src/database.rs - Daemon runtime → Global shortcut: starts listener
crates/daemon/src/main.rs