English · Русский · Deutsch · Español · 日本語
Desktop utility that watches the clipboard and appends the copied text from Chromium browsers and Electron-based desktop AI apps to the .docx / .md / .txt file of the selected project. Works on Windows; Linux / WSL / macOS support is experimental.
Safety note: The Windows installer is verified by VirusTotal. No threats were detected. The source code is open and auditable.
ChatClipper is a lightweight utility that automatically saves your chats with AI assistants (DeepSeek, ChatGPT and similar) into a single project file. No more manual copy-paste — the program does it for you.
- Watches the clipboard and detects Copy in Chromium browsers and Electron-based desktop AI apps.
- Appends the copied text to the project file (.docx / .md / .txt).
- Supports multiple projects with one main project.
- Works in the background — lives in the system tray.
- First run creates a default project at
~/ChatClipperwith an empty file that already has a heading — you can start copying right away. - A ticking clock sound plays while the app is waiting for a copy — this means the app is running and ready.
- Clipboard watcher on LMB click in Chromium browsers and Electron-based desktop AI apps
- Detects copy via the Copy button, mouse click, or Ctrl+C
- Append text to project files: docx, md, txt
- Markdown parsing (mistune): headings, bold, italic, inline code, code blocks, lists, quotes, tables
- Optional Pandoc converter (fallback to mistune on failure)
- Timestamp stamp and separator line before each block
- Multiple projects with one main project; project format is per-project
- Popup window to pick a project (opacity and duration configurable)
- Clicking a non-main project in the popup silently makes it main
- Startup status popup; PAUSE stamp when paused
- Single click on the PAUSE stamp resumes tracking
- In the status window, a click on the main project button pauses tracking
- Duplicate suppression via CRC32 ring (5 last values)
- Undo last write: removes it from source .docx and moves it to another project; respects undo_max_text_len and skip_secrets
- Buffered .docx writes: flushed every 5 s or on exit
- Pending queue when target file is busy
- Content loss check (loss_threshold_pct + loss_min_abs_chars)
- IPC: named pipe on Windows, Unix socket on POSIX, with token auth
- Tray icon (Windows) or Tk control panel (Linux / WSL / macOS)
- Autostart (off by default)
- Tray enabled (off by default; Windows only)
- Single instance guard (mutex / file lock)
- Light and dark themes, switchable from the settings header (☀ / 🌙)
- Update check: manual button and background check at startup (GitHub Releases)
- i18n: English, Russian, German, Spanish, Japanese
- Auto-detect from OS locale on first run
- Add a new language by dropping
locales/<code>.jsonwith"lang.name" - Window icon: chatclipper-light.ico / chatclipper-dark.ico (follows the theme)
- Windows 10/11 (Linux / macOS — experimental)
- Python 3.10+
- LibreOffice or MS Word for editing .docx
- A Chromium-based browser or an Electron-based desktop AI app as clipboard source
- Optional: Pandoc in PATH for Markdown → docx
git clone https://github.com/vldbkov/chat-clipper.git
cd chat-clipper
uv venv
uv pip install -r requirements.txt
uv run python main.py
git clone https://github.com/vldbkov/chat-clipper.git
cd chat-clipper
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python main.py
Download chatclipper-setup.exe from the latest release and run it.
No Python installation required.
After install, the tray icon appears (Windows).
On first launch ChatClipper automatically creates a default project at
~/ChatClipper (your user home folder) with an empty Word file that
already contains a heading. No setup needed — just start copying.
- Open a chat with an AI (DeepSeek, ChatGPT, Qwen, GLM and similar) in a Chromium-based browser or an Electron-based desktop AI app.
- Copy the reply in one of two ways:
- click the Copy button shown in the chat UI (recommended — it also preserves HTML formatting), or
- select the text and press Ctrl+C on the keyboard.
- A popup appears in a second with the project choice — click the one you want, or let it auto-close (the main project is used).
- Open the project file in Word — the text is there (writes are delayed by about 5 seconds).
- To add more projects: ChatClipper panel → Settings → Add. Set one project as main — writes go there by default.
- To switch theme: Settings → button ☀ / 🌙 in the header. The theme applies to all windows (settings, panel, popup, dialogs) and the app icon.
- To check for updates: Settings → Check for updates, or wait for the automatic check at startup. The update dialog links to the latest GitHub release.
main.py — entry point, chooses tray vs GUI mode
app_state.py — shared AppState, single instance
tray_process.py — tray (pystray), menu, handlers
gui_process.py — Tk mainloop, mouse hook, IPC server
control_panel.py — Tk control panel instead of tray
actions.py — IPC action registry (ACTIONS dict)
ipc_server.py — IPC server (pipe/socket, token)
ipc_client.py — IPC client
config.py — Project, AppConfig, config.json
logger.py — logging + SafeStream
single_instance.py — mutex / fcntl
autostart.py — registry / .desktop / plist
platform_utils.py — OS wrappers (clipboard, active window, pandoc)
clipboard.py — wrapper over platform_utils
mouse_hook.py — pynput, source factory, click window
hashes.py — CRC32 ring, hashes.json
docx_writer.py — buffered writer, stamp, pending queue
markdown_to_docx.py — mistune AST -> python-docx
html_to_docx.py — html4docx (rarely used)
undo.py — remember / undo_last, last_buffers.json
project_service.py — single entry point for write_to_project
writers/ — writer_base, writer_docx, writer_md,
writer_txt, writer_factory
sources/ — source_base, source_chrome,
source_desktop_chat, source_factory
gui_settings.py — SettingsWindow, ProjectDialog
gui_popup.py — PopupWindow (choice / status)
gui_undo.py — UndoDialog
ui_helpers.py — center_window, drag helpers, apply_icon
i18n.py — t(key), init, set_locale, list_languages
locales/ — en.json, ru.json, de.json, es.json, ja.json
pytest.ini — testpaths = tests
tests/ — unit tests for core layer
config.json — settings and projects
hashes.json — ring of last CRC32 values
last_buffers.json — last / prev writes for undo
logging/ — chatclipper.log (rotated)
pending/ — queued texts when .docx is busy
ipc_token — shared IPC token (mode 0600 on POSIX)
chatclipper.sock — Unix socket endpoint (POSIX only)
chatclipper-light.ico — app / tray icon
Each project has a name, a folder, a file name and a format
(docx / md / txt). Default file name is <ProjectName>-chat.<fmt>.
One project is the main one — writes go there by default.
The main project can be switched from the popup, from the status popup,
or from the settings window.
After a copy, the target file is not updated immediately: changes are buffered and flushed every ~5 seconds or when the app exits. If the file is open in Word / LibreOffice, it will not reflect the new content on the fly — close and reopen it to see new entries.
ChatClipper remembers how many paragraphs it added on the last write, and on undo removes exactly that many. If you manually add, delete or change paragraphs at the end of the file after a write, the undo will remove the last paragraphs by count, not the ones the utility wrote. Possible outcomes:
- Your manual text disappears — the utility counts it as its own.
- Part of the utility's entry remains in the file.
Rule: if you need undo — do not touch the .docx between write and undo. If you did edit it manually, skip undo and copy the text again.
- Windows 10/11 — tray icon, autostart via registry, IPC over named pipe.
- Linux / WSL / macOS — experimental: Tk control panel, IPC over Unix socket.
- Create
locales/<code>.jsonwith the same keys aslocales/en.json. - Include
"lang.name": "<NativeName>"— the settings dropdown and the OS-locale autodetect read it from the file. - No code or config changes needed.
| Problem | Solution |
|---|---|
| Text is not saved | Click the Copy button in the chat, or select text and press Ctrl+C; make sure a Chromium browser or an Electron-based desktop AI app is the active window |
| File is not updated | Wait ~5 s, or close and reopen the file (buffered writes) |
| Ticking sound bothers me | Disable it in Settings → Sound, or pick a quieter .wav |
| Tray icon not visible | Check Windows tray settings; ensure ChatClipper is running |
| Undo removed wrong text | Do not edit the .docx manually between write and undo |
| Language not detected | Set language manually in Settings |
Copyright (©) 2026, Vladimir Baykov. Licensed under the MIT License.