Skip to content
tie app

tie-view

Tag at the speed of sight.

A tag-driven image viewer with quick-tag pills, star ratings, favourites and a filesystem view of the same library.

Stable LinuxWindowsmacOSAndroid GitHub ↗
Highlights

The parts that matter.

Tags, include and exclude
Refine with related tags, star the ones you use, and hide the rest.
Quick-tag pills
One tap or one key per tag, laid over the image edge. Sizes from xs to xl.
Ratings and favourites
1–5 stars, favourite tags and filters that survive a restart.
The tree is right there
A Files tab shows the virtual library tree when you want paths, not tags.
Thumbnails that stay fast
Server-cached thumbnails and archive covers, generated once.
Hand-off from tie-fm
tie: URLs open exactly the image you clicked, in the collection you meant.
Image
great-wave.jpg 9a1f3c…c03e · 1920×1324 ★★★★☆
Tags traveljapanukiyo-efavorite
Quick ★ familywallpaperprint one tap, over the image edge

Tag at the speed of sight

Tagging

The image is the interface.

Open an image and the tag panel is one tap away. Quick-tag pills sit over the edge of the picture: one tap, or one key, per tag. Rate with the number row, favourite with the heart, swipe up for the full tagger on a phone.

  • Pills sized xs–xl, with an icon or just text, configured in quicktags.toml.
  • Ratings 1–5 and a favourite tag that tie-audio and tie-fm also understand.
  • No modal dialogs in the flow: tag, rate, next.
Browsing

Include, exclude, refine.

The tag sidebar works like a query builder: include tags to narrow, exclude tags to remove, and "related tags" to refine by what the current result set actually contains. Favourite tags stay at the top.

  • Sort by name, rating, newest or oldest.
  • Untagged is one button, because a library always has some.
  • A Files tab shows the virtual tree when you need a path instead of a tag.
  • Server-cached thumbnails and archive covers are generated once, then shared.
Together

The hand-off from tie-fm.

tie-fm can open a tile in tie-view with the right collection and the right file already selected. The mechanism is a tie:<hash> URL, not a temporary export. The same URL works from a terminal, a script or a bookmark.

  • Desktop and Android from the same codebase; the drawer and swipe gestures adapt.
  • Connection errors show a Retry, not a dead window.
  • De-import from a tile's context menu, with the same semantics as tie-fm.
one URL, one image
$ tie-view "tie:9a1f3c0b7e…4d2ac03e"

# or from tie-fm # right-click → Open in tie-view

# or pin a query as a startup page $ tie-view -tag favorite

Shortcuts

ViewKeysAction
GalleryJ / K, arrowsScroll
GalleryBackspaceParent folder
Image← / →Previous / next
ImageTQuick tagging
ImageIInfo overlay
ImageUSave image
ImageEscBack to the gallery
AnyQQuit

Every shortcut is rebindable in the imgview config, which tie-view shares. The Quick tags settings tab edits the pill layout and key mapping in place.

Where it is

  • Status: stable enough to use every day
  • Versioning: tie-gui is released from the repo; the apps are built from source.
  • Video playback needs libmpv; it is disabled by default in headless builds.

Works with

  • tie — Tag it. Find it. Mount it.
  • tie-fm — Two panes. Both worlds.
  • tie-audio — Your library, on shelves.
  • imgview — Point it at a folder.
  • tie-browser — Pages made of your library.
  • anneal — The coding agent that anneals.
Keep reading

The manual, the numbers, the source.

Try it with your own files.

A single binary, a local library and no account. Keep the originals where they are.