clientgallery.io

Photo Mechanic

Photo Mechanic Client Selects: From a Picks List to Tagged Photos

Your client picks in a browser gallery. You get back a plain text file of filenames. This guide turns that file into tagged frames in Photo Mechanic, with the two routes Camera Bits documents and the places each one can catch the wrong photo.

Updated 18 September 2026

If you ingest and cull in Photo Mechanic, your selects live there. The client, meanwhile, chooses their favourites somewhere else, in a gallery on the web.

The bridge between the two is a list of filenames. On clientgallery.io that list is a button called Export picks (.txt).

This guide covers what is in that file, the two ways Photo Mechanic can turn it into tagged photos, and what neither route can do.

One scope note up front. The most flexible search is a Photo Mechanic Plus catalog feature. Plain Photo Mechanic has a different tool, Find, and this page keeps the two apart because Camera Bits documents them differently.

What the picks file contains

The button sits in the studio view of a gallery. It appears only after the client has sent their picks, so there is nothing to export before that.

The download is a plain text file named after the gallery, as <gallery-title>-picks.txt.

QuestionWhat the file does
LayoutOne filename per line, no header row
OrderLoves first, then likes
Loves marked apart from likesNo. Nothing in the file shows where the loves end
Colour labelsNot included
Client commentsNot included
Photos with only a label and no pickNot included
File extensionsKept, exactly as the gallery stored the name

There is no CSV version and no copy-to-clipboard version. The client has no export of their own either. The .txt is the one list, and it is the studio who downloads it.

The extension decides whether names line up

Which name lands in the file depends on how the photo reached the gallery.

How the proof was uploadedName stored in the galleryWhat that means in Photo Mechanic
Browser upload of exported JPEGsThe dropped file's own name, for example a .jpgIt only matches your RAW files if the names line up, and the extension will differ
Published from Lightroom Classic with the pluginThe catalog photo's own filename, usually the RAW name with its extensionThe name matches the RAW file on your card or drive, even though the client saw a JPEG

If your proofs went up as JPEGs and your contact sheet shows RAW files, clean the list first. Open the .txt in any text editor and replace .jpg with nothing. What remains are base names.

Base names are shorter, and shorter names catch more. That trade is covered in each route below.

Route one: the Find tool in plain Photo Mechanic

Find works on the contact sheet, so it is available without Photo Mechanic Plus. Camera Bits documents it under Edit, Find, with Command-F on macOS and Control-F on Windows.

  1. Open the contact sheet for the shoot.
  2. In the .txt, turn the line breaks into spaces, so every name sits on one line. Any text editor with find and replace can do this.
  3. Open Find and paste the line into the search field.
  4. Tick the Filenames option. Camera Bits: "Select the desired option to search Filenames, IPTC Metadata, or both."
  5. Choose Any of the words. Camera Bits documents the choice between finding any word in the phrase or only results that have all the words. A list of different filenames needs any.
  6. Set the search to all items on the contact sheet, not only the items already selected.
  7. Turn on the option that switches the contact sheet to the Selected filter after a successful Find. Camera Bits: "When selected, the Contact Sheet will filter to show only the selected files that match the Find search."

You now have the client's picks selected and nothing else on screen. Tag them while the selection is live. Camera Bits describes tags as "simple toggles", where "A photo is either tagged or untagged." "T" toggles the tag on a single image, and the Tagging article documents a separate shortcut for tagging a selection together.

Then use the View menu to show only tagged photos. Camera Bits lists the choices as All, Tagged and Untagged.

What Find does not document. The Find page does not say whether a filename term matches part of a longer name. It does offer a Whole words option, which it explains with the example that "book" excludes "bookkeeper". So check the count: the number of tagged photos should equal the number of lines in the .txt. If it is higher, something extra matched. If it is lower, a name did not line up.

Route two: one OR search in Photo Mechanic Plus

Photo Mechanic Plus adds catalogs and a catalog search. Camera Bits states that a search runs on "all Catalogs in the Active Catalogs Panel" that have their Search checkbox enabled.

Two documented behaviours make it suit a picks list.

  • It matches filename text anywhere in the name. Camera Bits' own example: a search for "hill" finds keywords with hill, a byline of Jason Hill Photography, and "all photos that contained the letter sequence "hill" anywhere in the file name."
  • It accepts OR between terms. The documented example is "keywords ocean or beach or pier", which finds keywords that contain at least one of the three terms.

So the list becomes one query. Replace each line break in the .txt with or , then paste the result into the Plus search.

The same page documents AND, NOT, and double quotes for an exact phrase. It also mentions anchoring with ^ and $. We have not tested those anchors against filenames, so this guide does not rely on them.

The honest cost of a partial match. A letter-sequence match can pull in similar names. A base name such as IMG_1234 is also a letter sequence inside IMG_12345. A term can also hit a keyword or a byline, as the "hill" example shows. Full names with extensions narrow this, and so does limiting the search to the catalog that holds the shoot.

The Plus search page does not describe a bulk action on search results. Tag the results the same way as in route one, then compare the tagged count with the line count of the .txt.

The two routes side by side

