ahmetyuksek.com

Ahmet Yüksek

CoolGorilla user manual

CoolGorilla decodes a whole folder to display resolution on background workers and keeps it in RAM. After the first pass, moving through a shoot in either direction is instant — nothing is re-decoded, nothing is flushed. Everything here is built around that: look, decide, press one key, move on.

Covers CoolGorilla 1.2 · Windows, macOS and Linux

Installing

Windows

The Microsoft Store build is the easy one: verified by Microsoft, one click, and it keeps itself updated. The standalone installer from the download page works just as well, but Windows SmartScreen may say the publisher is unknown — there is no code-signing certificate behind it yet. Choose More info, then Run anyway. The installer needs no administrator rights and can add a desktop shortcut and Open with → CoolGorilla for image files.

macOS

Open the .dmg and drag CoolGorilla to Applications. On first launch, right-click the app and choose Open. If macOS says it is damaged, that is only Apple's quarantine flag: open Terminal, type xattr -cr followed by a space, drag the app onto the Terminal window and press Enter. It opens normally after that.

Linux

The AppImage needs no install. Make it executable — chmod +x, or right-click → Properties → Allow executing — then double-click it.

How much memory it uses: CoolGorilla claims 90% of system RAM, kept between 4 GB and total minus 8 GB — roughly 56 GB on a 64 GB machine, roughly 8 GB on 16 GB. That budget is shared between the display cache, the full-resolution cache and thumbnails, and the figure is printed on the status line at startup.

Opening photos

Ctrl+O Open image files. This is the only picker that shows thumbnails, so it doubles as a browser: pick one photo to open its whole folder positioned on that photo, or select several to open just that set.
Ctrl+Shift+O Open a folder, when you already know which one you want.
Drag and drop Drop images or a folder anywhere on the window.
From the file manager Double-click a registered image type, or use Open with → CoolGorilla. Files opened while CoolGorilla is already running join the gallery you have open.

The window sizes itself to the first photo it shows, so a set of portrait frames opens in a portrait window rather than a letterboxed one.

A narrow portrait CoolGorilla window showing a blue car on a Sicilian street
Three files picked in the open dialog, opened as a set of three — the window took the shape of the first one.

What it opens

RAW from every major brand through LibRaw — Sony, Canon, Nikon, Fujifilm, Olympus, Panasonic, Pentax, Leica, Hasselblad, Phase One, Sigma, Kodak, Minolta, Mamiya, Leaf, Epson and Samsung — plus JPEG, PNG, TIFF, WebP, BMP and the HEIC files an iPhone shoots by default. Straight from the card, no conversion.

The window

The title bar carries the file name and your position in the shoot. Top right are two controls: a folder button that opens files, and the menu button — the same menu you get by right-clicking anywhere on the photo.

Along the bottom, the detail bar reads out the photo you are on:

Name File name, with a gold star in front while the photo is in the copy set
Position Which photo of how many
Zoom Scale against the photo's real pixels — 100.0% is true 1:1
Pixels Native dimensions, for example 5,184×3,464
Print size What that measures on paper at your chosen resolution
File size Megabytes on disk
Date Modified date, marked (m)

Below the photo sits the filmstrip of thumbnails. Drag the divider above it to make it taller or shorter, drag its scrollbar or flick it to travel through a long shoot, and click any thumbnail to jump there.

A RAW photo of a cat at 100 percent with the filmstrip and detail bar visible
A 599-file folder at 100%: the frame you are on is outlined in the filmstrip, and the detail bar confirms true 1:1.

Moving through a shoot

PgDn Space Next photo
PgUp Previous photo
Home · End First · last photo
T Hide or show the filmstrip
F Fullscreen, filmstrip kept
F11 Fullscreen, image only
Esc Leave fullscreen — or quit, if you are not in it

Navigation wraps around: past the last photo you are back at the first. A cold folder shows each photo's embedded preview immediately and sharpens to the real decode a moment later, so there is never a black frame to wait through.

A portrait photo of the Amalfi coast filling the window with the filmstrip hidden
Filmstrip hidden with T. The detail bar stays, so you keep the print size and position readout.

Zoom, pan and lock-zoom

Wheel Zoom towards the cursor
Double-click Toggle native 100% at the cursor, and back to fit
Drag Pan the zoomed photo
Ctrl+0 · 1 · 2 Fit · actual size (100%) · fill
Z Lock zoom

Past fit, CoolGorilla decodes the photo again at full resolution, so 1:1 really is 1:1 — which is what you want when you are checking focus on a RAW file.

Lock-zoom is for bursts. Zoom into the eye of the first frame, press Z, then arrow through the sequence: every frame of the same size holds the same crop, at full resolution, so you can compare the same detail across ten shots without touching the mouse.

