{"id":43168343,"url":"https://github.com/wct097/eft-viewer","last_synced_at":"2026-06-04T12:00:23.378Z","repository":{"id":335690461,"uuid":"1146707720","full_name":"wct097/eft-viewer","owner":"wct097","description":"Open-source cross-platform viewer for EFT / ANSI-NIST-ITL biometric files — view fingerprint (WSQ), demographic, and transaction records. Windows · macOS · Linux.","archived":false,"fork":false,"pushed_at":"2026-06-03T03:21:50.000Z","size":1856,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T05:13:44.307Z","etag":null,"topics":["afis","ansi-nist","avalonia","biometrics","dotnet","eft","fingerprint","forensics","livescan","nist-itl","wsq"],"latest_commit_sha":null,"homepage":"https://github.com/wct097/eft-viewer/releases","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wct097.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-31T14:51:12.000Z","updated_at":"2026-06-01T11:32:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/wct097/eft-viewer","commit_stats":null,"previous_names":["wct097/eft-viewer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/wct097/eft-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wct097%2Feft-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wct097%2Feft-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wct097%2Feft-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wct097%2Feft-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wct097","download_url":"https://codeload.github.com/wct097/eft-viewer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wct097%2Feft-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33903134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["afis","ansi-nist","avalonia","biometrics","dotnet","eft","fingerprint","forensics","livescan","nist-itl","wsq"],"created_at":"2026-02-01T02:13:07.701Z","updated_at":"2026-06-04T12:00:23.364Z","avatar_url":"https://github.com/wct097.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EFT Viewer\n\nAn open-source, cross-platform viewer for Electronic Fingerprint Transmission (EFT) files based on the ANSI/NIST-ITL biometric data interchange standard.\n\n## Download\n\nDownload the latest release from the [Releases page](../../releases).\n\nSelf-contained builds are published for Windows, macOS, and Linux — no .NET runtime installation required.\n\n### Windows\n\nDownload `EftViewer-vX.X.X-win-x64.zip`, extract, and run `EftViewer.Desktop.exe`.\n\n### macOS\n\nDownload `EftViewer-vX.X.X-osx-arm64.zip` (Apple Silicon), extract, then:\n\n```bash\nchmod +x EftViewer.Desktop\n./EftViewer.Desktop\n```\n\nThe builds are not yet code-signed, so the first launch needs Finder → right-click → **Open** (or `xattr -dr com.apple.quarantine EftViewer.Desktop`) to clear Gatekeeper.\n\n### Linux\n\nDownload `EftViewer-vX.X.X-linux-x64.zip`, extract, then:\n\n```bash\nchmod +x EftViewer.Desktop\n./EftViewer.Desktop\n```\n\n## Screenshots\n\n| Type-4 Legacy Fingerprints | Type-14 Ten-Print Card |\n|:---:|:---:|\n| ![Type-4 flats](docs/images/flats-screenshot.png) | ![Type-14 tpcard](docs/images/tpcard-screenshot.png) |\n\n## Overview\n\nEFT files are used by the ATF, FBI, and other agencies for electronic fingerprint submission. This tool allows users to open, parse, and view the contents of EFT files including:\n\n- Transaction information (Type-1 records)\n- Descriptive/demographic data (Type-2 records)\n- Fingerprint images (Type-4, Type-14 records) with WSQ decompression\n- Additional biometric data records\n\n## Project Status\n\n**v0.1.0** - Initial release\n\n### Features\n\n- [x] Open and parse EFT file structure\n- [x] Display record hierarchy and metadata fields\n- [x] Decode and display WSQ-compressed fingerprint images\n- [x] Support for Type-4 (legacy) and Type-14 fingerprint records\n- [x] Windows desktop application\n\n### Future Goals\n\n- [x] PNG export for fingerprint images\n- [x] macOS and Linux builds (self-contained, build + test in CI)\n- [ ] Field validation against ANSI/NIST-ITL spec\n- [ ] Type-10 (face/SMT) and Type-15 (palmprint) support\n- [ ] Code signing via [SignPath.io](https://signpath.io) (eliminate Windows SmartScreen warning)\n\n## Technology Stack\n\n| Component | Technology | Notes |\n|-----------|------------|-------|\n| Core Parser | C# / .NET Standard 2.0 | Shared library, broad compatibility |\n| Desktop UI | Avalonia UI / .NET 10 | Cross-platform (Windows, macOS, Linux) |\n| Mobile (future) | .NET MAUI | Android/iOS |\n| WSQ Codec | Managed C# (Managed.Wsq-derived) | FBI wavelet compression standard, no native deps |\n| Alt CLI | Python | Scripting/automation use cases |\n\n### Why These Choices\n\n**Avalonia UI over MAUI for desktop**: More mature cross-platform desktop support today. MAUI excels at mobile but Avalonia provides better Windows/macOS/Linux parity for desktop apps.\n\n**.NET Standard 2.0 for core library**: Maximum compatibility across runtimes. The parser can be consumed by desktop, mobile, or even older .NET Framework projects if needed.\n\n## EFT / ANSI-NIST-ITL Format Reference\n\nThe ANSI/NIST-ITL standard (NIST Special Publication 500-290) defines a record-based format for biometric data interchange.\n\n### Record Types\n\n| Type | Description |\n|------|-------------|\n| 1 | Transaction information (required, exactly one) |\n| 2 | User-defined descriptive text |\n| 4 | Grayscale fingerprint image (legacy, 8-bit) |\n| 10 | Face, SMT (scars/marks/tattoos) image |\n| 14 | Variable-resolution fingerprint image (current standard) |\n| 15 | Variable-resolution palmprint image |\n\n### Structure\n\nRecords contain tagged fields in the format `Type.Field:Value`. Fields are separated by control characters:\n\n| Separator | Hex | Purpose |\n|-----------|-----|---------|\n| GS | 0x1D | Group separator (between fields) |\n| RS | 0x1E | Record separator (between subfields) |\n| US | 0x1F | Unit separator (between information items) |\n| FS | 0x1C | File separator (end of record) |\n\n### Image Encoding\n\nFingerprint images in Type-4 and Type-14 records are typically WSQ compressed (Wavelet Scalar Quantization), an FBI-developed format optimized for fingerprint ridge detail at ~15:1 compression.\n\n**WSQ Resources:**\n- NIST Biometric Image Software (NBIS): https://www.nist.gov/services-resources/software/nist-biometric-image-software-nbis\n- Contains reference `dwsq` (decode) and `cwsq` (encode) implementations in C\n\n## Sample Files\n\nThe `samples/` directory contains NIST-provided test files:\n\n- **nist-type-4-14-flats.eft** - Legacy Type-4 and modern Type-14 fingerprint records\n- **nist-type-14-tpcard.eft** - Ten-print card with Type-14 records and quality metrics\n\nSee `samples/README.md` for details and links to additional NIST test data.\n\n## Building from Source\n\n### Prerequisites\n\n- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) or later\n- Visual Studio 2022 or VS Code with C# Dev Kit (optional)\n\n### Build and Run\n\n```bash\n# Clone the repository\ngit clone https://github.com/wct097/eft-viewer.git\ncd eft-viewer\n\n# Restore dependencies\ndotnet restore\n\n# Build\ndotnet build\n\n# Run the desktop application\ndotnet run --project src/EftViewer.Desktop\n\n# Run tests\ndotnet test\n```\n\n### Solution Structure\n\n```\nEftViewer.sln\n├── src/\n│   ├── EftViewer.Core/          # Parser library (.NET Standard 2.0)\n│   └── EftViewer.Desktop/       # Avalonia UI application (.NET 10)\n└── tests/\n    └── EftViewer.Core.Tests/    # Unit tests (xUnit)\n```\n\n## AI-Assisted Development\n\nThis project is developed with AI assistance. Guidance for AI assistants lives in\n[CLAUDE.md](CLAUDE.md) and [docs/project_context.md](docs/project_context.md).\n\n## License\n\nCopyright 2026 William Tyler\n\nLicensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwct097%2Feft-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwct097%2Feft-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwct097%2Feft-viewer/lists"}