Image Preview

A free, open-source, community-minded plugin for Tavo.

Image Preview lets you preview and pin images over your chat, read a character card as one scrollable page with its pictures, look at a web page's pictures and words without leaving Tavo, quickly look up text, and play a few small games while waiting for a reply — all while keeping your data on your own device.

Features

• 🖼️ Image Preview & Pinning

  • Preview an image link or a webpage link.
  • If a link fails, it automatically tries other images the page points to until one loads. Ads and tracker hosts are skipped.
  • Works with JPG, PNG, WebP, AVIF, SVG and animated GIF.
  • Pin an image over the chat: drag to move, pinch or use +/- to resize, rotate and flip it. Up to 30 images can be pinned at once; remove one to pin another. (An older chat with more than 30 pins keeps the extra ones safe: they wait and come back one by one as you remove pins.)
  • Rename and manage your pins from the PINNED ON CHAT list.
  • Rename saved images and GIFs from their action sheet. Renaming only changes the label; the file is never touched.
  • Double-tap a pinned image, or tap a saved image, to open it fullscreen.
  • Save a copy for the chat, save straight to your device, or copy the original link.
  • Info button shows format, dimensions, file size and real source for any image.
  • Saving or pinning the same picture twice reuses the same file — no duplicates. Save selected, Save all and Import from device also skip anything that's already in Saved Previews.
  • Import images directly from your device.
  • Extract images from text: paste a wall of text or HTML into the chat input and tap "Extract images from text" in the input's + menu. It pulls out every image/GIF link, ignores the rest, and shows them as a picker (Select all / Select none, tap tiles to include or leave out). Save selected or Save all puts the new ones in Saved Previews (anything already saved is marked Saved and skipped).
  • Scan this chat for images: tap it in the panel (or in the chat's right sidebar) and it searches the chat for you: the character card, persona, lorebooks and the newest 5,000 messages, newest first. Everything it finds opens in the same picker as Extract (promo banners and one-pixel trackers are left out; a green bar lets you show them), with a summary of where the links came from and a Rescan button for after the chat changes. Pictures load a few at a time and retry on their own; tap a failed one to try again. Rescan always tells you what it found (nothing new, how many are new, or that it failed) and keeps the tiles you left out. No pasting needed.
  • Saved Previews Select mode: tap Select, pick any saved images, then Pin selected to put them on the chat, or Delete selected to send them to the Recycle Bin.
  • Saved Previews shows 200 images at a time; tap Show more at the end for the next batch, so nothing is out of reach.
  • Recycle Bin: deleting a saved image (or using Clear all) moves it to a global Recycle Bin instead of erasing it. Restore puts it into the chat you have open right now (it never switches chats); anything left alone clears itself out after 7 or 30 days. Each image's own countdown starts when it's deleted.
  • Clear all next to "Pinned on chat" unpins everything at once (it only unpins; saved copies stay).

• 📖 Character Page

  • Tap Character page in the panel (or in the chat's right sidebar) to read the open chat's character card as one scrollable page: creator notes, description, personality and scenario, with the pictures and GIFs right where the card put them — a bit like a bot's intro page.
  • Works with the rich text that Janitor-style cards use, and with Markdown or plain text. {{user}} and {{char}} are filled in. Lists (-, *, •, 1., with sub-lists) and quotes (>) show as real lists and quotes, and a card's own look is kept: text colours, backgrounds and gradients, borders, rounded corners, spacing, side-by-side rows, centered text, text sizes, bold, italic and underline. Text always stays readable (a colour that can't be read on its background is replaced), and nothing that could cover the page, hide text or load something from outside is carried over. Long runs of blank lines are squeezed.
  • Links show as small pills that open Page view (below).
  • Clean view leaves out promo banners, Discord/Patreon-style links, profile-link “creators”, one-pixel trackers and scraper stamps such as “[retrieved by …]”. A green bar shows how many items were hidden; tap Show all to see everything (links are never clickable there).
  • Pictures load only when you scroll close to them, stay hidden until fully loaded, and then fade in, so the page jumps much less.
  • Tap a picture to see it bigger. In a group chat, tap a name at the top to switch characters.
  • Opening it from the panel closes the panel, so only the page is on screen. Close it with ×, with Close at the bottom, or by tapping outside it.
  • It reads the card on your device only when you open it, and never changes it. See Privacy & Security below.

• 🌐 Page view

  • Look at a web page's pictures and words without leaving Tavo. Open it by tapping a link pill on the Character page, by pasting a link into the panel's link field and tapping 🌐 Page view, from the input's + menu (Preview a link), from the chat's right sidebar (Page view), or by tapping Preview on a web-search result.
  • Tap a picture to see it full screen; tick the circle in its corner to select it, then Save pictures keeps them in Saved Previews. Recent pages are remembered.
  • Image Chest links show the whole gallery: Page view reads the picture list the page keeps inside itself and shows 80 pictures at a time, then Show more.
  • Nothing on the page runs, and ads, trackers and banners are never loaded.
  • If a page only shows its pictures with JavaScript (so only its preview picture can be read), Page view says so. A free Tavily key can read those pages for you.

• 🔎 Quick Lookup

  • Translate text, look up word meanings, or search the web, without leaving the plugin panel.
  • Search can use an optional Brave key and/or a free Tavily key (no card needed). Tap Brave or Tavily to choose which one goes first; if it fails, the other is tried, then a free fallback.
  • Opened by a ⚓ anchor that hangs on a rope and sways on its own. Pull it down to open; tap it or pull it down again to close.

• 🎮 Game Corner

  • Game Library: pick a game from the list at the top of the game window.
  • Jump Game: the original runner, with score titles.
  • Snake: a round world (leave one edge, come back on the opposite one), Easy / Medium / Extreme modes, horror-style score titles, and a Points Store for skins, food and board looks. Swipe or on-screen arrow buttons.
  • Memory Bomb: a bomb timer, move targets, tricky card swaps, unlockable emoji sets, and a collectible wisdom library. Pausable, like Snake.
  • Add your own games: paste a game's HTML (or import an .html file). A built-in "Copy AI prompt" button helps you ask any AI to make a compatible game.
  • One ⚙ settings button per game: your player name (shared across games), that game's own options, and its own reset buttons — plus a "reset all games" option with a clear warning.
  • Progress is saved on your device.

• 🐵 Make it yours (the little monkey)

  • A small baby monkey sits next to the panel title. Poke him and he opens "Make it yours".
  • Wallpaper from your phone (shrunk to a sensible size so the panel stays quick) or from an image link, and how dark it is.
  • Panel background (Forest, Ocean, Sunset, Rose, Midnight, Aurora) and panel font (Default, Serif, Rounded, Monospace, Handwriting).
  • Floating button icon and color.
  • Text size (85% to 130%) with a preview and a default-size button.
  • Background motion: Static (default), Subtle, Enhanced or Off. Your phone's "reduce motion" setting is always respected, and nothing animates while the panel is closed.
  • A button that opens the Storage manager (below).
  • Everything applies right away, and one button returns to your defaults.

• ✨ Feel

  • Pop-ups, the panel and the game open and close with a smooth animation.
  • Buttons and cards give a little feedback when tapped.
  • A single ❔ Help button explains how everything works, in one place, with an About & support section (Terms of Use, Discord) and a short "If something won't close or open" tip.
  • Help and Game buttons hang and sway when pressed.

• ⚙️ Customization

  • Floating button size and opacity.
  • Floating button icon (Leaf, Classic, Moon, Star, Blossom, Butterfly, Wave, Orb) and color theme (Forest, Violet, Sunset, Ocean, Rose, Monochrome), now picked from the monkey's pop-up.
  • Default image size and opacity.
  • Remember pinned images.
  • Stealth mode.
  • Recycle Bin retention (7 or 30 days).
  • Languages: English and Bengali.

• 💾 Storage manager

  • Shows what Image Preview keeps on your phone, in plain words: saved previews, pins, Recycle Bin, temporary files, page history, lookup history, search keys, appearance and games.
  • Each part explains what it is, why it is needed and what happens if you delete it. Every clean-up shows exactly what will go first, and emptying the Recycle Bin needs an extra tick because it can't be undone.
  • Open it from the chat's right sidebar (Storage manager) or from the monkey's pop-up. It only ever shows or deletes Image Preview's own data.

• 🧭 Sidebar Actions

  • Reset floating button position — a one-tap action in the chat's right sidebar (Plugin · Image Preview), not a settings switch, so it can never get left silently "on." Snaps the button back on screen immediately if it's unreachable, with a small pulse and a confirmation toast.
  • Open Recycle Bin — opens the Recycle Bin to restore or permanently delete saved images.
  • Scan chat for images — the same chat scan as in the panel, one tap away.
  • Character page — opens the open chat's character card as one scrollable page.
  • Page view — opens Page view, where you can paste a link to see a web page's pictures and words.
  • Storage manager — shows what Image Preview keeps on your phone and lets you clean it up safely.

• 📜 Terms of Use

  • The first time you open Image Preview you tick a box to agree to a short, friendly Terms of Use (it also points to Tavo's own Terms of Service). Until you agree, nothing opens, scans or restores. "Not now" simply keeps everything closed.
  • Your answer is only a version number and a time, stored on your device. You can read the terms again at any time in ❔ Help → About & support.

• 🔐 Privacy & Security

  • Everything stays on your device by default. No accounts, no analytics, no tracking, no ads, and none planned.
  • Saved images and pins belong only to their chat. The one exception is the Recycle Bin, which holds deleted images across every chat until they're restored or their time runs out.
  • Import from device remembers each file's name and size, inside that chat only, so the same file isn't saved twice.
  • Links are checked: only public http(s) links are ever opened or downloaded. localhost, your home network (like 192.168.x.x), *.local names, names that spell out a private address (like 192-168-1-1.sslip.io) and non-web links such as javascript: or intent: are refused. The check reads the address as written; it can't see where a public name really points or where a redirect leads (see SECURITY.md).
  • Only images, GIFs and web pages are downloaded. Links to videos, music, archives, apps, documents or model files are refused before anything is fetched. For other links the plugin first asks the link's own server for its headers only (never the body; no cookies, no Referer) and refuses anything that isn't an image or a web page, or that is too big (images over 50 MB, web pages over 6 MB). Some servers hide this; then an oversized web page is thrown away unread and an oversized image is deleted as soon as it arrives. Every saved image is also checked once it has arrived: it must really be a picture (its first bytes are read, or the web engine has to accept it as one), otherwise it is deleted at once, even if the server claimed it was an image. Downloads give up after 45 seconds (web page previews after 30).
  • Quick Lookup sends only the text you type (up to 1,000 characters) and only when you tap "Look up". It goes over HTTPS to Google Translate, Lingva, MyMemory, dictionaryapi.dev, Wiktionary, Wikipedia, DuckDuckGo, Brave Search or Tavily. Privacy Mode blocks all of it. An optional Brave or Tavily key is sent only to its own service, as a header. When you ask Tavily to read a page, that page's link is sent to Tavily too.
  • Built-in games are fully offline. Games you add run in a sandbox with no network access, so they can't phone home, load outside code or reveal your IP, and they can't read your chats or Tavo data. Still, only add games from sources you trust.
  • "Extract images from text" reads at most the first 300,000 characters, shows at most 200 links and ignores private-network links.
  • "Scan this chat for images" only runs when you tap it. It reads (never changes) the open chat's character card, persona, lorebooks and messages on your device, sends nothing anywhere, and keeps to the same limits and link rules. Plugin permissions: file, network, variable, input and message.
  • The Character page reads the open chat's card on your device only when you open it, changes nothing and sends nothing anywhere. Its text is drawn as plain elements — no scripts, no clickable links, and a card's styles are never copied as written (colours, backgrounds, borders and spacing are rebuilt from numbers and keywords within fixed limits; no background pictures, no positioning or animation, nothing that can cover the page or hide text) — and its pictures follow the same public-link rules and load only when you open the page (embedded pictures work too, but not SVG). The site hosting a picture sees your IP address, never a Referer.
  • Page view downloads the page you ask for to a temporary file, reads it as inert text (nothing on it runs or loads: no scripts, styles, frames, ads or trackers), shows its words and pictures, and deletes the temporary file. It follows the same public-link rules and size limits. For Image Chest links, the picture list the page keeps inside itself is read the same way, as data that is never run. The site hosting the page and its pictures sees your IP address.
  • The Storage manager only looks for Image Preview's own files and settings (recognised by name), shows what will go before every clean-up, asks for an extra tick before the Recycle Bin is emptied, and sends nothing anywhere.
  • When an image loads from the web, the site hosting it sees your IP address (that can't be avoided), but never a Referer.
  • Found a problem? See SECURITY.md.

Installation

Only install from this repository's Releases page and compare the SHA-256 shown next to the file. A copy from anywhere else could have been changed.

1. Download the latest .tpg package from the Releases section.
2. Open Tavo.
3. Install/import the .tpg plugin package.
4. Enable Image Preview from Tavo's plugin settings.
5. Open a chat and use the floating Image Preview button.
6. The first time, tick the box to agree to the short Terms of Use; then everything opens.

Plugins need Advanced Rendering to be enabled for the chat.

Updating from an older version? Close Tavo completely and open it again once, so no older copy of the plugin stays active.

Current Version

v2.27.1

Highlights (v2.27.0 was a test build that was never released; everything in it is included):

• New: Lists and quotes on the Character page — lines that start with -, *, • or 1. show as real bullet and numbered lists (with sub-lists), and > lines as quotes, instead of raw symbols.
• New: A card's own look — colours, backgrounds and gradients, borders, rounded corners, spacing and side-by-side rows are kept, so a designed profile looks like the card its creator made. Text is always checked against its background so it stays readable, and nothing from a card is copied as written.
• Security: crafted text (one heading line followed by thousands of spaces) could freeze the Character page and Page view for a very long time. Fixed.
• The ❔ Help guide explains all of this, in English and Bengali.

See CHANGELOG.md or the Releases page for the full history.

Project Status

Image Preview was originally created as a personal Tavo plugin, and the source is open under the MIT License.

It is meant to stay community-minded. If I ever stop maintaining it for a long period, anyone is welcome to fix, modify, improve and extend it, as long as the original copyright and license notice are kept. See CONTRIBUTING.md if you'd like to help.

Credits

Creator: silent000 (Emon)

This project is made for Tavo.

License

Image Preview is released under the MIT License.

You are free to use, modify, copy, and redistribute the project according to the terms of the MIT License.

See LICENSE for the full license text.