Omaroll

Step through video a frame at a time, and zoom into very large JPEGs in the library and compare view too.

Added

• , and . pause a video and step one frame back or forward, in the viewer and the library's preview, as in mpv.

Changed

• The library's preview and compare view zoom into very large JPEGs the way the viewer does, decoding only the part on screen. Compare opens very large pictures from copies the size of the screen instead of decoding each one whole, which for two 150-megapixel scans took more than a gigabyte.

Fixed

• Audio and subtitle tracks are named by their language, such as "Track 2: French", instead of only a number.

Install or update.

Videos start sooner, wide-gamut photos show their real colors, and very large JPEGs zoom in without loading the whole picture.

Changed

• Videos start playing about a tenth of a second sooner. The player no longer waits for the thumbnail to be drawn first.
• Zooming into a very large JPEG, such as a 150-megapixel scan, decodes only the part on screen. Full resolution needs a fraction of the memory it did, about 410 MiB instead of 1.5 GiB for such a scan at actual size, and pictures too long for the graphics card are now sharp when zoomed in too.

Fixed

• Photos tagged with a wide-gamut color profile, such as Display P3 from phones or Adobe RGB from cameras, are shown in their real colors instead of looking washed out. The viewer, library, thumbnails and compare view all convert them; originals and saved copies keep their profile.

Install or update.

Photos use less memory, and browsing a folder stays light.

Changed

• Photos larger than the screen open from a sharp copy the size of the screen, and full resolution loads when you zoom in. Photos use less memory, open a little sooner and show less moiré when fitted. Both neighbouring photos are now preloaded instead of one.
• Memory from pictures you have moved past is returned to the system, so browsing a folder no longer keeps growing.

Install or update.

Omaroll starts again on Omarchy's stable and rc channels.

Fixed

• 1.15.2 was built against Qt 6.12 and failed to start with Qt 6.11, which Omarchy's stable and rc channels still ship (#119, reported by @dyedfox). Releases are now built against Omarchy's stable packages and refuse to publish a package that needs anything newer.

Install or update.

> This package needs Qt 6.12 and does not start on Omarchy stable or rc. Use 1.15.3 instead.

Very large pictures open, and videos play again with Qt 6.12.

Fixed

