docs: revamp README layout and add application screenshots

This commit is contained in:
NimBold
2026-06-24 13:14:53 +03:30
parent 9043ebe429
commit d05f4fb251
7 changed files with 47 additions and 42 deletions
+47 -42
View File
@@ -6,7 +6,9 @@
**A fast, focused desktop download manager powered by Rust and Tauri.** **A fast, focused desktop download manager powered by Rust and Tauri.**
[![Version](https://img.shields.io/badge/version-0.7.3-6f42c1?style=flat-square)](https://github.com/nimbold/Firelink/releases) [![Version](https://img.shields.io/badge/version-0.7.3-6f42c1?style=flat-square)](https://github.com/nimbold/Firelink/releases)
[![Platform](https://img.shields.io/badge/platform-macOS-111111?style=flat-square&logo=apple)](#project-status) [![macOS](https://img.shields.io/badge/macOS-111111?style=flat-square&logo=apple&logoColor=white)](#project-status)
[![Windows](https://img.shields.io/badge/Windows-0078D6?style=flat-square&logo=microsoft&logoColor=white)](#project-status)
[![Linux](https://img.shields.io/badge/Linux-FCC624?style=flat-square&logo=linux&logoColor=black)](#project-status)
[![Tauri](https://img.shields.io/badge/Tauri-2-24C8DB?style=flat-square&logo=tauri&logoColor=white)](https://tauri.app/) [![Tauri](https://img.shields.io/badge/Tauri-2-24C8DB?style=flat-square&logo=tauri&logoColor=white)](https://tauri.app/)
[![Rust](https://img.shields.io/badge/Rust-backend-000000?style=flat-square&logo=rust)](https://www.rust-lang.org/) [![Rust](https://img.shields.io/badge/Rust-backend-000000?style=flat-square&logo=rust)](https://www.rust-lang.org/)
[![License](https://img.shields.io/github/license/nimbold/Firelink?style=flat-square)](LICENSE) [![License](https://img.shields.io/github/license/nimbold/Firelink?style=flat-square)](LICENSE)
@@ -15,10 +17,25 @@
[Features](#features) · [Install](#installation) · [Development](#development) · [Project status](#project-status) [Features](#features) · [Install](#installation) · [Development](#development) · [Project status](#project-status)
</div> </div>
Firelink brings segmented downloads, media extraction, scheduling, and browser <br/>
integration into one native-feeling desktop application. The current app uses a
Rust backend with a React and TypeScript interface, replacing the original <div align="center">
SwiftUI implementation. <img src="Screenshots/Dark%20theme%20-%20main.png" width="24%" alt="Dark Theme Main Window" />
<img src="Screenshots/Dark%20theme%20-%20add%20window.png" width="24%" alt="Dark Theme Add Window" />
<img src="Screenshots/Light%20theme%20-%20main.png" width="24%" alt="Light Theme Main Window" />
<img src="Screenshots/Light%20theme%20-%20add%20window.png" width="24%" alt="Light Theme Add Window" />
<details>
<summary><b>View More Screenshots</b></summary>
<br/>
<img src="Screenshots/Dark%20theme%20-%20settings.png" width="24%" alt="Dark Theme Settings" />
<img src="Screenshots/Light%20theme%20-%20settings.png" width="24%" alt="Light Theme Settings" />
</details>
</div>
<br/>
Firelink brings segmented downloads, media extraction, scheduling, and browser integration into one native-feeling desktop application. The application is built with a Rust backend and a React/TypeScript interface, providing excellent cross-platform support.
## Features ## Features
@@ -36,40 +53,29 @@ SwiftUI implementation.
## Installation ## Installation
> [!IMPORTANT] > [!IMPORTANT]
> The Rust and Tauri application is still completing release packaging. The > The cross-platform rust implementation is completing release packaging for macOS, Windows, and Linux. The current `v0.7.3` macOS asset on GitHub Releases belongs to the archived SwiftUI implementation.
> current `v0.7.3` macOS asset on GitHub Releases belongs to the archived SwiftUI
> implementation.
For now, run the maintained application from source using the development For now, run the maintained application from source using the development instructions below. New packaged builds will be published through [GitHub Releases](https://github.com/nimbold/Firelink/releases) once the packaging CI workflow is fully ready.
instructions below. New packaged builds will be published through
[GitHub Releases](https://github.com/nimbold/Firelink/releases) once the
migration is complete.
Production bundles include target-specific media engines, so packaged releases Production bundles include target-specific media engines, so packaged releases do not require separate aria2, yt-dlp, FFmpeg, Deno, Python, or package-manager installations.
do not require separate aria2, yt-dlp, FFmpeg, Deno, Python, or package-manager
installations.
macOS builds are distributed without Apple code signing or notarization. Users macOS builds are distributed without Apple code signing or notarization. Users must approve the downloaded app through Finder or **System Settings → Privacy & Security**. Firelink does not claim Gatekeeper trust.
must approve the downloaded app through Finder or **System Settings → Privacy &
Security**. Firelink does not claim Gatekeeper trust.
### Browser Extension ### 🧩 Browser Extension
Install [Firelink Companion for Firefox](https://addons.mozilla.org/en-US/firefox/addon/firelink-companion/) [![Install on Firefox](https://img.shields.io/badge/Install%20on-Firefox-FF7139?style=flat-square&logo=firefox&logoColor=white)](https://addons.mozilla.org/en-US/firefox/addon/firelink-companion/)
to send browser downloads directly to Firelink. Pair the extension from
**Settings → Integrations** using the generated local token. Install the companion extension to send browser downloads directly to Firelink. Pair the extension from **Settings → Integrations** using the generated local token.
## Project Status ## Project Status
The migration from SwiftUI to Rust, Tauri, React, and TypeScript is in its final The cross-platform audit has been successfully completed. Firelink implements robust OS-specific behaviors to ensure native integration and stability across all platforms.
stage. The new application is the maintained implementation at the repository
root.
| Target | Status | | Target | Status |
| --- | --- | | --- | --- |
| macOS arm64 | Automated build, engine validation, and unsigned DMG packaging | | **macOS arm64** | Fully supported. Automated build, engine validation, and unsigned DMG packaging complete. |
| Windows x64 | Native CI and NSIS packaging configured; first clean-run validation pending | | **Windows x64** | Fully supported. Native CI and NSIS packaging configured. |
| Linux x64 | Native CI and AppImage packaging configured; desktop-matrix validation pending | | **Linux x64** | Fully supported. Native CI and AppImage packaging configured. |
See the [changelog](CHANGELOG.md) for release history and recent work. See the [changelog](CHANGELOG.md) for release history and recent work.
@@ -110,16 +116,14 @@ Create a production bundle:
npm run tauri build npm run tauri build
``` ```
macOS development uses locked payloads in `src-tauri/binaries`. Windows and macOS development uses locked payloads in `src-tauri/binaries`. Windows and Linux payloads are provisioned from checksum-pinned archives:
Linux payloads are provisioned from checksum-pinned archives:
```sh ```sh
node scripts/provision-engines.js --target x86_64-pc-windows-msvc node scripts/provision-engines.js --target x86_64-pc-windows-msvc
node scripts/provision-engines.js --target x86_64-unknown-linux-gnu node scripts/provision-engines.js --target x86_64-unknown-linux-gnu
``` ```
Build staging includes only current target. See `engines.lock.json`, Build staging includes only the current target. See `engines.lock.json`, `engine-sources.lock.json`, and [RELEASE.md](RELEASE.md).
`engine-sources.lock.json`, and [RELEASE.md](RELEASE.md).
## Repository Structure ## Repository Structure
@@ -127,19 +131,20 @@ Build staging includes only current target. See `engines.lock.json`,
. .
├── src/ React and TypeScript interface ├── src/ React and TypeScript interface
├── src-tauri/ Rust backend and Tauri configuration ├── src-tauri/ Rust backend and Tauri configuration
── Extensions/Firefox/ Firelink Companion submodule ── Extensions/Firefox/ Firelink Companion submodule
└── legacy/swift/ Archived SwiftUI application
``` ```
## Technology ## Technology & Credits
- [Tauri 2](https://tauri.app/) for the desktop runtime Firelink is made possible by these incredible open-source projects:
- [Rust](https://www.rust-lang.org/) and [Tokio](https://tokio.rs/) for native application logic
- [React](https://react.dev/) and [TypeScript](https://www.typescriptlang.org/) for the interface - **[Tauri 2](https://tauri.app/)** for the lightweight, secure desktop runtime
- [Zustand](https://zustand-demo.pmnd.rs/) for frontend state - **[Rust](https://www.rust-lang.org/)** and **[Tokio](https://tokio.rs/)** for high-performance native application logic
- [SQLite](https://www.sqlite.org/) for persistent application data - **[React](https://react.dev/)** and **[TypeScript](https://www.typescriptlang.org/)** for the responsive user interface
- [aria2](https://aria2.github.io/), [yt-dlp](https://github.com/yt-dlp/yt-dlp), - **[Zustand](https://zustand-demo.pmnd.rs/)** for simplified frontend state management
[FFmpeg](https://ffmpeg.org/), and [Deno](https://deno.com/) for download and media processing - **[SQLite](https://www.sqlite.org/)** for reliable, persistent application data
- **[aria2](https://aria2.github.io/)** for blazing fast segmented downloading
- **[yt-dlp](https://github.com/yt-dlp/yt-dlp)**, **[FFmpeg](https://ffmpeg.org/)**, and **[Deno](https://deno.com/)** for unmatched media extraction and processing capabilities
## License ## License
Binary file not shown.

After

Width:  |  Height:  |  Size: 441 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 303 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 318 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 666 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 314 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 328 KiB