# riyanj220/pookie-paste architecture

> Architecture diagram of the GitHub repository riyanj220/pookie-paste, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/riyanj220/pookie-paste
- Repository: https://github.com/riyanj220/pookie-paste

## Overview

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: [`crates/ui/src/app.rs`](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/app.rs) (History popup), [`crates/daemon/src/activation_service.rs`](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/activation_service.rs) (Item activation), [`crates/daemon/src/main.rs`](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/main.rs) (Daemon runtime), [`crates/history/src/service.rs`](https://github.com/riyanj220/pookie-paste/blob/main/crates/history/src/service.rs) (History service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Popup UI"]
  node_ui_app["History popup<br/>[app.rs]"]
  node_ui_rows["Clip rows<br/>[rows.rs]"]
  node_ui_actions["Clip actions<br/>[actions.rs]"]
  node_ui_shortcut["Shortcut settings<br/>[shortcut_view.rs]"]
  node_ui_thumbs["Image previews<br/>[image_thumbnail.rs]"]
  node_ui_popup["Popup platform<br/>[mod.rs]"]
  node_ui_style["Theme and style<br/>[ui_style.rs]"]
end

subgraph group_daemon["Daemon services"]
  node_daemon["Daemon runtime<br/>[main.rs]"]
  node_handler["Request handler<br/>[request_handler.rs]"]
  node_capture["Clipboard capture"]
  node_clip_state["Clipboard state<br/>[clipboard_state.rs]"]
  node_activation["Item activation"]
end

subgraph group_history["Clipboard history"]
  node_history_service["History service<br/>[service.rs]"]
  node_repository["History repository<br/>[repository.rs]"]
  node_database[("SQLite database<br/>[database.rs]")]
  node_images[("Image store<br/>[image_store.rs]")]
  node_core["Content processing<br/>[processor.rs]"]
end

subgraph group_platform["Platform integration"]
  node_clipboard["Native clipboard<br/>[backend.rs]"]
  node_watcher["Clipboard watcher<br/>[watcher.rs]"]
  node_shortcuts["Global shortcut"]
  node_focus["Focus backends<br/>[focus_backend.rs]"]
  node_paste["Paste backends<br/>[paste_backend.rs]"]
end

subgraph group_ipc["IPC transport"]
  node_socket["IPC server<br/>[ipc_server.rs]"]
  node_ipc_handler["IPC protocol handler<br/>[request_handler.rs]"]
  node_ui_client["UI IPC client<br/>[ipc_client.rs]"]
  node_ipc_library["IPC client and protocol<br/>[client.rs]"]
end

node_user(("Desktop user"))

node_user -->|"opens popup"| node_ui_app
node_ui_app -->|"renders history"| node_ui_rows
node_ui_rows -->|"renders previews"| node_ui_thumbs
node_ui_app -->|"dispatches actions"| node_ui_actions
node_ui_app -->|"renders settings"| node_ui_shortcut
node_ui_app -->|"requests focus"| node_ui_popup
node_ui_app -.->|"applies style"| node_ui_style
node_user -->|"presses hotkey"| node_shortcuts
node_daemon -->|"starts server"| node_socket
node_socket -.->|"dispatches requests"| node_ipc_handler
node_ui_app -->|"requests history"| node_ui_client
node_ui_client -->|"sends requests"| node_ipc_library
node_ipc_library -.->|"connects over socket"| node_socket
node_ipc_handler -->|"manages history"| node_history_service
node_ipc_handler -.->|"activates clip"| node_activation
node_activation -->|"loads clip"| node_history_service
node_activation -.->|"restores content"| node_clipboard
node_activation -.->|"restores focus"| node_focus
node_activation -.->|"pastes content"| node_paste
node_daemon -.->|"starts capture"| node_capture
node_capture -->|"tracks clipboard"| node_clip_state
node_capture -.->|"observes changes"| node_watcher
node_daemon -.->|"processes events"| node_core
node_history_service -->|"persists records"| node_repository
node_history_service -->|"stores image data"| node_images
node_repository -.->|"uses database"| node_database
node_daemon -.->|"starts listener"| node_shortcuts

click node_ui_app "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/app.rs"
click node_ui_rows "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/rows.rs"
click node_ui_actions "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/actions.rs"
click node_ui_shortcut "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/shortcut_view.rs"
click node_ui_thumbs "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/image_thumbnail.rs"
click node_ui_popup "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/platform/mod.rs"
click node_ui_style "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/ui_style.rs"
click node_daemon "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/main.rs"
click node_handler "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/request_handler.rs"
click node_capture "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/clipboard_service.rs"
click node_clip_state "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/clipboard_state.rs"
click node_activation "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/activation_service.rs"
click node_history_service "https://github.com/riyanj220/pookie-paste/blob/main/crates/history/src/service.rs"
click node_repository "https://github.com/riyanj220/pookie-paste/blob/main/crates/storage/src/repository.rs"
click node_database "https://github.com/riyanj220/pookie-paste/blob/main/crates/storage/src/database.rs"
click node_images "https://github.com/riyanj220/pookie-paste/blob/main/crates/storage/src/image_store.rs"
click node_core "https://github.com/riyanj220/pookie-paste/blob/main/crates/pookie-core/src/processor.rs"
click node_clipboard "https://github.com/riyanj220/pookie-paste/blob/main/crates/pookie-clipboard/src/backend.rs"
click node_watcher "https://github.com/riyanj220/pookie-paste/blob/main/crates/pookie-clipboard/src/watcher.rs"
click node_shortcuts "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/shortcut_listener.rs"
click node_focus "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/focus_backend.rs"
click node_paste "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/paste_backend.rs"
click node_socket "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/ipc_server.rs"
click node_ipc_handler "https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/request_handler.rs"
click node_ui_client "https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/ipc_client.rs"
click node_ipc_library "https://github.com/riyanj220/pookie-paste/blob/main/crates/ipc/src/client.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui_app,node_ui_rows,node_ui_actions,node_ui_shortcut,node_ui_thumbs,node_ui_popup,node_ui_style,node_user toneBlue
class node_daemon,node_handler,node_capture,node_clip_state,node_activation toneAmber
class node_history_service,node_repository,node_database,node_images,node_core toneMint
class node_clipboard,node_watcher,node_shortcuts,node_focus,node_paste toneRose
class node_socket,node_ipc_handler,node_ui_client,node_ipc_library toneIndigo
```

## Components

### Popup UI

- [History popup](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/app.rs): `crates/ui/src/app.rs`
- [Clip rows](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/rows.rs): `crates/ui/src/rows.rs`
- [Clip actions](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/actions.rs): `crates/ui/src/actions.rs`
- [Shortcut settings](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/shortcut_view.rs): `crates/ui/src/shortcut_view.rs`
- [Image previews](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/image_thumbnail.rs): `crates/ui/src/image_thumbnail.rs`
- [Popup platform](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/platform/mod.rs): `crates/ui/src/platform/mod.rs`
- [Theme and style](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/ui_style.rs): `crates/ui/src/ui_style.rs`

### Daemon services

- [Daemon runtime](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/main.rs): `crates/daemon/src/main.rs`
- [Request handler](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/request_handler.rs): `crates/daemon/src/request_handler.rs`
- [Clipboard capture](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/clipboard_service.rs): `crates/daemon/src/clipboard_service.rs`
- [Clipboard state](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/clipboard_state.rs): `crates/daemon/src/clipboard_state.rs`
- [Item activation](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/activation_service.rs): `crates/daemon/src/activation_service.rs`

### Clipboard history

- [History service](https://github.com/riyanj220/pookie-paste/blob/main/crates/history/src/service.rs): `crates/history/src/service.rs`
- [History repository](https://github.com/riyanj220/pookie-paste/blob/main/crates/storage/src/repository.rs): `crates/storage/src/repository.rs`
- [SQLite database](https://github.com/riyanj220/pookie-paste/blob/main/crates/storage/src/database.rs): `crates/storage/src/database.rs`
- [Image store](https://github.com/riyanj220/pookie-paste/blob/main/crates/storage/src/image_store.rs): `crates/storage/src/image_store.rs`
- [Content processing](https://github.com/riyanj220/pookie-paste/blob/main/crates/pookie-core/src/processor.rs): `crates/pookie-core/src/processor.rs`

### Platform integration

- [Native clipboard](https://github.com/riyanj220/pookie-paste/blob/main/crates/pookie-clipboard/src/backend.rs): `crates/pookie-clipboard/src/backend.rs`
- [Clipboard watcher](https://github.com/riyanj220/pookie-paste/blob/main/crates/pookie-clipboard/src/watcher.rs): `crates/pookie-clipboard/src/watcher.rs`
- [Global shortcut](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/shortcut_listener.rs): `crates/daemon/src/shortcut_listener.rs`
- [Focus backends](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/focus_backend.rs): `crates/daemon/src/focus_backend.rs`
- [Paste backends](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/paste_backend.rs): `crates/daemon/src/paste_backend.rs`

### IPC transport

- [IPC server](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/ipc_server.rs): `crates/daemon/src/ipc_server.rs`
- [IPC protocol handler](https://github.com/riyanj220/pookie-paste/blob/main/crates/daemon/src/request_handler.rs): `crates/daemon/src/request_handler.rs`
- [UI IPC client](https://github.com/riyanj220/pookie-paste/blob/main/crates/ui/src/ipc_client.rs): `crates/ui/src/ipc_client.rs`
- [IPC client and protocol](https://github.com/riyanj220/pookie-paste/blob/main/crates/ipc/src/client.rs): `crates/ipc/src/client.rs`

### Other components

- **Desktop user**

## Connections

- Desktop user → History popup: opens popup (evidence: `README.md`)
- History popup → Clip rows: renders history (evidence: `crates/ui/src/app.rs`)
- Clip rows → Image previews: renders previews (evidence: `crates/ui/src/rows.rs`)
- History popup → Clip actions: dispatches actions (evidence: `crates/ui/src/app.rs`)
- History popup → Shortcut settings: renders settings (evidence: `crates/ui/src/app.rs`)
- History popup → Popup platform: requests focus (evidence: `crates/ui/src/app.rs`)
- History popup → Theme and style: applies style (evidence: `crates/ui/src/main.rs`)
- Desktop user → Global shortcut: presses hotkey (evidence: `README.md`)
- Daemon runtime → IPC server: starts server (evidence: `crates/daemon/src/main.rs`)
- IPC server → IPC protocol handler: dispatches requests
- History popup → UI IPC client: requests history (evidence: `crates/ui/src/app.rs`)
- UI IPC client → IPC client and protocol: sends requests (evidence: `crates/ui/src/ipc_client.rs`)
- IPC client and protocol → IPC server: connects over socket (evidence: `crates/ipc/src/client.rs`)
- IPC protocol handler → History service: manages history (evidence: `crates/daemon/src/request_handler.rs`)
- IPC protocol handler → Item activation: activates clip (evidence: `crates/daemon/src/request_handler.rs`)
- Item activation → History service: loads clip (evidence: `crates/daemon/src/activation_service.rs`)
- Item activation → Native clipboard: restores content (evidence: `crates/daemon/src/activation_service.rs`)
- Item activation → Focus backends: restores focus (evidence: `README.md`)
- Item activation → Paste backends: pastes content (evidence: `README.md`)
- Daemon runtime → Clipboard capture: starts capture (evidence: `crates/daemon/src/main.rs`)
- Clipboard capture → Clipboard state: tracks clipboard (evidence: `crates/daemon/src/clipboard_service.rs`)
- Clipboard capture → Clipboard watcher: observes changes
- Daemon runtime → Content processing: processes events (evidence: `crates/daemon/src/main.rs`)
- History service → History repository: persists records (evidence: `crates/history/src/service.rs`)
- History service → Image store: stores image data (evidence: `crates/history/src/service.rs`)
- History repository → SQLite database: uses database (evidence: `crates/storage/src/database.rs`)
- Daemon runtime → Global shortcut: starts listener (evidence: `crates/daemon/src/main.rs`)
