Metadata-Version: 2.4
Name: jot-history
Version: 1.0.0
Summary: A fast terminal clipboard history manager with image support
Home-page: https://github.com/dhruv-0512/jot
Author: Dhruv
Author-email: dhruvh3vedi@gmail.com
License: MIT
Project-URL: Source, https://github.com/dhruv-0512/jot
Project-URL: Issues, https://github.com/dhruv-0512/jot/issues
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1
Requires-Dist: rich>=13.0
Requires-Dist: pyperclip>=1.8
Requires-Dist: Pillow>=10.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# jot 📋

A lightweight clipboard history manager for the terminal. Tracks everything you copy — text and images — so you never lose something you copied 10 minutes ago.

## Features

- Saves clipboard history automatically in the background
- Supports both text and images
- Images auto-expire from `/tmp/jot/` on reboot — no clutter
- Deduplicates entries by content hash
- Simple, fast commands you'll actually use daily

## ⚠️ Privacy Notice

jot stores your full clipboard history including any sensitive data (passwords, tokens, auth codes). The database at `~/.jot/history.db` is unencrypted. Don't use on shared machines without understanding this.

## Installation

```bash
git clone https://github.com/yourusername/jot.git
cd jot
pip install -e .
```

Then start the daemon:

```bash
jot daemon start
```

## Usage

```bash
jot ls                  # show last 20 clipboard entries
jot ls --n 50           # show last 50 entries
jot get <n>             # copy entry #n back to clipboard
jot search <query>      # search text history
jot clear               # wipe all history
```

### Daemon

```bash
jot daemon start        # start background clipboard watcher
jot daemon stop         # stop the watcher
jot daemon status       # check if running
```

## How it works

`jot daemon start` forks a background process that polls your clipboard every 500ms. New entries are saved to a local SQLite database at `~/.jot/history.db`.

- **Text** entries are stored directly in the DB, capped at 500
- **Image** entries are saved as PNGs to `/tmp/jot/`, path stored in DB, capped at 50. If an image has expired, `jot ls` shows `[image expired]`

## Project Structure

```
jot/
├── jot.py        # CLI entrypoint and all commands
├── daemon.py     # background clipboard watcher
├── storage.py    # SQLite wrapper
└── setup.py      # package config
```

## Requirements

- Python 3.8+
- `click`
- `rich`
- `pyperclip`
- `Pillow`

## License

MIT
