A file index. Add files from your file system or previously created listings and quickly search for them using a simple CLI.
Find a file
2025-02-01 14:53:59 +01:00
metadex switch from Poetry to uv 2025-02-01 14:53:59 +01:00
scripts switch from Poetry to uv 2025-02-01 14:53:59 +01:00
.gitignore wip 2022-08-14 20:41:58 +02:00
metadex.ignore wip 2022-08-14 20:41:58 +02:00
poetry.lock add Ruff as linter 2023-04-15 16:55:56 +02:00
pyproject.toml switch from Poetry to uv 2025-02-01 14:53:59 +01:00
pyrightconfig.json wip 2022-08-14 20:41:58 +02:00
README.md wip 2022-08-14 20:41:58 +02:00
run switch from Poetry to uv 2025-02-01 14:53:59 +01:00
uv.lock switch from Poetry to uv 2025-02-01 14:53:59 +01:00

Metadex

Metadex is a database for file metadata. It offers a simple and powerful CLI to scan your file system and find indexed files.
It supports path mapping, fast fuzzy searching, and multiple hosts.
Limited support exists for importing of metadata from external file lists, like for example from ls -R.

It's mostly useful to access file information for files stored remotely or offline. For example it could be used to keep track of the contents of backup DVDs or other cold storage.

Other use cases might also emerge.
All files are indexed with their last modified timestamp and file size.
Since searches are quite fast and flexible the database could even be useful to query local file information, or generate statistics, or graphs like a used space map.

Example usage

metadex scan ~  # Add all files from your home directory to the index.
metadex ls '*.xml'  # List all .xml files.
metadex ls '.config/**.json'  # List all .json config files.
metadex ls .git --type d  # List all .git directories.