npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@sebestyen/eidolon

v2026.11.4

Published

Find duplicate photos and videos by how they look, and export one clean library

Readme

Eidolon

Your photo library, without the duplicates, and back in order.

Ten years of photos end up in many places: the old phone's backup, the new phone's, a Google Takeout download, a laptop's Pictures folder copied to a USB drive "just in case", and photos sent back and forth over messaging apps. Merge them and you get the same picture five times under five names, as HEIC, JPEG and a blurry WhatsApp copy, with iPhone Live Photos split from their videos, and folders called DCIM, Camera Roll and New folder (3). Finding duplicates by name doesn't work, because the names are all different.

Eidolon looks at the pictures themselves. It finds every copy of a picture, whatever its name, format or size, lets you review them in your browser, and extracts one clean, well-named library with the best copy of each.

Sound familiar?

  • "I have the same photo three times, and I don't know which one to keep." Eidolon groups the copies of a picture: other formats, resized, re-compressed, renamed, sent through a messaging app, cropped or straightened. It marks the best one (the original over a crop, then the most pixels, the camera's own file, the sharpest), and Keep best drops the rest in one go.
  • "My Live Photos came out of my iPhone as loose photos and short videos." Eidolon pairs each still with its video again, exactly when they still carry Apple's Live Photo ID, by look when they don't, and exports them side by side under one name so photo apps can show them as one again.
  • "My phone filmed it sideways." Turn a video upright, all of it or only the part filmed sideways, and it plays upright once exported. Photos lying on their side are found by the faces in them and turned upright for you, and you can turn any photo yourself.
  • "My backups overlap, and I've merged them so many times I've lost track." Scan each one, combine the scans, and copies found across all of them group together. A scan done earlier isn't read again, and scanning again later only reads new or changed files.
  • "Half my library is junk." Blank and black frames and accidental one-second videos are suggested for you to drop, and bursts of nearly identical shots are shown together with the sharpest marked. Nothing is dropped unless you say so.
  • "My folders are a mess." Each picture goes into an album folder: the one you chose, else a folder name that means something (never DCIM or 100APPLE), else the event or the trip it was taken on (2019-06 Lisbon, Portugal), else its month. When you choose an album, Eidolon suggests the likely ones first: those with photos taken the same day, at the same place, or looking like this one, each saying why. Screenshots and documents get a folder of their own and stay out of your photo groups.
  • "I can't find the photo I'm thinking of." Search by name, place or caption, by what a picture shows ("dog", "beach"), by the words in it (a sign, a menu, a receipt), by who is in it, or by the weather that day ("snow"). Or search with a photo: show Eidolon one and it finds the same picture, or the same subject, with a slider for how alike they must be.
  • "I want to find everyone's photos by their name." Eidolon gathers the faces in your photos by person. Name a person, and their photos are found by that name, which goes with the photos you export. If someone's faces end up in two places (sunglasses can do that), give both the same name and they become one person.
  • "I don't want to lose the captions, places and dates I added over the years." What any copy of a picture knows (titles, captions, keywords, a Google Takeout file's details, where it was taken) goes with the copy you keep, in an .xmp file that photo apps read, with the place in words, the words read in the picture and the names of the people in it as keywords.
  • "Some of my old files might be damaged." Check files reads each file again and finds the ones damaged since they were scanned (a failing drive, a copy cut short). Repair puts back the exact bytes scanned from another copy, from a backup or from the scan's own recovery data, and only when you ask.

How it works

  1. Scan the folders you want to clean up: drives, backups, exports. It works with hundreds of thousands of files.
  2. Review the groups in your browser: keep or drop copies, move a photo to another group, choose albums, turn photos and videos, write titles and captions. Nothing happens to any file yet: Eidolon only remembers what you decided, and every change can be undone. It works with a keyboard, a mouse or a tablet's touch screen, even with the drive holding your originals unplugged.
  3. Extract the files you kept into a new folder. Only now are files copied: one copy of each, in its album, with a clear name, turned and captioned as you left it.

Your originals are never changed, moved or deleted: Eidolon only reads them and writes the clean library somewhere else. The one exception is Repair, when you ask it to fix a damaged file. Your photos never leave your computer: places, faces, the text in pictures and what they show are all worked out on your computer. Only the weather, if you turn it on, asks a weather service (Open-Meteo) about the town and the day, never about a photo or where exactly it was taken. It runs on macOS, Windows and Linux, or in Docker on a server or NAS.

Install

npm install -g @sebestyen/eidolon
eidolon            # its window opens: Open shows the review screen (--no-window: in the terminal)

or without installing: npx @sebestyen/eidolon.

This package is a small launcher: the first time it runs it downloads the program for this computer (about 370 MB, Linux, macOS or Windows, x86-64 or ARM) from the project's GitHub release, checks it against the checksum in this package, and keeps it in ~/.cache/eidolon/ (Windows: %LOCALAPPDATA%\eidolon\). Updating: npm install -g @sebestyen/eidolon@latest, or Update now where the review screen says a new version is out.

Settings are environment variables: DB_PATH (the database), HOST, PORT, ACCESS_KEY; eidolon --help lists them. Other ways to install, and every release: https://github.com/hiro5id/eidolon-releases

Credits

Place names: GeoNames, CC BY 4.0. Weather (if you turn it on): Open-Meteo, CC BY 4.0. Face detector (finds sideways photos): YuNet, OpenCV Zoo, MIT License. Face recognizer (People): SFace, OpenCV Zoo, Apache License 2.0. Text detector and recognizer: PP-OCRv3 and CRNN, OpenCV Zoo, Apache License 2.0. Search with a photo (same subject) and what pictures show: CLIP ViT-B/32 image encoder, OpenAI, MIT License.