Sorting

Menu → Sort orders the gallery by name, date modified or file size, ascending or descending, and remembers your choice. Star-rated photos always group at the front of the filmstrip — five stars first, down to unrated — whatever sort you pick; the sort orders photos within each of those groups.

Star ratings

Press 1 to 5 to rate the photo you are looking at; 0 clears the rating. The view moves on to the next photo by itself, and the one you just rated files into its star group at the front of the strip, where its stars show under the thumbnail.

CoolGorilla showing a mountain sunset with the first four thumbnails carrying gold star ratings
Rated photos gather at the head of the filmstrip, best first. The rest of the shoot keeps its own order behind them.

Ratings are written as XMP sidecar files — IMG_0001.xmp next to IMG_0001.ARW — using the same xmp:Rating field Lightroom, Bridge and Capture One read and write. Rate here and the stars are already there when you import; stars set there show up here. The photo itself is never rewritten, so a proprietary RAW is never at risk.

Rate and file, in one keystroke

Hold Shift with a rating — Shift+1 through Shift+5 — and the photo gets that star and moves straight into an Approved\5Stars folder (or 4, 3, 2, 1) beside where it lives now. The rating travels with it, and the view moves on.

Use plain 1–5 when the stars are notes to come back to, and Shift+1–5 when the star is the decision: a shoot sorts itself into star folders as you go, with nothing left to move afterwards.

Ctrl+Z undoes the whole thing at once — the photo comes back to its folder carrying whatever rating it had before you pressed the key. It works on a photo that already has that rating too: pressing Shift+3 on a three-star photo is a request to move it, and it moves.

Filing a whole star group

Right-click any rated thumbnail in the filmstrip and you get two actions for its entire rating tier: move all of them to the matching Approved folder, or copy them there instead — the originals stay exactly where they are, keeping their stars, so you can assemble a print set without emptying the folder it came from. Both are a single undo, and copying the same group twice never overwrites: the second copy lands beside the first.

Approve, reject, delete — and undo

A Move the photo into an Approved subfolder
X Move it into a Rejected subfolder
Delete Move it to the Recycle Bin — this one asks first
Ctrl+Z Undo the last thing you did to a file
Ctrl+Shift+Z Redo it

Approve and reject are deliberately non-destructive: the subfolder is created next to the photo and the file is moved, not copied or deleted. Its rating sidecar and any EXIF backup travel with it. A and X sit next to each other so one hand can cull while the other holds the coffee.

Undo steps back through everything you did to files in this session: ratings, approve and reject, rate-and-file, group moves and copies, rotations, and EXIF removal. A photo that has left the folder by other means — you moved it yourself, or emptied the subfolder — is skipped rather than failing loudly.

The CoolGorilla right-click menu with the Rotate submenu open
The right-click menu. Culling actions stay at the top level; everything reached occasionally sits behind one hover.

The copy set

The copy set is a running selection you paste somewhere else.

Ctrl+Shift+C Add the current photo to the set, or take it out again. Photos in the set carry a gold star on their thumbnail.
Ctrl+V In Explorer or Finder: drops every file you collected. The clipboard is rewritten each time you add one, so it always holds the whole set.
Ctrl+Shift+R Empty the set and clear the clipboard
Ctrl+L Copy the current photo's full path as text

Rotating for print

R turns the photo a quarter clockwise, Shift+R anticlockwise. The file on disk is turned, not just the view.

Menu → Rotate also has the pass a print run needs. All landscape and All portrait turn only the photos facing the wrong way, so a mixed folder comes out uniform for the paper feed — photos already facing the right way are left untouched. Revert rotations puts the whole folder back the way it arrived, after the run.

Pixels really move, because print machines ignore the EXIF orientation flag — flipping only the flag would fail exactly where it matters. JPEGs are re-encoded with their own original quantisation tables, so a rotate costs well under 1% of file size rather than visible quality; and where only the orientation flag is wrong, as on every phone shot, nothing is re-encoded at all. What changed is recorded in a single CoolGorilla-rotations.json per folder — one small file, not one per photo — which is what makes Revert rotations work even after you close the app.

Print size

Menu → Settings → Print size sets the resolution and unit used for the paper measurement in the detail bar. A lab working at 300 dpi in centimetres and someone preparing web images at 72 dpi want different numbers from the same file, so this is set once and remembered. Untick Show in the status bar to hide it again.

The Print size dialog with 300 dpi and centimetres selected
The preview line uses the photo you are on, so you can see the effect of a change before accepting it.

Properties and EXIF

