A folder listing tells you which files are there. It can’t tell you which ones should be. A product folder holds the specification and the drawings, and nobody notices the inspection record never arrived. An article folder has its text and its picture, and the photographer’s credit line is missing. These gaps surface late, usually when someone asks for the file that isn’t there.
UnGathered looks for what’s missing. You write down, in a small JSON file, what should sit beside each item in a collection. UnGathered checks every selected item against those rules and reports the missing companions, the empty documents and the absent credit text. It’s read-only, it runs on your own files, and it’s one Go binary.
The Pitch in Four Numbers
- 6 checks in the recorded manufacturing example, finding 4 present companions and 2 gaps.
- 0 changes to your files. UnGathered reads and reports, and never repairs or moves anything.
- 3 report formats: text, JSON and a self-contained HTML report.
- Apache 2.0, with archives for Linux, macOS and Windows.
How It Works
You start from the items you care about in a folder, say every product, or every article. For each kind of item you declare its companions in a JSON manifest. A manufacturing pack might need a specification, a drawing and an inspection record. An article might need a matching image file and a line in the text crediting the photographer.
UnGathered walks the items and checks each one. Is the companion file there? Is the document empty? Does the text include the credit line? It reports what it finds in plain terms, and it keeps operational errors, like a file it couldn’t read, separate from ordinary gaps, so a scan error never hides as a “pass.”
The engine applies explicit naming and content rules and nothing else. It doesn’t try to work out what a document means or whether an image can be legally used. That keeps its answers predictable. The repository includes the manual, example manifests and the recorded verification runs.
An Honest Definition of Complete
The project is careful about one thing: a pass only means the rules you wrote are met. In its own words, a folder can satisfy its declared rules and still be incomplete under a rule nobody wrote down. Completeness applies to the selected items and the declared rules. Anything outside them isn’t checked. The reference spells out exactly what a complete result means.
Who It’s For
- Manufacturers and quality teams assembling document packs for each product, where a missing inspection record is a real problem.
- Publishers and editors who need every article to have its image and its photo credit before it goes live.
- Archivists and records managers checking that each record has its required attachments.
- Anyone handing over a collection who wants proof it’s complete before someone else finds out it isn’t.
Limits
UnGathered checks what you declare and nothing more. It doesn’t interpret documents, judge image rights or fix anything it finds. It works on local files, so there’s no hosted service and no account, which is a feature for private collections and a limit for teams that keep everything in the cloud.
The Four-Question Screening
Every project featured here gets the same four questions, the way you’d screen a startup idea.
1. Where is the money in it?
UnGathered is free and has no paid tier. The money is in regulated documentation. Manufacturing, medical devices, construction and aerospace all live on document packs that auditors check for completeness, and missing records cost real money in failed audits and delays. Paid paths include ready-made rule sets for common standards, connectors for document systems like SharePoint and cloud storage, scheduled checks with audit-ready reports, and support for quality teams. Publishing, with its credit and asset rules, is a second market.
2. What real problem does it solve?
Absence is hard to see. Every tool shows you what’s in a folder. Almost none tell you what isn’t, and the missing file is the one that causes trouble: the inspection record a customer asks for, the credit line a photographer complains about.
3. The technology in plain words
Think of a packing checklist taped inside every box: manual, cable, warranty card. UnGathered reads the checklist, opens every box and tells you which ones are missing the warranty card. It doesn’t decide what should be in the box. You write the checklist, and it checks every box against it.
4. Moat and differentiation
Document management systems store files and search them. They rarely check that each record has everything it should. UnGathered is small, local, read-only and explicit, which suits teams that can’t send files to a cloud service and auditors who want rules they can read. The moat that can grow is a library of rule sets for specific industries and standards, which is where the expertise lives and where buyers would pay.
Why It Matters
Missing paperwork is a quiet, expensive problem. It’s rarely found until an audit, a handover or a complaint. A tool that checks for gaps on demand turns that late surprise into a routine step.
Follow the Project
Start with the quick start, try the demo, read the reference, get it from the download page, or see the code in the UnGathered repository on GitHub. UnGathered is listed with the other open-source projects on SoftDevStudio.com, and more featured projects are in the Projects section.