A webcomic browsing assistant
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example_images
.gitattributes
.gitignore
LICENSE.txt
README.md
_config.yml
dv.ttf
mr_teal.bas
mrteal.ico

README.md

Mr. Teal

A tiny Windows program for pleasant and enhanced reading and browsing of comics and other images

Made with QB64

Current version is 1.9.1, available under releases.

Instructions

To install for Windows: download the zip file, extract to a directory, run mrteal.exe.

Linux builds coming eventually, but you can make your own with QB64 (note: due to extensive reliance on Windows shell commands for file acquisition, Linux build will likely have a much reduced feature set and thus not be a priority. Sorry. I make software I can use. Feel free to take it and run with it if you want.)

This file contains only public domain example images. For comic packages, see here.

To add images, copy or move a directory into the program folder. Images will be detected and indexed automatically when loaded from the main menu. Currrently supported formats are PNG, JPG, BMP and GIF.

Drag a directory onto the executable to copy the directory and open the program to the main menu. The imported directory will be marked (new).

and arrow keys to navigate.

and arrow keys to scroll image vertically. There are no plans to support horizontal scrolling at this time.

Hold Shift while pressing to resize the window. (also supports dragging the edge of the window with the mouse.)

Home resizes the window to fit the current image.

F for Fullscreen (Alt-Enter cycles through different fullscreen modes.)

Drag a directory onto the executable to copy the directory and open the program to the main menu. The imported directory will be marked (new).

J to Jump to a specific image number (leave blank to cancel, any input greater than the number of images will jump to the last one.)

A to view Alt text.

S makes alt text Show by default.

I to view image Information.

O to keep image information On.

W to Write new alt text for the current image.

Ctrl-C to Copy the alt text for the current image to the clipboard. Ctrl-X instead copies the full file path.

Ctrl-V to Very quickly paste the contents of the clipboard to the current comic's alt text.

PLEASE BE ADVISED: There is no confirmation for overwriting or deleting the alt text. This is for expediting adding alt text en masse. If there's a chance you might lose something important, be sure you have a backup.

Default folder is saved in main program directory as default.txt. Delete this file or press L during program operation to clear default.

Q to Quit.

Buglist/to-do

  • A crash can occur if the viewing window isn't wide enough to center the image on the screen. This is easily fixed by increasing the width in settings.txt but I'd still like to figure it out. Fixed, hopefully.
  • Fix long alt text display so it doesn't wrap mid-word Done
  • Support multiple comic packages, with auto-generated menus based on directories Done
  • Automatically generate a file list and bookmark file Done
  • Add key to show current image information Done
  • Have an option to not see alt text automatically. (i.e. you press "A" on each individual image instead of just leaving it enabled. This is useful for comics like XKCD, where the alt text is often an extra joke that you're meant to read after the comic.) Done
  • Add option to change or add alt text for the currently displayed image Done
  • Add support for custom bookmarks and chapters
  • Support for zooming
  • Menu for configuring browsing settings per directory
  • Figure out proper order for files named with natural numbers (so you don't get 1.jpg, 10.jpg, 100.jpg, 2.jpg, 20.jpg, etc. I have no idea how to do this but it'll be an interesting problem to solve.)