From 7127370611b418e468ea916ad443fee49c210925 Mon Sep 17 00:00:00 2001
From: nimbold <11913706+nimbold@users.noreply.github.com>
Date: Mon, 1 Jun 2026 05:50:19 +0330
Subject: [PATCH] docs: update project features and roadmap

---
 README.md | 35 +++++++++++++++++++++++++++--------
 1 file changed, 27 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 39bc000..2c557e4 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 Firelink is a clean SwiftUI download manager for Apple Silicon Macs. The goal is to bring the practical parts of IDM/FDM-style download management to macOS with a native interface, segmented downloads, queue control, automatic file organization, and credential-aware transfers.
 
-This project is early, but it already has a working native prototype and an `aria2c`-backed download engine.
+This project is early, but it already has a working native prototype, an `aria2c`-backed download engine, a queue-focused UI, batch link intake, and app-wide settings.
 
 ## Features
 
@@ -10,10 +10,22 @@ This project is early, but it already has a working native prototype and an `ari
 - Segmented downloads with a per-file connection count that also controls the split count.
 - Multiple files downloading at the same time.
 - Queue-based downloads with drag-and-drop priority ordering.
+- Batch Add Downloads window for pasting one or many links at once.
+- Automatic link parsing from newlines, whitespace, and common separators.
+- Metadata preview for new downloads, including file size when the server reports it.
+- Total required disk space and available disk space summary before adding downloads.
+- Per-batch save location override, while keeping automatic file-type folders by default.
 - Native macOS Settings window, available from App menu > Settings and the main toolbar.
 - Configurable default per-server connection count.
 - Configurable parallel file download limit in Settings.
 - Per-batch connection controls in the Add Downloads window.
+- Sidebar filters for all downloads, queued, active, completed, failed, and file categories.
+- Sortable, resizable download table columns with a right-click column chooser.
+- Default table columns for file name, size, progress/status, ETA, last try date, and date added.
+- Download row context menu with properties, show in Finder, resume, stop, queue, and delete actions.
+- Download properties window for editing URL, file name, save location, connection count, and login behavior.
+- Delete confirmation with optional move-to-Trash for downloaded or partial files.
+- Automatic cleanup of unfinished `.aria2` cache files when removing incomplete downloads.
 - Automatic save folders under `~/Downloads`:
   - `Musics`
   - `Movies`
@@ -65,13 +77,20 @@ Because the current machine only has Command Line Tools selected, this repositor
 
 ## Roadmap
 
-- Persist download history and queue state.
-- Improve site-login editing and migration tools.
-- Add browser integration and URL capture.
-- Add scheduler rules and speed limits.
-- Add checksum verification.
-- Add richer failure recovery and retry policies.
-- Add unit tests for file classification, queue behavior, and `aria2c` progress parsing.
+- Persist download history, queue order, column choices, and active download state across launches.
+- Bundle or manage `aria2c` automatically so users do not need a separate Homebrew install.
+- Add first-class pause/resume semantics with clearer partial-file and cache handling.
+- Add per-download and global speed limits, plus scheduler rules for start/stop windows.
+- Add retry policies, mirror fallback, and richer failure recovery for unstable servers.
+- Add browser integration or a companion extension for capturing download links from Safari/Chrome/Firefox.
+- Add cookie/header support for authenticated downloads that require browser sessions.
+- Improve site-login editing, credential migration, and matching diagnostics.
+- Add duplicate detection for URLs, file names, and already-downloaded files.
+- Add checksum/hash verification and optional post-download integrity checks.
+- Add download history search, saved filters, and better category management.
+- Add signed/notarized release builds, auto-update support, and downloadable GitHub releases.
+- Add localization-ready strings and accessibility review for keyboard and VoiceOver workflows.
+- Add unit and integration tests for file classification, URL parsing, queue behavior, settings persistence, `aria2c` progress parsing, and metadata fetching.
 
 ## License