Skip to content
PN Scripts

Developer tools

Doppelkeep by PN Scripts

A command-line duplicate finder that also catches the copies other tools miss: the same photo or song with different tags. It shows what each copy would lose, keeps the one with the most metadata and never touches a copy that holds something the kept one lacks.

  • Go
  • SHA-256
  • BLAKE2b
  • Exif
  • ID3
  • Coming soon

Coming soon

Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.

Doppelkeep --twins report: twin groups of a PNG scan, MP3 song, two JPEG photos and a FLAC file, each with the kept copy, the metadata item counts and what other copies hold only themselves

What it solves

The gap

After years of backups, messaging apps, editors and tag managers, the same photo or song exists in several versions that differ only in metadata. Byte-hash duplicate finders call them all different, and a finder that ignores metadata would delete the copy with the rating, the GPS position or the caption.

What it is

Doppelkeep compares the picture or audio alone, groups copies that differ only in metadata, lists the metadata items each copy would lose, keeps the richest copy and replaces or moves only the copies that lose nothing.

How you use it

Reclaim the space of re-tagged and stripped copies of your photos and music without losing a single rating, GPS position or caption.

Other finders either see only byte-identical files or ignore metadata without telling you what you give up. Doppelkeep shows the difference first, item by item, and acts only where nothing is lost.

Who it is for

Use it when

  • Cleaning up photo libraries and scanned documents after phone backups, messaging apps or scanners stripped or added Exif data and notes
  • Merging music folders where a tag manager rewrote ID3 tags of files that are otherwise the same
  • Deduplicating media on a server with hard links without losing ratings or captions

Built for

  • Developers and system administrators who work in a terminal
  • Photographers and other heavy file users comfortable with a command line

What is inside

Twins: same picture or song, different tags

With --twins, Doppelkeep reads every JPEG, PNG, MP3 and FLAC file and separates the picture or audio from the metadata. Files with identical picture or audio data but different bytes form a twin group. IDAT chunk layout in PNG and tag padding in MP3 and FLAC are not part of the comparison, so only real picture or audio differences keep files apart.

What each copy would lose

Metadata is listed item by item: camera make and model, date taken, GPS location, XMP rating and Exif fields in JPEG; PNG text and time; ID3 frames and Vorbis comments with their values. For each copy Doppelkeep shows the items the kept copy does not have. A copy that loses nothing is marked as safe; a copy that holds something unique is flagged, and the kept copy is marked when another copy holds items it lacks.

Acting only where nothing is lost

--keep richest chooses the copy with the most metadata items. --link replaces a twin with a hard link to the kept copy only if it loses nothing and both pictures or audio streams are read again and still match. --trash-script writes the moves for safe copies and a NOT MOVED comment for the others. Metadata text is never put into the script as code.

Exact duplicates as before

Without --twins the tool behaves as a three-pass duplicate finder with table, JSON and CSV reports, globs, keep rules, hard-link mode and the review script. With --twins, byte-identical copies stay in the ordinary groups and are not counted twice.

Specs

Availability
Coming soon
Vendor
PN Scripts
Type
App
Platforms
Go
Pricing
One-time purchase Price to be announced.
License
Proprietary
Deployment
Download (static binaries for Linux, macOS and Windows, with source code)
Maturity
v3.0.0

Compatibility

Platform or runtime Supported versions Tested up to
Linux amd64 kernel 3.2 (Go 1.26 minimum) or newer Ubuntu 24.04, kernel 6.8
Linux arm64 kernel 3.2 (Go 1.26 minimum) or newer built, not run
macOS arm64 macOS 12 (Go 1.26 minimum) or newer built, not run
Windows amd64 Windows 10 (Go 1.26 minimum) or newer built, not run

Stack

  • Go
  • SHA-256
  • BLAKE2b
  • Exif
  • ID3
  • Vorbis comments

Doppelkeep by PN Scripts is coming soon

It is finished and tested. It is not on sale yet; this page will say where to get it when it is.

Coming soon

Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.

Questions

A command-line duplicate finder. It finds files with identical content and, with --twins, also the same JPEG, PNG, MP3 or FLAC picture or audio saved with different metadata, shows what each copy would lose and acts only on copies that lose nothing.

Only the binary for your system: Linux amd64 or arm64, macOS on Apple silicon, or Windows amd64. The Linux amd64 build was tested on Ubuntu 24.04; the others were cross-compiled but not run. Building from source needs Go 1.22 or newer.

Twin detection covers JPEG, PNG, MP3 and FLAC only, recognised by their content; resized, re-compressed or re-encoded copies are not detected, and formats such as MP4, HEIC or WAV are compared only as exact duplicates. There is no graphical interface, no automatic deletion and no merging of metadata between copies. Binary metadata such as an IPTC block or an embedded picture is compared by a short digest, not decoded. There is no Intel macOS binary and the binaries are not code-signed.

Doppelkeep is written in Go using only the standard library, with BLAKE2b implemented in the project and checked against the RFC 7693 test vectors. Automated tests generate valid JPEG, PNG, MP3 and FLAC files with chosen metadata and cover the payload comparison for every format, the metadata items, the keep rules, link and script safety and the output formats. Created with AI assistance; the duplicate search, the metadata reading, the twin rules, hard-link mode and review script were tested by PN Scripts with automated Go tests on generated test files and demo runs on Linux amd64.

It is not on sale yet. When it is, this page will link to the store; PN Scripts does not take payment on this site.