Pages on UnGathered.com

About

Sat, 24 Oct 2026 00:00:00 +0000

UnGathered is a local collection checker. It starts with items selected from a folder, such as one directory per product or one Markdown file per article. A JSON manifest declares what each item should have beside it. The scanner reports the missing companions and failed checks, while keeping operational errors separate from ordinary gaps.

A manufacturing pack might need a specification, drawing and inspection record. An article might need a matching image file and a line crediting its photographer. The engine applies explicit naming and content rules. It does not guess what a document means or decide whether an image is legally usable. A folder can satisfy its declared rules and still be incomplete under a rule nobody wrote down.

Contact

Sat, 24 Oct 2026 00:00:00 +0000

Write to info@ungathered.com about UnGathered, collection rules or integration work.

For a reproducible problem, include the version, operating system, a manifest and a small folder layout that you can share. Reports contain paths and diagnostics, so inspect them before attaching private document packs. The code repository contains the current implementation and reference material.

Demo

Sat, 24 Oct 2026 00:00:00 +0000

A collection can look busy and still be missing something important. Choose a recorded scan below to see the expected companions and the gaps UnGathered reported. These are generated examples with placeholder documents and images. The manufacturing and publishing gap reports were produced by a downloaded UnGathered 0.1.0 binary; the repaired fixture is from the repository’s recorded demonstration.

This page displays saved reports. It does not inspect your computer, run a scan in the browser or repair files. The incidental absolute root path has been omitted from the display data; the counts and requirement results are unchanged. Both gap examples contain two selected items, with one complete item and two failed requirements.

Download

Sat, 24 Oct 2026 00:00:00 +0000

UnGathered is released under Apache 2.0. Each archive includes the executable, example manifests and reference files, with license notices. Choose the build for your operating system and processor.

Linux on Intel or AMD 64-bit

Linux on ARM64

macOS on Intel

macOS on Apple Silicon

Windows on Intel or AMD 64-bit

The SHA256SUMS manifest lets you check an archive after downloading it. Permanent download links follow the latest full release; versioned files remain on the releases page.

Quick Start

Sat, 24 Oct 2026 00:00:00 +0000

Unpack the archive for your operating system from the download page. The executable, example manifests and reference are included. UnGathered needs no service to run alongside it. This example creates a new, deliberately incomplete document pack:

mkdir -p collection/products/widget
printf 'Specification placeholder\n' > collection/products/widget/specification.pdf
./ungathered --manifest examples/manufacturing.json --root collection

The filenames illustrate document roles; that placeholder is not a real PDF. The scan should return exit 1 and report the missing drawing.pdf and inspection.csv. The rule also checks that the specification is a nonempty regular file. It does not parse PDF contents or decide whether the specification is adequate.

Reference

Sat, 24 Oct 2026 00:00:00 +0000

A version 1 JSON manifest contains named collections. Each collection selects a relative anchor glob with items, chooses file or directory as its kind, and lists named requirements under require. A minimum of one selected item is assumed unless min_items explicitly says otherwise. Manifest keys use lowercase ASCII spelling. Unknown fields, duplicate keys, unsupported globs and invalid regexes are rejected.

Each requirement gives an expected path relative to the scan root. The variables are {item}, the full relative anchor path; {name}, its basename; {stem}, the basename with its last extension removed; and {dir}, its parent directory. For articles/cafe.md those values are articles/cafe.md, cafe.md, cafe and articles. Required paths are literal after expansion, without wildcard searching.