Guide
How to use Tameo
Tameo lives in the menu bar (no Dock icon). The basics: press ⌘⇧V to open the palette, then press a number key to paste. On first use only, you’ll be asked to grant Accessibility permission so Tameo can paste for you (System Settings › Privacy & Security › Accessibility).
Keyboard
| ⌘⇧V | Open/close the history palette at your cursor |
| 1 – 0 | Paste the numbered row (0 = the 10th) |
| ↑ ↓ | Move between rows (pages at the edges) |
| ← → / [ ] | Turn pages |
| ⇥ | Switch between History and Snippets |
| (type) | Just start typing to search your history (Japanese IME supported) |
| ⌘P | Pin the selected item to the top |
| ⌘⌫ | Delete the selected item |
| esc | Clear the search / close the palette |
Three ways to paste
The same item pastes differently depending on the modifier you hold.
| Number (1–0) | Paste as-is (keeps original formatting) |
| ⌥ + number | Paste plain text (strips rich formatting; pastes OCR text for images) |
| ⌃ + number | Paste with the transforms below applied |
Transform paste (⌃ + number)
Turn on the transforms you want in Settings › General › Paste Transform. In the palette, hold ⌃ and press a number (or ⌃ + Return) to paste plain text with the checked transforms applied in order. Your history is never modified — only the pasted copy.
| Full-width → half-width | Full-width letters, digits and symbols to half-width (kana/kanji untouched). On by default |
| Strip URL tracking | Remove utm_* / fbclid / gclid-style tracking params. On by default |
| Tidy whitespace | Trim and join lines into single spaces (handy for PDF copy). Off by default |
Examples
Ｔａｍｅｏ ０１２３ → Tameo 0123
https://example.com/a?utm_source=mail&id=42 → https://example.com/a?id=42
Search & image OCR
Open the palette and just type to search your whole history. Japanese IME input works, and full/half-width and hiragana/katakana variants all match. On top of that, copied images and screenshots are run through on-device OCR, so you can search the text inside them. Select an image and press ⌥ + number to paste the recognized text. Everything happens on your Mac.
Snippets
Press ⌘⇧B to open your snippets (or ⇥ while the palette is open). Pick a folder and paste a snippet with a number key. Create and edit snippets in Settings › Snippets. Coming from Clipy? Import your Clipy export file as-is.
Privacy & encryption
Your history is stored only on your Mac and never sent anywhere. On top of that, the history database is always encrypted at rest with AES-GCM (the key is kept in your Keychain, with no off switch). Items that password managers mark as concealed (copies from 1Password and the like) are never saved. In Settings you can also choose which data types to keep and which apps to exclude.