PointFind (Photo Mechanic)Catalog search (Photo Mechanic Plus)
Where it searchesThe contact sheet, all items or selected itemsEvery active catalog with its Search checkbox on
How the list goes inNames separated by spaces, with Any of the wordsNames joined with "or"
Filename matching documentedFilenames option. Partial matching not stated. Whole words option availableLetter sequence anywhere in the file name
Can over matchCheck the count; the page does not sayYes: similar names, keywords and bylines
Shows only the matchesYes, with the switch to the Selected filterShows search results

What neither route gives you

Loves apart from likes. The .txt lists loves first, then likes, with nothing marking the boundary. One search tags them all the same way. If the two levels matter to your edit, Photo Mechanic will not recover them from this file.

The client's colour labels and comments. They are not in the file. The only route that carries labels into an editor is the Lightroom Classic plugin, covered next.

A mapping to Lightroom. Camera Bits documents that Lightroom Classic and Capture One "can recognize star ratings and color classes", and that "the text label for each class must be exactly the same in each app." It does not document how a Photo Mechanic tag becomes a Lightroom Pick flag, so this guide does not claim it does.

If you edit in Lightroom Classic after Photo Mechanic

If you cull in Photo Mechanic and edit in Lightroom Classic, the text file is the long way round.

Publish the proofs from the Lightroom Classic catalog with the clientgallery.io plugin, which shows up in Lightroom as ClientGallery. When the client has sent their picks, run Import ClientGallery Picks.

  • Likes get 3 stars.
  • Loves get 5 stars and the Pick flag.
  • The client's colour labels are applied as Lightroom labels.
  • Everything found goes into a collection inside a set called ClientGallery, reused on each run.
  • Frames the client did not touch are left alone, and develop settings are never changed.

Two cautions. On the frames it writes, the import replaces the earlier rating and label, so a Photo Mechanic star rating carried into Lightroom on a picked frame is overwritten. And the match is a contains match on filename: a catalog photo whose name contains the picked name is written too, which includes the same name in two folders.

The plugin writes labels by colour name. Camera Bits warns that class labels must match exactly between apps, so a Lightroom Classic set up with different label names may not show them as expected.

Who should skip this

You already deliver and proof inside a platform with a print store. clientgallery.io has no store and takes no commission. If prints and albums pay your bills through Pixieset or Pic-Time, a filename list is no reason to move.

You need loves and likes split without a plugin. The .txt does not carry the split. Outside Lightroom Classic, that is a real gap.

You deliver RAW files. clientgallery.io hosts JPEG proofs and does not warehouse RAW files or master video.

For everyone else, the plan is one price: 10 $ a month or 100 $ a year, with unlimited galleries under fair use and no platform branding on client pages. Capture One users have a dedicated command for the same file, covered in the Capture One filename list guide.

Sources

Every Photo Mechanic behaviour, option and quote on this page was read on the Camera Bits pages below on 18 September 2026. None of these pages shows a date, so each is cited by fetch date.

Frequently asked

Can Photo Mechanic select photos from a list of filenames?

Yes, by search. In plain Photo Mechanic, use Find with the Filenames option and Any of the words, with the names separated by spaces. In Photo Mechanic Plus, join the names with or in one catalog search. Camera Bits documents neither as a dedicated filename list command, so check the count of matches against the number of names.

Does Photo Mechanic's Find tool match part of a filename?

The Find page does not say. It offers a Whole words option, explained with the example that book excludes bookkeeper. Partial matching in filenames is documented for the Photo Mechanic Plus catalog search, which finds a letter sequence anywhere in the file name.

Why did the Plus search catch photos the client did not pick?

Because it matches a letter sequence anywhere in the name, and it also searches keywords and bylines. A short base name can sit inside a longer filename. Use full names with extensions where they line up, and limit the search to the catalog that holds the shoot.

Does the picks file tell me which photos the client loved?

No. The Export picks (.txt) file lists loves first, then likes, with nothing marking which is which. It also leaves out colour labels, comments and photos that only have a label. In Lightroom Classic the plugin keeps the levels apart: likes get 3 stars, loves get 5 stars and the Pick flag.

Is there a CSV export or a copy-filenames button?

No. The only export is the studio's Export picks (.txt) button, which appears after the client sends their picks. The client has no export of their own.

My proofs are JPEGs and my Photo Mechanic contact sheet shows RAW files. Will the names match?

Only if the names line up. A browser upload keeps the uploaded file's own name, so the list carries .jpg extensions. Remove the extension in a text editor before searching, and accept that shorter base names can catch similar names in the Plus search.

Do Photo Mechanic tags become Pick flags in Lightroom Classic?

Camera Bits does not document that, so do not rely on it. It documents that Lightroom Classic can recognise star ratings and color classes, and that class labels must be exactly the same in each app. If you edit in Lightroom Classic, the clientgallery.io plugin writes the client's picks into the catalog directly.

Your client galleries, under your name

Unlimited galleries, your branding, one-click Pixieset import, and a Lightroom plugin, all on a flat 10 $/month with everything included. Your first gallery is free.

Create your studio

Related guides

Photo Mechanic Client Proofing Workflow: Tag the Client's Selects From a Filename List