Settings

Interface

Scale

How large greycard draws its type and controls, as a percentage of the scaling your system already applies: 100 (the default) is the size your system's own display scaling gives, 150 is half again as large, and 75 is smaller. Type a whole number from 50 to 300; it is taken on Enter or when the sheet closes, and anything else puts the field back.

The change applies the next time greycard starts, and the sheet says so until then. The whole window scales, panels, sheets, and menus alike; a picture at 1:1 still shows one pixel of the image on one pixel of the screen. With the SLINT_SCALE_FACTOR environment variable set, greycard draws at that factor instead, and the sheet says so. A capture taken with --snapshot or --screenshot is drawn at the system's scale whatever the setting, so it looks the same on every machine; set SLINT_SCALE_FACTOR for one at another size.

Theme

The window's panels and text in Charcoal (default), a mid Grey, or Light, changed at once; the blue accent is the same in all three. The picture's surround keeps its own Canvas setting, so the theme never changes what a picture is judged against.

Scroll bars

Fade (default) draws a list's or a panel's bar as a thin thumb and lets the grid's and the filmstrip's fade away a moment after you stop scrolling. Stay keeps every bar drawn, its track too, so a panel that holds more below always shows it. Either way a bar widens under the pointer.

Scroll bar size

How thick every scroll bar is: Thin (default), Medium, or Wide, changed at once. A wider bar is easier to see and to grab; the filmstrip grows a few pixels taller to keep its bar off the frames.

Language

The window's language: System (default) follows your system's, or pick one of the languages greycard carries, each shown in its own name. A language greycard has no translation of is shown in English. The change takes effect the next time greycard starts.

One section open at a time

Off by default. On, opening a section of the develop panel folds every other section of its tab, so the one you are working in has the room. The Develop, Crop, Masks, Retouch, and Cull tabs each fold their own, but a section on both Develop and Masks (Light, Color, Curves, Mixer, Grading, Tint, and Detail) is folded or open on both at once. The left pane's sections are not touched. Turning it on folds nothing until the next section opens. A section you open by its title is scrolled into view as the others fold: all of it if it fits, else from its title.

Library

Start in

Where greycard opens when you start it without naming a folder.

Click Chosen folder again to pick another. If that folder is gone, say on a drive that is unplugged, or empty, greycard opens the last folder instead. A chosen folder that holds only folders opens as it does from the folder tree when it is a root or under one: its folders as tiles, or everything under it with With subfolders on. Under no root, the last folder opens.

The row under it picks the view: Loupe (default), one frame, or Library, the grid. A file you open greycard with opens in the Loupe whatever this says.

Show the filter bar

On by default. Turn it off and the filter bar leaves the grid's header and the Cull tab, and the grid takes its room. A filter you set stays on, so the grid may show fewer frames than the folder holds; turn the bar back on to see or clear it. Sort moves to the grid's top row while the bar is off.

Cell size

The grid's cell, in pixels, from 96 to 512; 176 by default. Type a size and press Enter, or close the sheet. Ctrl+wheel, + and − change it too, and the row shows where they left it.

Resize with the wheel

On by default. Turn it off and Ctrl+wheel scrolls the grid and the lightbox as the wheel alone does, never resizing them. + and − still resize.

Sidecars

Edits go

Where a frame's edit file (its .gcd) is written.

Both travel with the shoot when you copy the folder. greycard reads an edit from either place, so changing this loses nothing. An edit file saved by greycard 0.8 can't be read by 0.7 or earlier (see Where your edits live).

Changing it moves nothing by itself. Each frame's edit moves to the new place the next time it is saved, so a folder tidies itself as you work through it.

Move the open frames' sidecars

Shown when frames are open. The sheet says how many of their edit files are in the other place. Click the button, then Move 12 sidecars to confirm, and they all move at once.

Write XMP sidecars

Off by default. Turn it on to share ratings, labels and keywords with Lightroom or darktable: greycard then also writes a standard .xmp beside each raw. An .xmp that is already there is read either way.

Picks and rejects have no XMP field, so they stay in the .gcd.

RAW+JPEG

Treat a JPEG beside its raw as a separate frame

