Piqutary is a tool which lets you organize and share your image folders. It makes use of 2 open source third-party tools: an embedded web server called Jetty, and a text search engine called Lucene. Users must first launch the Piqutary web launcher and then point their web browsers to http://localhost:6886/. All image files are stored on the user's local hard drive. Piqutary makes use of 2 optional languages: a markup language (simplified HTML) called Piqutags, and a scripting language called Piqutalk, used to create 2-player board games.

Qunit Folders

A qunit is a queue of image files contained in a folder, and qunit folders can contain other qunit folders recursively. Newly added image files go to the head of the queue in each qunit. Every qunit contains a special queue which is a subset of the main queue of images. Both the main and the special queues support image reordering commands: head, tail, move left, move right. The head of the queue is the leftmost image in the queue. Every qunit has 2 yes/no flags: the H-flag and the X-flag. H stands for hidden (not shared publicly) and the X-flag warns users that its images are such that if the user is at work or sitting at a public computer, then proceed with caution. By default, qunits having an X-flag value of yes are hidden from the user. All lower level qunits of any hidden qunit or X-flagged qunit are also hidden or X-flagged, respectively.

Business Model

Piqutary no-name users pay no fees. Piqutary members pay a subscription fee of $10/year. All users can share qunits with other users by emailing links. All users can perform simple text-based searches, based on image captions, slide panels, and qunit names/descriptions. Only members can perform complex searches and bookmark qunits. All users can browse public (non-hidden) qunits of members without restrictions. All images contained in qunits of no-name users can be browsed, but any sub-qunits of a given no-name user's qunit are not displayed. All search results returned belonging to no-name users are stripped of all text: image captions, qunit names/descriptions, and user names. All of that same text information, including user names, is not displayed when browsing images in any qunit of a no-name user. No-name users can have many public qunits, but only one hidden qunit (which may contain zero or more numbered qunits).

Free Members Available Features
0 $10 Annual fee
yes yes Email links
yes yes Simple searches
yes Complex searches
yes Bookmark qunits
yes yes Browse qunits of members
yes Sub-qunits displayed during no-name/member search
yes Text meta-data displayed during no-name/member search
yes Unlimited hidden qunits
yes yes Play/create Piqutalk games
yes Upload Piqutalk games
yes Post in forums, play in tournaments, hold player rankings


  • Enter - down a level
  • Up Arrow - up a level
  • Left/Right Arrow - previous/next
    • qunit/screen/image/slide
  • Down Arrow - toggle main/special
  • Ctrl+Down Arrow - toggle slide mode
  • 1 - first
  • 0 - last
  • Shift+Up Arrow - move to top
  • Shift+Left Arrow - move left
  • Shift+Right Arrow - move right
  • Shift+Down Arrow - move to bottom
  • L - like image: make it special
  • U - undo L command
  • I - insert image/qunit
  • D - delete (slide mode)
  • Ctrl+D - delete image/qunit
  • Ctrl+Z - undo
  • Ctrl+X - cut qunit
  • Ctrl+C - copy qunit
  • Ctrl+V - paste qunit
  • Ctrl+N - new qunit
  • Ctrl+R - rename qunit
  • J - justify (left, center, right)
  • B - bookmark qunit/access bookmarks
  • H - hidden qunit on/off
  • X - X-flag qunit on/off
  • Y - sync qunit
  • S - search
  • Q - quit
  • F1 - cycle: menu/help/normal
  • F11 - fill screen
  • [x] - close menu bar

Qunits Mode

Displays parent qunit name followed by an indented list of qunit names. Current qunit is highlighted (enclosed in square brackets). Qunit properties: name, description, img-flag, P-flag, X-flag. If img-flag is false, qunit contains no images, only other qunits. By convention, images stored in non-image qunits reside in a sub-qunit called "$".

Tiles Mode

Whenever the user is in Qunits Mode and presses Enter when an image qunit is highlighted, the current mode becomes Tiles Mode. The display is divided into 3 rows of equal height (or n rows where n > 1). Each row contains images. All portrait-mode images are of equal height but of varying widths. Every landscape-mode image is the same width as the height of the row which contains that image. All images are separated by a white, one-pixel gap (user may increase pixel count of gap, globally). Clicking on an image will display it in Image Mode. Pressing Up Arrow makes the current mode become Qunits Mode.

Image Mode

Single image is displayed, expanded by the maximum amount available on the user's display. Pressing L or U modifies special flag if needed and the current mode becomes Tiles Mode. Pressing Up Arrow makes the current mode become Tiles Mode. Pressing Enter enables editing of one-line caption, and/or toggling display of image captions, and/or toggling the filtering out of images which lack captions. If this image is accompanied by a link to a video, click on play to follow that link under a new browser tab. The image-view count of the user who is the image owner is incremented, if different from the user viewing the image.

Slide Mode

Press Ctrl+Down Arrow to toggle between Tiles Mode and Slide Mode. Slide Mode displays between 1 and 3 images per slide. Each slide tries to fill the entire display. Click on an image in slide mode to enter image mode, then press D to delete the image from the slide. In slide mode, press I to insert an image. The next time the I command is used in image mode, the image is inserted into the slide. Various image arrangements (side-by-side, stacked, or some combination) are used automatically, depending on the aspect ratios of the images on the slide. New slides can only be inserted at the head of the slide list. One of the panels on a given slide (which contains 1 to 3 panels) can contain Piqutags code instead of an image.

Qunit Sharing

Google Drive (or possibly Dropbox) will be used as the image sharing platform. Users can use Piqutary to keep track of their favorite image-sharing users and the names of their favorite image qunit names shared by those users.

Bookmark/Insert Commands

The Insert command displays the select-user web page. After selecting a user, the Local mode switch is off. Further Insert commands insert images/qunits into the current local qunit, and allow the user to change the current local qunit. The Quit command sets the Local mode switch back to on. The Bookmark command bookmarks the current qunit when Local mode is off (enabling bookmark parent list selection), and accesses the bookmark tree when Local mode is on.


Popularity is used in searches: how many times an image/qunit has been viewed, downloaded, or bookmarked. Searching is used to search for users and the images held by those users. Text searches involve qunit names/descriptions, image captions, and slide panels.

Image File Names

Newly added image files can have arbitrary file names. After the sync command is used, newly added image files (except for the least recently added image, which is manually appended with .1 when saved by the user) are renamed to $QNNNN.ext, where ext is a graphics file type such as PNG or JPEG and NNNN is a 4-digit number. Clock arithmetic is used, where 9999 corresponds to -1, 9998 corresponds to -2, and so on. Usually, the head of the queue is positive, and the tail of the queue is 0 or negative. No qunit can have more than 10,000 image files.

The sync command programmatically removes the .1 extension of the least recently added image. When the user goes to add the next batch of newly added images, and tries to save the same image file F that originally had the .1 extension, it will already exist in the current qunit. This will let the user know when to stop adding images. The next time the sync command is performed, image file F is renamed to have the same $QNNNN format as all of the older image files in the current qunit.

[ Back to Top ]