Lyra Viewer

---

Contents

• Overview
  • What Lyra is and what it isn't
  • Recommended hardware & known limitations
• Key Features
• Technical Details
  • Technical Documentation - decoding, color, HDR, PSD and texture internals
• Supported Image Formats
  • Common Raster Formats (Essential)
  • Modern / Web-Friendly Formats
  • High Dynamic Range Formats
  • GPU Formats
  • Document / Vector Formats
  • Minor Formats
• Keyboard Shortcuts & Controls
  • macOS Specific
  • Open With / Drag & Drop
• Dependencies
• Native Libraries & Bundling
• Installation
  • macOS (Homebrew)
  • Windows (Scoop)
  • Linux (APT)
  • Linux (direct .deb)
  • Linux (Flatpak)
• Configuration & Data Files
  • Configuration
  • Data
  • Cache

Overview

Lyra is a high-performance, minimalist image viewer designed for speed, fluid navigation, and precision. It handles modern and professional image formats without the overhead of full editing suites or Electron-based tools. Built for anyone who relies on images as a core resource in their workflow:

• 2D/3D artists and game developers browsing texture maps and baked assets
• Photographers reviewing large batches of exports
• Developers inspecting UI assets, icons, and generated output
• And ordinary advanced users

What Lyra is and what it isn't

• Lyra is solely a viewer - nothing more. It opens and displays your files; it never writes to them, moves them, or deletes them. Your files are always safe and untouched.
• Lyra is not an Electron application. It is a native application built on SDL3 and Skia, with no embedded web browser and no JavaScript runtime. It runs on .NET 9 and renders directly through your GPU, keeping performance at the forefront of every decision.
• Lyra does not connect to the internet. It has no telemetry, no update pings, no cloud sync, no nag screens, and no AI features. Everything runs locally, offline, on your machine. Updates are manual - check for new releases and install them through your package manager (Homebrew, APT, Flatpak, or Scoop) when you're ready. If there's a format, workflow, or feature you'd like to see, the right place to say so is the GitHub issue tracker.

Recommended hardware & known limitations

Lyra is designed for capable, modern hardware - a dedicated GPU and SSD storage will get the best out of it. Not every limitation is Lyra's to solve: network shares over SMB are constrained to a single stream by the protocol itself and cannot be parallelised, so performance over a NAS or remote share will always be bounded by that ceiling.

---

Key Features

• Fast, robust, minimalist, intuitive
• Native, not Electron - runs on macOS, Windows and Linux from one codebase
• Non-blocking loading - the UI never freezes on a decode; images arrive progressively while neighbors preload
• Runs offline, no telemetry, no update pings, no cloud, no AI features, no nag screens
• Read-only by design - never writes, moves or deletes a file
• Keyboard-driven, with the full key map on screen at a keystroke
• Duplicates finder - exact and visually similar, by perceptual hashing
• Directory tree sidebar

• Full graphics pipeline (Photoshop, textures, HDR maps)
• Adjustable background, sampling options
• Color-managed from decode to screen (embedded ICC, NCLX primaries)
• P3 wide-gamut support
• HDR kept scene-referred and tone-mapped as it is drawn - ACES filmic, extended Reinhard or clip, with exposure in stops
• EDR output on macOS - highlights drawn above SDR white on a display with headroom
• PSD / PSB streaming and tiled decoding
• TIFF in depth - BigTIFF, multi-page documents, 1 to 64-bit samples, signed, unsigned or float
• EXIF metadata
• PSD layer hierarchy
• File structure inspector (PSD / PSB, TIFF, DDS / KTX / KTX2)
• Variant picker for files carrying several renditions - the sizes inside an .icns / .ico, the pages of a TIFF

---

Technical Details

Lyra is built on .NET 9 with SDL3 for windowing and input, and SkiaSharp for hardware-accelerated rendering via OpenGL or Metal. It is not an Electron app - there is no embedded browser, no web runtime, and no hidden resource overhead (and definitely no AI client). Decoding is split between Lyra.ManagedCodecs, a pure-managed codec library, and lightweight native interop wrappers for EXR, JPEG 2000, JPEG XL and TIFF.

See Technical Documentation for the full detail:

• Technical Details - architecture, caching, streaming and tiled decoding
• Color Management - decode / display / draw, and rendering intent
• HDR / EDR - scene-referred light, tone mapping curves, EDR output
• PSD / PSB Decoding Model - color modes, PSB, ICC, layer hierarchy
• DDS & KTX Texture Decoding Model - formats, containers, inspector

