|
|
|
@@ -1,11 +1,12 @@
|
|
|
|
|
<div align="center">
|
|
|
|
|
<img src="Resources/AppIcon.png" alt="Firelink Icon" width="128" height="128" />
|
|
|
|
|
<h1>Firelink</h1>
|
|
|
|
|
<p><strong>A clean, native SwiftUI download manager for Apple Silicon macOS</strong></p>
|
|
|
|
|
|
|
|
|
|
[](https://swift.org)
|
|
|
|
|
[](https://apple.com)
|
|
|
|
|
[](https://aria2.github.io/)
|
|
|
|
|
[](LICENSE)
|
|
|
|
|
<a href="https://swift.org"><img src="https://img.shields.io/badge/Swift-6.0-orange?logo=swift&logoColor=white" alt="Swift Version" /></a>
|
|
|
|
|
<a href="https://apple.com"><img src="https://img.shields.io/badge/macOS-14.0%2B-blue?logo=apple&logoColor=white" alt="Platform Support" /></a>
|
|
|
|
|
<a href="https://aria2.github.io/"><img src="https://img.shields.io/badge/Engine-aria2c-red?logo=terminal&logoColor=white" alt="Engine" /></a>
|
|
|
|
|
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="License" /></a>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
@@ -17,8 +18,9 @@
|
|
|
|
|
## ✨ Key Features
|
|
|
|
|
|
|
|
|
|
- ⚡ **High-Speed Downloads:** Multi-segmented download engine powered by `aria2c` for concurrent connections and optimal bandwidth utilization. Supports HTTP, HTTPS, FTP, and SFTP.
|
|
|
|
|
- 🎨 **Native macOS & SwiftUI:** Responsive interface designed natively for Apple Silicon, featuring resizable tables, customizable columns, sidebar filters, and an in-app Settings page.
|
|
|
|
|
- 🎨 **Native macOS & SwiftUI:** Responsive interface designed natively for Apple Silicon, featuring resizable tables, customizable columns, sidebar filters, and an in-app Settings page with a built-in update checker.
|
|
|
|
|
- 🗂️ **Smart Queue & Categories:** Drag-and-drop priority ordering, batch link ingestion with smart parsing, and automatic file organization (`Musics`, `Movies`, `Compressed`, `Pictures`, `Documents`, `Other`) based on extension detection.
|
|
|
|
|
- 🛡️ **Reliability & Recovery:** Built-in download recovery and retry handling for interrupted or unstable transfers.
|
|
|
|
|
- 🔒 **Keychain Security:** Local macOS Keychain integration for secure site credential storage and matching during transfers.
|
|
|
|
|
- ⚙️ **Power & System Integrity:** Optional system sleep prevention during active downloads, disk-space safety checks, and automated cleanup of partial `.aria2` metadata cache files.
|
|
|
|
|
|
|
|
|
@@ -31,6 +33,7 @@
|
|
|
|
|
- Segmented downloads with per-file connection/split counts.
|
|
|
|
|
- Multi-threaded, parallel downloading with configurable limits.
|
|
|
|
|
- Support for HTTP, HTTPS, FTP, and SFTP transfers via `aria2c`.
|
|
|
|
|
- Automatic download recovery and retry handling for unstable connections.
|
|
|
|
|
- **Advanced Queue Control:**
|
|
|
|
|
- Drag-and-drop download reordering to manage priorities.
|
|
|
|
|
- Comprehensive download table with resizable, custom columns (Name, Size, Status, ETA, Dates).
|
|
|
|
@@ -46,6 +49,7 @@
|
|
|
|
|
- **Security & System:**
|
|
|
|
|
- Local macOS Keychain integration for site logins.
|
|
|
|
|
- Prevents system sleep while active transfers are in progress, preserving display sleep.
|
|
|
|
|
- Built-in update checker inside the Settings About pane.
|
|
|
|
|
- Release `.app` bundle build scripts ready for distribution.
|
|
|
|
|
|
|
|
|
|
</details>
|
|
|
|
@@ -63,13 +67,11 @@ Firelink leverages `aria2c` under the hood as its core download engine. Unlike s
|
|
|
|
|
|
|
|
|
|
## 🛠️ Requirements & Setup
|
|
|
|
|
|
|
|
|
|
### 1. Install Dependencies
|
|
|
|
|
Ensure you have **Homebrew** and the **Swift toolchain** installed:
|
|
|
|
|
```bash
|
|
|
|
|
brew install aria2
|
|
|
|
|
```
|
|
|
|
|
- **OS Support:** macOS 14.0 or newer (built natively for Apple Silicon)
|
|
|
|
|
- **Toolchain:** Xcode 15+ / Swift 6.0 toolchain
|
|
|
|
|
### 1. Requirements
|
|
|
|
|
- **OS Support:** macOS 14.0 or newer (built natively for Apple Silicon).
|
|
|
|
|
- **Engine:** `aria2c` is fully packaged and bundled internally for a true Zero-Config experience. No external installations are required.
|
|
|
|
|
|
|
|
|
|
*For Developers:* If you are building the project from source, you must have the **Swift 6.0 toolchain** (Xcode 15+) installed.
|
|
|
|
|
|
|
|
|
|
### 2. Build & Run
|
|
|
|
|
Run the application directly via the terminal:
|
|
|
|
@@ -99,11 +101,12 @@ git push origin v0.1.0
|
|
|
|
|
## 🗺️ Roadmap
|
|
|
|
|
|
|
|
|
|
- [ ] **Data Persistence:** Store history, column layout preferences, and active queues across restarts.
|
|
|
|
|
- [ ] **Zero-Config Setup:** Automatically bundle and configure `aria2c` inside the `.app` bundle.
|
|
|
|
|
- [x] **Zero-Config Setup:** Automatically bundle and configure `aria2c` inside the `.app` bundle.
|
|
|
|
|
- [ ] **Bandwidth Limits:** Add global and per-download speed caps and calendar schedules.
|
|
|
|
|
- [ ] **Browser Extensions:** Capture links directly from Safari, Chrome, and Firefox.
|
|
|
|
|
- [ ] **Advanced Transfer Features:** Checksum validation, cookie/header ingestion, and smart mirror failovers.
|
|
|
|
|
- [ ] **Distribution:** Notarized release builds, automated Sparkle updates, and Homebrew formulae.
|
|
|
|
|
- [x] **Updates & Releases:** GitHub Actions DMG release pipeline and built-in update checker.
|
|
|
|
|
- [ ] **Distribution:** Notarized `.app` releases and Homebrew formulae.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
nimbold