Alt+Enter opens everything the file knows about itself: name, folder, type, pixel dimensions and megapixels, print size, bytes, modified and created dates — then the camera block: body, lens, aperture, shutter, ISO, focal length, exposure compensation and the moment it was taken.

The Image properties dialog showing dimensions, print size and a full camera block
Properties for a Sony RAW. Where the operating system cannot report a true creation time, that row shows a dash rather than a made-up date.

Removing EXIF data

Menu → EXIF data → Remove EXIF data. Tick what should go — GPS location, camera, lens and serial numbers, capture settings, date and time, software, artist and copyright — and it is stripped from the open photo. Groups the file does not carry are greyed out, so you can see at a glance whether a photo is even carrying its location.

The Remove EXIF data dialog with GPS location greyed out and four groups ticked
This photo has no GPS to remove. The backup tick is what makes the removal reversible later.
  • Pixels are never recompressed. Only the JPEG's EXIF segment is rewritten; the compressed image data is copied through byte for byte.
  • With the backup box ticked, the original EXIF is saved beside the photo. It travels with the file when you approve or reject, and goes to the Recycle Bin with it if you delete.
  • Recover EXIF data puts it back from that backup. Unlike undo, it still works on a photo you stripped days ago.
  • Don't show this dialog again makes later removals happen in one keystroke with the same choices. Bring the prompt back with Ask before removing EXIF in the same menu.

JPEG only, on purpose. RAW and TIFF are refused: rewriting a proprietary RAW container risks the original, and TIFF keeps its EXIF in the file's own directory, so removing tags would mean rewriting the whole image. The embedded preview thumbnail is always removed as well — it can still show the un-edited frame.

Opening in another app

Menu → Open in. The first time, pick your editor; it is remembered by name after that, and Change external editor swaps it. Give it a key in the shortcuts dialog and a photo goes to Lightroom or Photoshop with one press. Open with hands the photo to the system's own chooser for a one-off app, and L opens the photo's location — Explorer with the file selected, Finder on macOS, the containing folder on Linux. If another program rewrites a photo you have open, CoolGorilla notices when you come back to the window and reloads it.

Making the keys yours

Menu → Settings → Keyboard shortcuts. Double-click an action, or select it and press F2, then press the combination you want. Esc cancels, Clear leaves an action with no key, and Restore Defaults puts everything back. Changes take effect immediately — there is no restart.

  • Actions with several keys — Next is the right arrow, PgDn, Down and Space — keep their alternates; only the first key changes.
  • The rating keys 1–5 and Shift+1–5 are fixed and cannot be reassigned or taken by something else.
  • A key already in use is refused the moment you press it, naming the action that has it.
  • Remove EXIF data, Recover EXIF data, Open with and Open in editor ship with no key at all — assign them here if you use them often.
The Keyboard shortcuts dialog listing actions and their keys
Rebound keys are shown in blue, so you can see at a glance what you have changed.

All keys

Key Action
PgDn Space Next photo (wraps around)
PgUp Previous photo
Home · End First · last photo
15 Star-rate the photo
0 Clear the rating
Shift+15 Rate, and move to the matching Approved star folder
A Approve — move to Approved
X Reject — move to Rejected
Delete Move to the Recycle Bin (asks first)
Ctrl+Z · Ctrl+Shift+Z Undo · redo
Ctrl+Shift+C Add to or remove from the copy set
Ctrl+Shift+R Clear the copy set and the clipboard
Ctrl+L Copy the photo's path
R · Shift+R Rotate right · left
Ctrl+0 · 1 · 2 Fit · actual size (100%) · fill
Z Lock zoom across frames
T Show or hide the filmstrip
F · F11 Fullscreen · fullscreen, image only
Esc Leave fullscreen, otherwise quit
L Open the photo's location
Alt+Enter Properties, with EXIF
Ctrl+O · Ctrl+Shift+O Open files · open a folder
Ctrl+W · Ctrl+Q Quit

What CoolGorilla writes, and where

Nothing is written inside your photos except when you explicitly rotate one or remove its EXIF. Everything else lives beside them:

IMG_0001.xmp The star rating, in the format Lightroom and Bridge already use
IMG_0001.exifbak The EXIF you removed, kept so it can be put back
CoolGorilla-rotations.json One per folder: what was turned and which way, so a print run can be reverted
Approved\ Rejected\ Subfolders created next to your photos when you cull. Files are moved into them — never deleted.

Preferences — sort order, print size, your shortcut changes, the remembered editor — are stored per user, outside your photo folders.

Updates

The version from this website checks for a new release on startup and offers it; turn that off under Settings → Check for updates on startup. The Microsoft Store version updates through the Store. Menu → What's new shows what changed in each release.