1.4 KiB
File Tools
Identify, inspect and inventory local files in the browser.
File Tools is a standalone local-first application in the add·ideas Toolbox. Inputs are processed in the browser and are not uploaded.
Version 0.1 scope
- Bounded head/tail signature inspection with claimed-versus-detected MIME reporting
- Paged 512-byte hexadecimal/ASCII views plus bounded UTF-8 and extracted-string previews
- Streaming SHA-256 and SHA-512 hashing in a cancellable module worker
- Same-size and same-hash duplicate candidates plus deterministic JSON/CSV inventory manifests
Detection and entropy results are heuristics, not format validation, malware analysis or proof of encryption. A selection is limited to 500 entries; file contents remain represented by browser File handles and are read only for an inspection window, the visible hex window, or an explicitly requested streaming hash. File mutation, split/join and batch rename are not part of version 0.1. See docs/ARCHITECTURE.md and docs/PRIVACY-SECURITY.md.
Development
Requires Node.js 22 and npm 11.
npm ci
npm run check
npm run test:browser
Release
npm run release:artifact creates a deterministic release/file-tools-0.1.0.zip and checksum sidecar.
Licence
GPL-3.0-or-later. Runtime dependencies retain their own licences; see THIRD_PARTY_NOTICES.md.