---

Supported Image Formats

Common Raster Formats (Essential)

Modern / Web-Friendly Formats

Document / Vector Formats

High Dynamic Range Formats

GPU Formats

Minor Formats

---

Keyboard Shortcuts & Controls

macOS Specific

Windows / Linux Specific

Open With / Drag & Drop

Recursion applies only when directories are explicitly dropped. Opening or dropping files never implicitly expands into subdirectories.

Developer note: Lyra intentionally favors context-aware navigation. Opening a single image always implies “show me this image in relation to its neighbors”, not isolation.

---

Dependencies

---

Native Libraries & Bundling

A handful of formats are decoded through native libraries (libheif, OpenJPEG, libjxl, OpenEXR, libtiff, plus the Basis Universal transcoder). How those libraries are delivered depends on the platform:

• macOS - expected from the package manager (Homebrew).
• Linux - resolved as APT dependencies of the .deb, except for libjxl, which is vendored inside the package for now. This is a temporary measure until JPEG XL support is more widely available across Ubuntu releases; it will be dropped in favor of the system package once that lands.
• Linux (Flatpak) - self-contained: the libraries come from the Freedesktop runtime or are built into the Flatpak, so nothing needs to be installed on the host.
• Windows - bundled with the application. The wrapper DLLs are self-contained and ship inside the distribution, so no separate installation is required.

---

Installation

Lyra Viewer is distributed via Homebrew on macOS, an APT repository (or a direct .deb) on Debian/Ubuntu, a Flatpak repository for any Linux distribution, and Scoop on Windows.

macOS (Homebrew)

brew tap lyra-viewer/lyra
brew trust --cask lyra-viewer/lyra/lyra-viewer
brew install --cask lyra-viewer

Windows (Scoop)

scoop bucket add lyra-viewer https://github.com/lyra-viewer/scoop-lyra
scoop install lyra-viewer

Updates then arrive through scoop update lyra-viewer.

Linux (APT)

Add the signed repository once, then install and receive updates through apt:

# 1. Trust the repository signing key
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://lyra-viewer.github.io/apt-lyra/lyra-archive-keyring.asc \
  | sudo gpg --dearmor -o /etc/apt/keyrings/lyra.gpg

# 2. Add the repository
echo "deb [signed-by=/etc/apt/keyrings/lyra.gpg] https://lyra-viewer.github.io/apt-lyra stable main" \
  | sudo tee /etc/apt/sources.list.d/lyra.list

# 3. Install
sudo apt update
sudo apt install lyra-viewer

Updates then arrive through the usual sudo apt update && sudo apt upgrade.

To remove the repository:

sudo rm /etc/apt/sources.list.d/lyra.list /etc/apt/keyrings/lyra.gpg
sudo apt update

Linux (direct .deb)

Prefer not to add a repository? Download lyra-viewer_<version>_amd64.deb from the latest release and install it directly (apt resolves the system dependencies):

sudo apt install ./lyra-viewer_0.6.0_amd64.deb

Linux (Flatpak)

Works on any distribution with Flatpak. One command adds the signed repository (and Flathub, for the runtime) and installs Lyra:

flatpak install --user https://lyra-viewer.github.io/flatpak-lyra/lyra-viewer.flatpakref

Updates then arrive through flatpak update. A standalone LyraViewer-linux-x86_64.flatpak is also attached to each release; installing it subscribes to the same repository for updates:

flatpak install --user ./LyraViewer-linux-x86_64.flatpak

The Flatpak has read-only access to your files, so it can browse folders and find duplicates, but never modifies them.

To uninstall:

flatpak uninstall --user com.nineveh.LyraViewer
flatpak remote-delete --user lyra   # if you installed the bundle, `flatpak remotes` shows its remote's name

Note: Linux builds (.deb and Flatpak) are amd64 (x86-64) only for now.

---

Configuration & Data Files

Where Lyra keeps its files depends on how it was installed:

On macOS and Linux these follow the XDG base directories, so XDG_CONFIG_HOME, XDG_DATA_HOME and XDG_CACHE_HOME are honored when set. The Flatpak's files are separate from a .deb install's: switching between the two starts with default settings, unless you copy the lyra-viewer/ folders across.

Configuration

Data

Cache

If any configuration file is missing or malformed, Lyra falls back to built-in defaults and recreates the file on next save. Deleting everything under these folders is always safe - Lyra will start fresh with default settings.

---