Orphan Sidecar Finder
Find unmatched sidecar and primary files locally without modifying them.
The problem it solves
Orphan Sidecar Finder Orphan Sidecar Finder is a read-only local CLI that matches subtitles, metadata, and other sidecar files to primary media or document files. It reports sidecars with no primary and primary files with no sidecar without opening, renaming, moving, or deleting anything.
Who Orphan Sidecar Finder is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with sidecar files, subtitles, metadata who want the documented v1.0.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Find unmatched sidecar and primary files locally without modifying them.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.0.0
Capabilities below come from the current project README and release documentation.
Orphan Sidecar Finder is a read-only local CLI that matches subtitles, metadata, and other sidecar files to primary media or document files. It reports sidecars with no primary and primary files with no sidecar without opening, renaming, moving, or deleting anything.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Verified release evidence
This project does not currently publish a screenshot or dedicated example folder. The current README, tests, changelog, tagged release, and source repository remain the verified examples of its behavior.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
Quick start
The shortest documented path into the current release.
python -m pip install "orphan-sidecar-finder @ https://github.com/loganpendragonmultiverse/orphan-sidecar-finder/releases/download/v1.0.0/orphan_sidecar_finder-1.0.0-py3-none-any.whl"
orphan-sidecar-finder "D:\Media" --markdown sidecars.md --json sidecars.jsonRecognized sidecar suffixes include common language and role markers such as .en, .forced, and .sdh. Matching is deliberately directory-local and conservative. Custom primary and sidecar extensions can be supplied repeatedly with --primary-ext and --sidecar-ext.
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
Everything stays local. Reports contain filenames, so review them before sharing. The tool does not inspect file contents, infer renamed editions, match across directories, or decide whether every primary should have a sidecar. A reported result is a review lead, not deletion advice.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
Everything stays local. Reports contain filenames, so review them before sharing. The tool does not inspect file contents, infer renamed editions, match across directories, or decide whether every primary should have a sidecar. A reported result is a review lead, not deletion advice.
License and release
Orphan Sidecar Finder is published under MIT. The current cataloged release is v1.0.0, published 2026-07-23.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Orphan Sidecar Finder v1.0.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical local repository. Fingerprint: 77dd4a7e4a63973d.