Skip to content

File-Ferry

Choose a tag to compare

@sancy1 sancy1 released this 17 Sep 04:15
· 4 commits to main since this release

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.