WOUTER.TOOLS

    Photowatch - for your own photo library

    Find out where your photos end up.

    Every night Photowatch looks up photos from your own library with Google Lens, checks every find against your original, and gives you a quiet queue to go through in the morning.

    For photographers who want to know who uses their work: for a credit, for a license, or just to know.

    Free· Open source, MIT license

    macOS or Linux · Node.js 22.13 or newer · Chrome, Chrome Beta or Edge

    01

    Point it at your photos

    In Settings, add the folders with your exported JPGs and skip any subfolder with a click. Add your own websites, so your portfolio doesn't count as a find.

    02

    It searches at night

    From 01:15 to 07:00 by default, newest shoots first, at a pace Google accepts. Young photos are searched again, because publications often appear weeks after a shoot.

    03

    You review in the morning

    Your photo and the find side by side. 1 Allowed, 2 Not my photo, 3 Ignore, 4 Action needed.

    What you get

    A search that runs while you sleep, and a short list in the morning.

    Verifies every find

    Lens also returns pages that merely show the same subject. Photowatch compares the image Google shows with your original at eight scales and every position. Finds that score 75 or higher are shown; you can change that in Settings.

    Crops still match

    A 4:5 crop for Instagram or a strip from a panorama on a news site still matches your original. Another photographer's photo of the same stage does not.

    Newest first, then again

    Newest shoots go first. Young photos are searched again more often: weekly in the first month, once a year after two years.

    Skips near-duplicates

    Bursts and the same frame exported twice, for web and print say, are grouped per shoot and searched once.

    Adapts its pace to Google

    It starts at 200 searches a night, adds 50 after every week without a captcha, and halves and pauses for a day after one.

    Review with the keyboard

    Keys 1-4, all finds on one site at once, and undo. "Always fine" puts a whole site on your own list.

    Archive and claim letter

    Search the archive, export it as CSV, and copy a claim letter when a find needs action. The letter is a template you edit in Settings.

    Runs on your computer

    Nothing is uploaded except the photos you search for, to Google Lens. The app has no login, so it only answers on your own computer.

    Everything is a setting.

    Which folders to scan and which subfolders to skip, when the night scan runs, how fast, which sites are your own, and how strict the matching is. All in the app.

    Wouter Vellekoop

    Why I built this

    Built because photos travel further than the deal.

    I am Wouter Vellekoop, a concert and event photographer. Most of what I shoot is made for someone: an artist, a venue, a festival, a broadcaster. Those photos are meant to be used. But they also travel on, to places nobody agreed on, and often without a credit.

    Checking that by hand means dropping photos into Google Lens one at a time, and nobody keeps that up. So Photowatch does it at night on my own computer, checks whether a find is really my photo, and in the morning I decide what each one is.

    It started as my own setup. This is the general version: your folders, your sites, your settings, and the code on GitHub.

    Good to know

    What it can and can't do.

    Not an official API

    Photowatch uses Google Lens the way a person would, through a browser window. When Google changes its pages, searching stops until the code is updated. Use it for your own photos, at a modest pace, and check Google's terms for yourself.

    Only what Google has indexed

    Lens finds what Google can see. Closed groups, apps and print stay out of sight.

    Large libraries take a while

    At most a few hundred photos a night, newest first. A big archive takes a while to get through the first time.

    The claim letter is not legal advice

    It is a starting point. Edit it to fit your country and your terms.

    Requirements

    Install takes four commands. The README on GitHub walks you through them.

    macOS or Linux

    Made and used on a Mac. Linux is not tested yet, Windows neither.

    Node.js 22.13 or newer

    Clone the repo, run npm install and npm start, then open localhost:4410 in your browser.

    Chrome, Chrome Beta or Edge

    Photowatch searches in a real browser window off-screen. Google answers headless browsers with a captcha.

    Your photos as JPG

    It reads exported JPG files. Raws need exporting first.

    A computer that stays awake

    The night scan runs as long as the app runs and the computer is awake. On a Mac, a launch agent can start it at login; there is an example in the repo.

    MIT license

    Use it, change it, share it. The source is on GitHub.

    Know where your work is.

    A nightly search of your own library, every find checked against your original, and the decision left to you. Free, and it runs on your own computer.

    More on how I use it: finding out where your concert photos are published. Questions? hello@wouter.photo

    Free

    Open source, MIT license.

    Get it on GitHub