• Very large pictures open. A 150-megapixel scan used to fail with "Could not display this picture"; the viewer and library preview now show it from a copy the size of the screen and load full resolution when zoomed in. A picture that needs more memory than the limit says how much (#115, reported by @dyedfox).
• Corrections and Mattes say when a picture is too large to preview, instead of "Could not read this file".
• Videos play with Qt 6.12. Stepping to another video in the quick viewer could leave it stopped, and a playing video could stop by itself, because Qt 6.12 stops the player whenever its file is set again.

Install or update.

A second quick viewer opens straight into its tile without stalling the app, large libraries show metadata and thumbnails sooner, and the library gains an optional folder sidebar. The quick viewer adds looping, audio track and subtitle timing controls, and file actions, restores and hand-offs are safer.

Added

• An optional folder sidebar in the library, toggled with F9 or the Folders button. It shows pinned folders and a tree of library folders with counts, and its visibility and width are remembered.

• An optional Show filenames in grid setting keeps elided names on thumbnails, with the full name on hover or keyboard focus. It is off by default.
• Copy path and Copy file name in library menus and previews. Ctrl+Shift+C copies the opened entry's path as text, including symlinks.
• Resize the library preview by dragging its edges or corner. Its last size is remembered and fits within the current window.

• Loop videos in the quick viewer with the menu or Shift+L, cycle audio tracks with Shift+A, and adjust sidecar subtitle timing with Z and X.
• An optional Remember playback speed setting applies the last chosen quick viewer speed to newly opened videos. It is off by default.
• Copy paths and file names from the quick viewer and its details card.
• Fit pictures to the width or without enlarging, with a saved enlargement setting.
• Pan zoomed pictures with Shift+arrows and see viewer shortcuts with ? or F1.

Changed

• A second quick viewer on Hyprland asks the compositor without blocking and maps directly into its tile. Closing a viewer never rea

Photos and videos open faster, with a preview shown while video playback starts. Videos now work with media keys and the desktop player panel, and Omaroll opens more of Omarchy’s video types.

MPRIS supports play/pause, stop, seeking, rate and volume. Next/previous controls are not offered in this release.

Both viewers gain Open with, mouse back/forward navigation and a fit/actual-size toggle on 1. Show in file manager selects the file when your default manager supports it.

Shift+Delete adds permanent deletion with confirmation on by default. You can explicitly disable that prompt in Settings; ordinary Delete continues to use Trash.

Install or update · Full changelog

Thanks to @dyedfox for the viewer shortcuts, Open with, file-manager and permanent-delete requests.

Added

• Camera raws open in the viewer and the library: Sony ARW, Canon CR2 and CR3, DNG, Nikon NEF, Fujifilm RAF, Olympus ORF, Panasonic RW2, Pentax PEF, Samsung SRW and the other formats LibRaw reads, through the kimageformats raw plugin when libraw is installed. Thumbnails and previews use the camera's embedded JPEG, turned upright, or a half-size decode when there is none, so stepping through a folder of raws is as quick as JPEGs. The viewer demosaics the raw itself only when that preview would be shown larger than it is. Dates, camera, lens and exposure come from the raw's own headers.
• Actions whose tool cannot open a raw (annotate, text and QR recognition, Pinta, imv, background, print and corrections) are not offered for one. Convert · resize still makes a JPEG or PNG beside it. Raws are never written.
• The Arch package depends on libraw, so raws open without extra setup.
• Camera RAW tiles show their format, and Develop opens an installed darktable, RawTherapee or ART. The viewer shortcut is D.
• The viewer can show a filmstrip of the folder above its controls. B or the menu turns it on, a click on a thumbnail opens that file, and the choice is kept.

• Matching RAW/JPEG files are grouped, with companion switching and format badges. Both originals and explicitly opened files remain accessible.
• Save a preferred RAW editor, choose one each time, or use a custom command.
• Pin folders for quick access.
• Open existing images in Omaframe for annotation and frames.
• Right-click files and selections for grouped actions, includi

Changed

• Installation instructions use the signed package repository so Omaroll can update with the rest of the system. Manual release downloads remain available.

Fixed

• QR detection stops safely when its media library or the application closes.
• Gallery thumbnails wait for valid dimensions and hide a previous file's retained pixels while a replacement loads. Viewport checks account for files inserted or removed above a scrolled grid.
• Installed documentation links resolve to the repository and packaged license. Arch dependencies explicitly include FFmpeg for frame saving and probing.
• The viewer bounds neighboring photo preloads while keeping originals at full resolution. Canceled thumbnails stop obsolete helper work, and queued requests finish during shutdown.
• Gallery photo and document details avoid an unused video-poster decode. Gallery and viewer video posters apply display scaling once.
• The gallery restores keyboard navigation after empty search results and keeps the search field in sync with saved views and files opened from outside.
• Browse keeps search and folder choices visible in small windows with many source folders. Folder-only shuffle stays in the opened file's folder.
• The viewer reloads files saved in place, preserves zoom and rotation when other files arrive, and uses the same identity for symlinks as the library.
• Video scrubbing and Home/End override saved resume positions. Shuffled slideshows reliably find pictures when videos are excluded.
• Organization survives disconnected folders. Backups retain the iden

Added

• Portrait crop presets: 3:4, 2:3 and 9:16 sit beside their landscape partners in Crop, rotate, resize. A held landscape ratio could not be turned upright, so a portrait, a poster or a phone-screen crop had to be drawn by hand. Thanks to @diogochaves (#51).

Changed

• The Crop, rotate, resize controls are grouped into labelled Crop, Rotate and Resize rows instead of one strip that wrapped wherever it ran out of room. On a wide sheet the output size ends the Crop row and Reset, Cancel, Copy region and Save a copy end the Resize row; a narrow one gives them a line of their own. The smallest window drops the row labels and packs the groups onto shared lines with a rule between them, so the preview keeps its height. Full frame is gone: it did exactly what Free does. Thanks to @diogochaves (#51).

Fixed

• The Sub − and Sub + timing buttons for a sidecar subtitle sat on the video clock. The clock now stands to their left, and they leave with the CC button on a narrow window, or before they would squeeze the scrub bar below its minimum. Their offset label sits to their left, so a click no longer moves or hides them. Thanks to @diogochaves (#50).

Contributors

Thanks to @diogochaves for their work on this release.

Added

• Each picture or video opened from outside gets its own viewer, so several can be open at once. Opening a file that is already up brings its viewer forward. On Hyprland, a second viewer on a workspace tiles with the ones there instead of floating on top of them.
• With several videos open, only the viewer used last is heard. The others keep playing muted, and the saved mute setting is unchanged.

Fixed

• Images and videos without filename extensions open using bounded content detection. Folder navigation, library previews, animations and thumbnails use the same detected format; unrelated files remain excluded.

Changed

• Gallery previews give the picture more room, with a compact filename header and an inspector available on demand. Ratings, captions and primary actions stay easy to reach; technical details expand when needed, and secondary actions live in an overflow menu.
• Video controls keep a useful seek target with the inspector open in a narrow window. The slideshow button appears for pictures and active slideshows, leaving ordinary video playback with its own controls.
• The README demo and preview screenshot show the polished gallery.

Fixed

• Resume and Restart choices sit below the video and wrap when space is tight. A saved position holds playback until a choice is made; starting playback, seeking or a slideshow dismisses the offer.
• Caption edits are saved before navigation, and nested actions return keyboard focus to the preview.

Added

• A quick viewer. A picture or video opened from the file manager fills a window of its own, with the name, the other files and a menu that fade in when the pointer moves. The arrow keys step through the folder in name order, the next picture is decoded ahead, the wheel and a pinch zoom smoothly around the pointer, and a zoomed picture moves with a drag. Pictures get one bar of the usual controls (zoom, actual size, previous, slideshow, next, rotate and delete) and videos a thin bar of their own. The window opens at most of the screen's size, the same for every file, and each picture is fitted inside it, a small one scaled up. Nothing is scanned to open a file; Enter hands it to the library. Folders, PDFs and a plain launch still open the library, and so does --library with any file.
• The viewer's window can float centred like imv and mpv; the rule ships in /usr/share/omaroll/hypr/omaroll.lua.
• Select text in a PDF. Drag across a page to pick the words under the pointer, see each selected line highlighted, then copy those words with Copy selection or Ctrl+C. The words come from the same Poppler tool the document search uses, so nothing new is installed and the file is never changed.
• The demo library now carries a two-page document, so the page list, the find row and the page controls are rendered and reviewed like every other view.

Changed

• Opening a picture or video from outside no longer starts the library. The library's services are built the first time it is asked for, in the same process, so marks set in either

Added

• Lossless rotate and flip. A JPEG rotated or flipped with no crop or resize is written without recompressing the pixels (through jpegtran where available), so a turn no longer costs quality; every other correction recompresses as before. An image with an EXIF orientation tag still takes the recompressing path, which bakes the tag in.
• Crop aspect presets. The correction editor holds the crop to Free, Original, 1:1, 4:3, 3:2 or 16:9 while the frame is dragged, snapping to the largest centred rectangle of that ratio when the preset is chosen.
• Straighten. A fine ±15° level control in the correction editor, scaled to fill the frame so no empty corners show, applied before the crop.
• Correct a selection. Rotate, flip or resize several selected pictures at once (B), each written as its own copy with the existing collision handling.
• PDF continuous scroll. Pages scroll at the window width by default, with a Fit page mode for reading a whole page with zoom and pan.
• Print. A Print action for pictures and PDFs hands the file to the system print path (CUPS), and is greyed out with an install hint when it is absent.
• Undo organization marks. Ctrl+Z steps back through favourites, hidden flags, ratings and captions, one action at a time.
• Subtitle timing. Sidecar subtitles can be nudged earlier or later by half a second to fix a track that is out of sync.
• Slideshow options. The slideshow interval is configurable (2 to 20 seconds) and a shuffle mode picks a random picture instead of the next in order.

Added

• Crop, rotate, flip and resize a picture as a copy. The viewer's action list gains Crop, rotate, resize (Q): a live preview with a draggable crop frame, quarter turns and flips, and an optional output size. The original is never modified; the copy is written beside it as <name>-edited.<ext>, numbered on repeat. EXIF orientation is baked in, the ICC profile is kept, and collision or write failures leave the original untouched.
• Rename an album or a tag without losing its membership. Renaming a tag also renames every tag nested under it (Travel/Japan follows Travel). A name that clashes with an existing collection is refused.
• Compare pictures side by side with synchronized zoom and pan (K). It uses the checked selection, or the open picture's exact duplicates and then its visually similar set, and shows each file's name.
• Remember video playback. Volume and mute are kept across files and sessions, and a video reopened part-way through offers Resume or Start over instead of always starting from the beginning. Watching to the end clears the spot.
• External subtitles. A .srt or .vtt beside a video is offered alongside any embedded tracks, labelled by its language tag (movie.en.srt shows as English), and drawn over the video as playback reaches each cue.
• Find text in a PDF. The viewer's PDF controls gain a search box; each match is a page you can step through, with a count, and the page turns as you move between matches.
• Copy a PDF page's text to the clipboard, and jump straight to a page by typing its number in the PDF c

Added

• Star ratings. Rate a file from the viewer or with Alt+1 to Alt+5, sort by Top rated, and narrow any view to a minimum rating from Browse. Saved views keep the choice.
• Captions. Add a short caption in the viewer; it shows on the tile and is searched with filenames and picture text.
• Nested tags. A tag named Travel/Japan sits under Travel in Browse, and choosing the parent shows everything beneath it.
• Browse a photo library by camera and lens. The metadata pass that reads capture dates now records the camera and lens too, and saved views keep the choice. Libraries without camera photos do not show the section.
• Tab and Shift+Tab step through the sections, wrapping at either end.

Changed

• A video that plays to its end rewinds to its first frame and pauses there instead of leaving a blank stage.

Added

• Open multiple selected files in order, including across folders and in an already-running window. Explicitly selected hidden files open without scanning their surrounding folders.
• Opt-in startup readiness tracing and a reproducible startup benchmark.

Changed

• Video setup is deferred until a video is opened, reducing startup work for images and the library.
• Numbered filenames sort naturally, so image2 appears before image10.
• Copying extracted text is confirmed visually and through accessibility announcements.
• Real video rendering checks run under Mesa OpenGL in CI and release validation, and automated playback stays off physical audio devices, including native PipeWire.

Fixed

• Thumbnail, PDF and matte image responses no longer risk a crash when a request is cancelled or finishes during fast scrolling or a tile size change.
• Tiles no longer keep a previous file's thumbnail after the window or tile size changes, which could open a different file than the one shown.

Added

• Image previews now include actual-size viewing, horizontal and vertical flips, a checkerboard behind transparency, zoom up to 64 times the fitted size, and Space to pause animated GIF and WebP files.
• Video playback now includes standard Space, mute, volume, seek, speed, audio track, and subtitle controls. Double-clicking the video toggles fullscreen.
• SVG, icons, JPEG 2000, JXL, QOI, PSD, DDS, EXR, and TGA images can be scanned and opened directly when the packaged image plugins are installed.

Changed

• Videos start with sound, play once, and preserve an intentional pause when the window is minimized and restored.

Fixed

• Browse stays fully visible at the minimum window width.
• Closed matte previews no longer reload their previous file when the window changes size.
• Opening a PDF directly from a file manager no longer rejects it as an unsupported media file.
• Space in a video preview now pauses or resumes playback instead of launching the configured video action.

PDF support is the headline addition in this release. Omaroll can now treat PDFs as first-class library items.

Added

• Scan, thumbnail, preview, page through, organize, send, rename, and trash PDF documents. Rendering and page inspection use Poppler locally.
• Browse by month or day, plus quick views for today, this week, recently modified files, and files changed since the previous visit.
• Save the current filters and sort as a smart collection. Saved views update automatically as the library changes.
• Add reusable tags to any selection and browse tagged files without moving them. Tags follow in-app renames using the same identity checks as albums.
• Review visually similar pictures using a local perceptual comparison that tolerates resizing and JPEG recompression.
• Keep one file from an exact-duplicate set and move only its byte-for-byte identical copies to Trash after confirmation.

Changed

• Browse now brings folders, albums, dates, tags, saved views, exact duplicates, and similar-picture review into one panel.
• Selection organization now includes both albums and tags.

Added

• Extracted image text now opens in a selectable review sheet with preserved line breaks, Copy selection, Copy all, retry, and temporary corrections.
• The viewer action list supports Tab, arrow keys, Enter, Space, and accessibility activation. Shortcut tooltips now use the live bindings.
• QR actions appear only after a QR code is detected in the open image.
• OCR search results show the matching text when the filename did not match.

Changed

• Copy to clipboard is now Copy image.
• Browse is now a bounded, searchable library panel with direct source, folder, album, duplicate, and add-folder controls. Folder labels are concise while the parent path and recursive item count remain visible as context. Search filters the choice model before rows are created, and reopening Browse returns to the active folder or album.
• Extract Text retries sparse screenshots once when the normal OCR pass finds almost no text. Results still share the same private cache.
• Extract Text takes priority over background OCR and stops its current pass when the review closes.
• Viewer actions keep keyboard focus when moving between files or closing a nested sheet. Extracted text receives focus as soon as it is ready.
• Large libraries use indexed path lookups and bounded image metadata batches. OCR queues start and stop without hashing every path.
• Libraries with more directories than the inotify safety cap get a periodic worker rescan, while ordinary watcher updates only change affected paths.

Fixed

• First-run media date indexing publishes one settle

Added

• Clear folder sources in Settings. Omaroll lists the Omarchy and XDG folders it detects automatically, combines roles that resolve to the same path, and marks unavailable paths. Added folders stay saved so removable storage can return later.
• Original media dates. General photos use EXIF DateTimeOriginal or DateTimeDigitized, and videos use their embedded creation time, so files copied into a watched folder still land on the day they were made. Omaroll reads one file at a time after discovery, caches both found and missing dates by file identity, and never overrides a timestamped capture filename.
• Find exact duplicates. Browse opens a read-only review that compares only same-size candidates, hashes them off the interface thread, keeps matching sets together, and updates when files change. It never removes anything.
• Save the current video frame. The viewer hands its exact playback position to ffmpeg, writes a timestamped PNG beside the recording, and tracks the result without changing the video.
• Rename in place. The sheet keeps the media extension fixed, refuses an existing filename, and carries favourites, hidden state, and album membership to the new path.
• Search inside pictures. Filename results appear immediately, then local Tesseract indexing adds screenshots and photos containing every search term. It starts only while search is active, runs one file at a time, pauses after the current file when search clears, and reuses a private, identity-checked cache pruned to 64 MB at startup. Progress is visible, and Settin

Fixed

• Transcode actions always show a result. A running transcode pins a "Making ..." line in the footer and selects the finished file in the grid, and pressing an action whose output already exists opens the viewer on it.
• Existing outputs are verified with ffprobe before being trusted, so an empty or truncated file left by an interrupted run is cleared and remade instead of blocking every retry as "already done".
• A -720p.gif, -1080p.mp4 or -4k.mp4 renders its thumbnail from the source video beside it, so a recording and its conversions show identical tiles instead of three different frames of the same content.
• A recording's tile returns to its resting frame when a hover scrub ends, instead of parking on whatever frame the hover left it at.
• An animated GIF with no source beside it thumbnails at the same percent-in moment as a video, rather than always its first frame.

The thumbnail cache regenerates lazily on first view after upgrading.

Install

curl -fLO https://github.com/tsouth89/omaroll/releases/download/v1.0.3/omaroll-1.0.3-1-x86_64.pkg.tar.zst \
     -fLO https://github.com/tsouth89/omaroll/releases/download/v1.0.3/SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS
sudo pacman -U ./omaroll-1.0.3-1-x86_64.pkg.tar.zst

Every asset is covered by SHA256SUMS and a signed build attestation: gh attestation verify omaroll-1.0.3-1-x86_64.pkg.tar.zst --repo tsouth89/omaroll.

Clip to GIF, Resize to 1080p and Convert to JPEG used to be fire-and-forget: the new file blended into the library with no word about where it went, a transcode's output sat in the grid as a broken zero-byte tile while ffmpeg worked, and if the run died the tile stayed broken forever with no explanation. Transcodes are now followed to the end.

Fixed

• You can see where the file went. When a transcode finishes, the library rescans, the status line says the new file was saved beside the original, and the grid selects and scrolls to it. If the current filter would hide it, the view clears to show it, the same way "Open with Omaroll" does; otherwise your filters are left alone.
• No more broken tiles mid-transcode. The output file is held out of the library until the tool finishes, so the zero-byte in-progress file never appears as a broken entry, and its thumbnail is only made once the file is complete.
• Failures are cleaned up and explained. A transcode that dies leaves no partial file behind, and the tool's own last error line is quoted in the status message instead of silence.
• No more false "already done". Running the same transcode again while one is in flight says "Still working on ..." instead of mistaking the half-written file for a finished one.
• Stale entries fix themselves. Finished transcodes are rescanned even though writing into an existing file fires no directory event, which was why a thumbnail made from a half-written file used to stay broken until restart.

One behaviour change: a transcode is now cance

Omaroll now resolves theme colors the way Omarchy itself does. Before this release, only themes with a fully semantic colors.toml followed your theme; anything else quietly fell back to Omaroll's built-in green look.

Fixed

• Compact terminal palettes follow the theme. A colors.toml that defines only background, foreground and color0..color15 (the format many third-party and Ghostty-derived themes use) now resolves through the same alias cascade as omarchy-theme-color: ANSI names map to semantic names, muted, selection and the foreground variants follow the same fallback chains, missing dark and darker background shades are derived with the same 25% and 50% black mixes, and light or dark mode is detected with the same precedence and luminance threshold.
• Accent falls back to the terminal blue. When a theme defines no accent, Omaroll takes color4, exactly like the Omarchy shell, instead of showing the built-in green accent.
• Legacy names and the Omarchy 3 layout work again. Themes using the old short names (bg, fg, dark_bg, ...) resolve correctly, and a theme installed under ~/.config/omarchy/current is found when the Omarchy 4 state root has none.
• The state root matches Omarchy. Omaroll reads the fixed ~/.local/state/omarchy/current path that Omarchy's own scripts use, rather than honouring XDG_STATE_HOME when Omarchy does not.
• Machine-level launcher overrides apply. A [launcher] background or background-alpha in ~/.config/omarchy/shell.toml overrides the theme's values,

Omaroll is a fast image and video viewer that turns your media folders into a library. Built for Omarchy, as an independent community project.

Omarchy ships a very good capture stack and then saves everything to folders. Omaroll is the part that comes after: finding the thing again, and doing the obvious next thing with it.

Highlights

• One library for everything you capture. Screenshots, recordings, pictures, videos and downloads, grouped by day, newest first. Add any other folder from Settings and switch between folders from the library bar.
• Knows what each file is. Omarchy stamps its captures with a predictable name, so a screenshot is a Screenshot even when it lives next to every other image in ~/Pictures.
• A viewer with every action beside the picture. Enter opens a capture large. Images zoom, pan, rotate and animate. Recordings preview muted with a scrub bar and a sound toggle. F11 for fullscreen, F5 for a slideshow of any folder, album, search or filtered view.
• The tools you already have, one key from the file. T sends a recording to omacut, A sends a screenshot to tensaku or $OMARCHY_SCREENSHOT_EDITOR, and the action list runs omarchy-transcode, mpv, tesseract, zbarimg, Pinta, imv, LocalSend and Nautilus. A tool that is not installed is shown greyed with the package to install, not hidden.
• Make it postable. The one thing Omaroll does natively: six finished backgrounds derived from the screenshot's own dominant colour, the same six every time for the same file. Pick one and it is on your clipboard and sa