Off by default: the camera's JPEG beside its raw (IMG_0001.JPG beside IMG_0001.CR3) goes with the raw as one frame, marked +JPEG. Turn it on and each JPEG is a frame of its own, with its own rating and its own sidecar, and moving or deleting the raw leaves it where it is. The open folder changes at once. See A raw and its camera JPEG.

Thumbnails

The first line says what the cache holds, such as "312 thumbnails kept, 2.5 MB of 300 MB."

A folder you open again fills in at once from the cache, even after you move or rename it.

Network folders

Rescan every

10 minutes by default. A library folder on a network share can't be watched for changes, so greycard looks it over this often instead. 0 means only when greycard starts. Folders on your own drives are watched and need no rescan.

Editing

Canvas

The surround behind the picture, Black, Dark grey, Mid grey, Light grey, or White: the same choice as the swatches beside Canvas in the Develop tab's MONITOR section.

Monitor

The monitor's color profile, the same choice as the MONITOR section's, with a chosen file's path and Choose... under the row when it is File.

Soft proof

The profile and the intent, Perceptual or Relative, the soft proof shows the picture through: the same choices as the SOFT PROOF section's, which still turns the proof on and off.

Crop

Aspect

The aspect a frame's crop opens at when the frame has no crop of its own: as you press Crop, Draw, Level, Verticals or Horizontals on the Crop tab, or move to another frame while you crop.

Opening the crop changes nothing in the frame's edit until you drag, draw or pick an aspect, with one exception: under Last used at a ratio, pressing Crop crops the frame to it at once. A frame you move to while cropping is not cropped until you touch its crop. A frame you have already cropped keeps its crop and its aspect. See Cropping.

Presets

Says whether any of the develop presets that come with greycard are missing from your list. Restore puts back the ones you removed.

Export

Format

The format an export is written in, the same choice as the Export sheet's Format row.

Color

The color space an export is written in, the same choice as the Export sheet's Color row.

Edit in

The apps the frame menu's Edit in opens a frame in, one a row by name, in the order you added them. Add... picks another; × takes one off. See Edit in another app.

Models

Every model greycard knows, with its license, its size, and where it stands: in the store, downloading, or skipped, with why. Download all downloads every model this computer can run that is not in the store yet, one at a time; the button shows how much that is. Without a GPU with WebGPU, or on a card too small or without 16-bit floats, the generative remove is skipped; of the Subject model's two copies, only the one this computer uses comes. Where the AI features are off until ONNX Runtime for the CPU is downloaded, Download all takes it first. If one download fails, its line says why and the rest go on. Each model's full license is written beside it in the store. A download cannot be stopped once it has started. On a Mac, Download all also prepares Core ML for Sky and the denoiser, so their first use is as quick as the next.

Keys

Every key you can move, under the heading of its group: click an action's key, then press the new one. See Keys.

About

The version you are running, then the check for a newer one, then the folders greycard keeps its files in (see Where greycard keeps its files).

Updates

Check for a new version at launch

On by default. At most once a day, greycard asks GitHub whether a newer release is out, sending only its version number. If there is one, a button in the left pane says so and opens the release page. Nothing is downloaded or installed.

Turn the switch off to stop the check. Check now checks at once, whether the switch is on or off.

Not on this sheet

Some choices live where you use them, and are remembered from one session to the next:

• With subfolders, in the left pane's folder tree (Library)
• the Export sheet's other choices and export presets, and the folder exports go to (Exporting)
• how many frames go across the lightbox (Culling)
• the Loupe's mode, Cull or Develop, and Cull's Picture switch (Culling mode)
• the grid's sort order, for each kind of view (Sort order)

Where greycard keeps its files

Your edits are beside your raws (see Edits go). Everything else is in these folders. Deleting a cache folder costs only time: greycard makes it again, and downloads models again when needed.

The settings file is settings.json, the export queue export-queue.json and the library index library.sqlite. The current log is greycard-ui.log, and the three runs before are kept as greycard-ui-1.log (the latest), greycard-ui-2.log, and greycard-ui-3.log.

A settings file that will not parse, a hand edit with a typo say, is moved aside as settings.json.bad and the run starts on the defaults. A fresh file holding the defaults reappears at the first write, the launch's update check included.

The library index is kept out of the cache, because rebuilding a large library takes a long time.

On Linux, and on any system where they are set, the standard XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_CACHE_HOME and XDG_STATE_HOME variables move these folders.