Check it out here on my Github! 👋

Download💾

img-txt Viewer

A Windows application to display an image and text file side-by-side for easy manual captioning or tagging.

+Tons of tools features to help you work faster!

📝 Usage

Note

• Prepare Your Files:

  • If you choose to include a text pair for an image, ensure they share the same basenames.

    • For example: 01.png, 01.txt, 02.jpg, 02.txt, etc.

• Supported image types: .png .jpg .jpeg .jfif .jpg_large .webp .bmp .gif

💡 Tips and Features

• Shortcuts:

  • ALT+LEFT/RIGHT: Quickly move between img-txt pairs.

  • SHIFT+DEL: Send the current pair to a local trash folder.

  • ALT: Cycle through auto-suggestions.

  • TAB: Insert the highlighted suggestion.

  • CTRL+S: Save the current text file.

  • CTRL+E: jump to the next empty text file.

  • CTRL+R: Jump to a random img-txt pair.

  • CTRL+F: Highlight all duplicate words.

  • CTRL+Z / CTRL+Y: Undo/Redo.

  • F5: Refresh the text box.

  • Middle-click: A tag to quickly delete it.

• Tips:

  • Highlight matching words by selecting text.

  • Enable List View to display text in a vertical list format.

  • Quickly create text pairs by loading the image and saving the text.

  • Get Autocomplete Suggestions while you type using Danbooru/Anime tags, the English Dictionary, etc.

  • Fuzzy Search Use an asterisk * while typing to return a broader range of suggestions.

    • For example: Typing *lo*b returns "looking back", and even "yellow background"

• Text Tools:

  • Batch tag Delete: View all tag in a directory as a list, and quickly delete them.[1]

  • Prefix Text Files: Insert text at the START of all text files.

  • Append Text Files: Insert text at the END of all text files.

  • Search and Replace: Edit all text files at once.

  • Filter Pairs: Filter pairs based on matching text, blank or missing txt files, and more.

  • Active Highlights: Always highlight specific text.

  • My Tags: Quickly add you own tags to be used as autocomplete suggestions.

  • Cleanup Text: Fix simple typos in all text files of the selected folder.

• Other Tools

  • Batch Resize Images: Resize a folder of images using several methods and conditions.[1]

  • Resize Image: Resize a single image.

  • Batch Crop Images: Crop a folder of images to an exact size, resizing if needed.

  • Crop Image: Quickly crop an image to a square or freeform ratio.

  • Upscale Image: Upscale an image using realesrgan-ncnn-vulkan [1]

  • Expand Current Image: Expand an image to a square ratio instead of cropping.

  • Find Duplicate Files: Find and separate any duplicate files in a folder. [1]

  • Rename and Convert Pairs: Automatically rename and convert files using a neat and tidy formatting.

• Auto-Save

  • Check the auto-save box to save text when navigating between img/txt pairs or closing the window, etc.

  • Text is cleaned when saved, so you can ignore typos such as duplicate tokens, multiple spaces or commas, missing spaces, and more.

  • Clean text on save Can be disabled from the options menu.

[1]These are stand alone tools and/or not available in the Lite version.

Please see the ✨Tools section of the wiki for a more comprehensive breakdown of the various features.

🚩 Requirements

You don't need to worry about anything if you're using the portable/executable version.

Python 3.10+

You will need Pillow and NumPy.

• To install Pillow: pip install pillow

• To install NumPy: pip install numpy

Or use the included requirements.txt when setting up your venv.

📜 Version History

Check out the releases page for all changelogs.

I make other apps and stuff, check it out here.📜

(This page will not be updated as frequently as the github page, some info may be out of date)