Repository navigation
File-Ferry
File-Ferry v1.0.0
First public release.
File-Ferry is a Windows desktop application that harvests files from anywhere on your PC, reads them byte-for-byte, and delivers them in any format you choose — as a single merged bundle or as separate per-file documents.
What it does
Add files three ways — paste paths or filenames, use the native file picker, use the folder picker
Find files by name alone — type note and the app finds note.txt, note.pdf, note.png, notes.md anywhere on your PC
Pick among matches — when a bare name is ambiguous, choose which files to include with presets (Newest 5, Largest 5, Select All, Select None)
Choose from nine formats — .txt · .md · .json · .html · .docx · .pdf · .xlsx · .csv · .zip
Two output modes — Separate Files (one output per source) or Single Merged (one combined file)
Clean output by default — content is preserved exactly as it is. Headers, code fences, TOC, and manifests are opt-in
Name your output — set the merged file name, or prefix separate files
Save anywhere — pick a destination folder, or let the app auto-save to a timestamped folder in Downloads
Built for reliability
Every file read, search, and write runs through a resilience pipeline powered by Portfolio.Resilience 0.8.0:
Retry with exponential backoff and jitter
Circuit breaker per policy — fail fast when a dependency is genuinely broken
Timeout per attempt — bounded operations, no hangs
Fallback — every call site degrades gracefully instead of throwing
Correlation IDs — one ID per harvest job, propagated to every event and metric
Live observability
Log drawer — every pipeline event streams into a collapsible overlay with color-coded status
Diagnostics tab — live p50/p95/p99 latency, error rates, in-flight counts, and circuit states per policy
Persistent JSON Lines log — daily-rotating, cleared on demand
Diagnostics export — full snapshot to JSON
Modern native interface
Avalonia UI 12 with Fluent design, Mica backdrop, rounded corners
Light, dark, and system-follow themes
Resizes smoothly, opens maximized by default
Custom title bar with logo, theme toggle, and log button
What is in the download
FileFerry-v1.0.0-win-x64.zip contains:
FileFerry.exe — the application (~72 MB, self-contained)
LatoFont/ — font files used by the UI
No installer. No .NET runtime required. No admin rights needed. Unzip and double-click FileFerry.exe.
Requirements
Windows 10 (build 19041 or later) or Windows 11
64-bit processor
~150 MB free disk space
Technology
.NET 10
C# 14
Avalonia UI 12.1.2
Portfolio.Resilience 0.8.0 (with analyzers)
DocumentFormat.OpenXml, QuestPDF, ClosedXML
Known limitations
Drag-and-drop onto the input panel is deferred to v1.1
Windows Search Index integration is deferred to v1.2 — v1.0 uses recursive filesystem walk for search
macOS and Linux builds are source-compatible but not yet packaged
The window uses the default Windows title bar with a custom branding bar below it; unified title bar is deferred
What is next
v1.1 — Cloud integration: AWS S3, Google Cloud Storage, Azure Blob, Google Drive, cross-provider transfers, OAuth credential management.
v1.2 — Extended search and polish: Windows Search Index integration, search history, custom skip lists.
License
MIT. See LICENSE.
Author
Alexander Sanchez Cyril
Full changelog: see CHANGELOG.md
Source code: git clone https://github.com/sancy1/file-ferry.git
How to Use These Notes
Go to https://github.com/sancy1/file-ferry/releases/new
Choose a tag: v1.0.0 (already pushed)
Release title: File-Ferry v1.0.0
Description: paste everything from the "File-Ferry v1.0.0" heading down to "Source code:" above
Attach binaries: drag artifacts\FileFerry-v1.0.0-win-x64-*.zip into the release form (or, if you have not created the .zip yet, run the compress command first)
Click Publish release
Once published, the release page becomes a permanent, shareable link that documents exactly what v1.0.0 delivers.