chore: prepare release 0.4.1

CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.1] - 2026-06-03
+
+### Features added
+- Added app theming engine with Look and Feel settings.
+- Added Font Size, List Row Density, and Menu Bar Icon settings.
+- Added tray icon and context menu for main window and queues.
+- Added site logins integration directly into the Add Downloads window.
+
+### Changes
+- Updated the paste hint to use a visual Command icon.
+
+### Fixes
+- Resolved SwiftUI infinite layout freeze caused by MenuBarExtra binding.
+- Fixed a bug with Light/System theme appearance.
+- Fixed phantom state issues with Menu Bar Icon setting and conditionally applied theme backgrounds to preserve native macOS translucency.
+
 ## [0.4.0] - 2026-06-03
 
 ### Changes

README.md

@@ -92,8 +92,8 @@ make dmg
 ### Release
 GitHub Actions builds and publishes the macOS ARM64 DMG when a version tag is pushed:
 ```bash
-git tag v0.1.0
-git push origin v0.1.0
+git tag v0.4.1
+git push origin v0.4.1
 ```
 
 ---
@@ -110,6 +110,12 @@ git push origin v0.1.0
 
 ---
 
+## 🏆 Credits
+
+Firelink relies on [aria2](https://aria2.github.io/) as its underlying multi-protocol and multi-source command-line download utility. Special thanks to the aria2 contributors for their excellent engine.
+
+---
+
 ## 📄 License
 
 Firelink is released under the MIT License. See [LICENSE](LICENSE) for details.

Sources/Firelink/AddDownloadsView.swift

@@ -21,6 +21,10 @@ struct AddDownloadsView: View {
     @State private var headerText = ""
     @State private var cookieText = ""
     @State private var mirrorText = ""
+    @State private var useAuthorization = false
+    @State private var authUsername = ""
+    @State private var authPassword = ""
+    @State private var saveLogin = false
 
     var body: some View {
         VStack(spacing: 0) {
@@ -139,6 +143,30 @@ struct AddDownloadsView: View {
                     }
                 }
             }
+
+            GridRow(alignment: .top) {
+                Label("Authorization", systemImage: "lock.shield")
+                    .font(.headline)
+                    .padding(.top, 4)
+                VStack(alignment: .leading, spacing: 10) {
+                    Toggle("Use authorization", isOn: $useAuthorization)
+                        .toggleStyle(.switch)
+                    
+                    if useAuthorization {
+                        HStack(spacing: 10) {
+                            TextField("Username", text: $authUsername)
+                                .textFieldStyle(.roundedBorder)
+                                .frame(width: 160)
+                            SecureField("Password", text: $authPassword)
+                                .textFieldStyle(.roundedBorder)
+                                .frame(width: 160)
+                        }
+                        Toggle("Save login for this website", isOn: $saveLogin)
+                            .font(.caption)
+                            .foregroundStyle(.secondary)
+                    }
+                }
+            }
         }
     }
 
@@ -365,6 +393,13 @@ struct AddDownloadsView: View {
             )
         }
 
+        if let firstURL = urls.first, let creds = settings.credentials(for: firstURL) {
+            useAuthorization = true
+            authUsername = creds.username
+            authPassword = creds.password
+            saveLogin = false
+        }
+
         metadataTask = Task {
             var loaded: [PendingDownload] = []
             for url in urls {
@@ -400,12 +435,30 @@ struct AddDownloadsView: View {
     }
 
     private func addDownloads(start: Bool) {
+        var explicitCredentials: DownloadCredentials? = nil
+        if useAuthorization {
+            let cleanUsername = authUsername.trimmingCharacters(in: .whitespacesAndNewlines)
+            if !cleanUsername.isEmpty {
+                explicitCredentials = DownloadCredentials(username: cleanUsername, password: authPassword)
+                if saveLogin {
+                    var savedHosts = Set<String>()
+                    for item in pendingDownloads {
+                        if let host = item.url.host, !savedHosts.contains(host) {
+                            settings.addSiteLogin(urlPattern: "*.\(host)", username: cleanUsername, password: authPassword)
+                            savedHosts.insert(host)
+                        }
+                    }
+                }
+            }
+        }
+
         controller.addPendingDownloads(
             pendingDownloads,
             connectionsPerServer: Int(connectionsPerServer),
             overrideDirectory: overrideDirectory,
             startImmediately: start,
             queueID: targetQueueID,
+            credentials: explicitCredentials,
             transferOptions: transferOptions,
             speedLimitKiBPerSecond: speedLimitEnabled ? speedLimitKiBPerSecond : nil
         )

Sources/Firelink/AppSettings.swift

@@ -65,6 +65,18 @@ struct DownloadProxyConfiguration: Equatable, Sendable {
 
 @MainActor
 final class AppSettings: ObservableObject {
+    @Published var appTheme: AppTheme = .system {
+        didSet { save() }
+    }
+    
+    @Published var appFontSize: AppFontSize = .standard {
+        didSet { save() }
+    }
+    
+    @Published var listRowDensity: ListRowDensity = .standard {
+        didSet { save() }
+    }
+
     @Published var perServerConnections: Int {
         didSet {
             let clamped = min(max(perServerConnections, 1), 16)
@@ -129,6 +141,9 @@ final class AppSettings: ObservableObject {
 
         if let data = defaults.data(forKey: storageKey),
            let stored = try? JSONDecoder().decode(StoredSettings.self, from: data) {
+            appTheme = stored.appTheme ?? .system
+            appFontSize = stored.appFontSize ?? .standard
+            listRowDensity = stored.listRowDensity ?? .standard
             perServerConnections = min(max(stored.perServerConnections, 1), 16)
             maxConcurrentDownloads = min(max(stored.maxConcurrentDownloads ?? 3, 1), 12)
             globalSpeedLimitKiBPerSecond = min(max(stored.globalSpeedLimitKiBPerSecond ?? 0, 0), 10_485_760)
@@ -137,6 +152,9 @@ final class AppSettings: ObservableObject {
             siteLogins = stored.siteLogins
             downloadDirectories = Self.decodeDirectories(stored.downloadDirectories)
         } else {
+            appTheme = .system
+            appFontSize = .standard
+            listRowDensity = .standard
             perServerConnections = 16
             maxConcurrentDownloads = 3
             globalSpeedLimitKiBPerSecond = 0
@@ -218,6 +236,9 @@ final class AppSettings: ObservableObject {
 
     private func save() {
         let stored = StoredSettings(
+            appTheme: appTheme,
+            appFontSize: appFontSize,
+            listRowDensity: listRowDensity,
             perServerConnections: perServerConnections,
             maxConcurrentDownloads: maxConcurrentDownloads,
             globalSpeedLimitKiBPerSecond: globalSpeedLimitKiBPerSecond,
@@ -277,6 +298,9 @@ final class AppSettings: ObservableObject {
 }
 
 private struct StoredSettings: Codable {
+    var appTheme: AppTheme?
+    var appFontSize: AppFontSize?
+    var listRowDensity: ListRowDensity?
     var perServerConnections: Int
     var maxConcurrentDownloads: Int?
     var globalSpeedLimitKiBPerSecond: Int?

Sources/Firelink/ContentView.swift

@@ -3,6 +3,7 @@ import SwiftUI
 
 struct ContentView: View {
     @EnvironmentObject private var controller: DownloadController
+    @EnvironmentObject private var settings: AppSettings
     @Environment(\.openWindow) private var openWindow
     @State private var selection: Set<DownloadItem.ID> = []
     @State private var sidebarSelection: SidebarSelection = .downloads(.all)
@@ -12,8 +13,10 @@ struct ContentView: View {
         NavigationSplitView {
             SidebarView(selection: $sidebarSelection)
                 .navigationSplitViewColumnWidth(min: 190, ideal: 220, max: 260)
+                .themeBackground(settings.appTheme.theme.secondaryBackground)
         } detail: {
             detailView
+                .themeBackground(settings.appTheme.theme.background)
         }
     }
 

Sources/Firelink/DownloadController.swift

@@ -116,6 +116,7 @@ final class DownloadController: ObservableObject {
         overrideDirectory: URL?,
         startImmediately: Bool,
         queueID: UUID = DownloadQueue.mainQueueID,
+        credentials: DownloadCredentials? = nil,
         transferOptions: DownloadTransferOptions = DownloadTransferOptions(),
         speedLimitKiBPerSecond: Int? = nil
     ) {
@@ -130,7 +131,7 @@ final class DownloadController: ObservableObject {
                 category: pending.category,
                 destinationDirectory: overrideDirectory ?? pending.defaultDirectory,
                 connectionsPerServer: clampedConnections,
-                credentials: settings.credentials(for: pending.url),
+                credentials: credentials ?? settings.credentials(for: pending.url),
                 checksum: transferOptions.checksum,
                 requestHeaders: transferOptions.requestHeaders,
                 cookieHeader: transferOptions.cookieHeader,

Sources/Firelink/DownloadTable.swift

@@ -161,7 +161,7 @@ struct DownloadTable: View {
                         ContentUnavailableView(
                             "No Downloads",
                             systemImage: "arrow.down.circle",
-                            description: Text("Use Add or press Command-V to paste one or more links.")
+                            description: Text("Use Add or press \(Image(systemName: "command"))V to paste one or more links.")
                         )
                     }
                 }
@@ -526,6 +526,7 @@ struct DownloadTable: View {
 }
 
 private struct DownloadRow: View {
+    @EnvironmentObject private var settings: AppSettings
     let item: DownloadItem
     let priorityNumber: Int?
     let visibleColumns: [DownloadColumn]
@@ -537,7 +538,7 @@ private struct DownloadRow: View {
             ForEach(visibleColumns) { column in
                 cell(for: column)
                     .padding(.horizontal, 8)
-                    .padding(.vertical, 8)
+                    .padding(.vertical, settings.listRowDensity.verticalPadding)
                     .frame(width: columnWidth(column), alignment: alignment(for: column))
                     .clipped()
             }

Sources/Firelink/FirelinkApp.swift

@@ -5,6 +5,7 @@ struct FirelinkApp: App {
     @StateObject private var settings: AppSettings
     @StateObject private var controller: DownloadController
     @StateObject private var schedulerController: SchedulerController
+    @AppStorage("showMenuBarIcon") private var showMenuBarIcon = true
 
     init() {
         let settings = AppSettings()
@@ -15,11 +16,13 @@ struct FirelinkApp: App {
     }
 
     var body: some Scene {
-        WindowGroup {
+        WindowGroup(id: "main") {
             ContentView()
                 .environmentObject(controller)
                 .environmentObject(settings)
                 .environmentObject(schedulerController)
+                .modifier(AppThemeModifier(theme: settings.appTheme))
+                .dynamicTypeSize(settings.appFontSize.dynamicTypeSize)
                 .frame(minWidth: 1180, idealWidth: 1280, minHeight: 720, idealHeight: 760)
         }
         .windowStyle(.titleBar)
@@ -28,6 +31,8 @@ struct FirelinkApp: App {
             AddDownloadsView()
                 .environmentObject(controller)
                 .environmentObject(settings)
+                .modifier(AppThemeModifier(theme: settings.appTheme))
+                .dynamicTypeSize(settings.appFontSize.dynamicTypeSize)
         }
         .windowResizability(.contentSize)
 
@@ -36,8 +41,12 @@ struct FirelinkApp: App {
                 DownloadPropertiesWindow(downloadID: downloadID)
                     .environmentObject(controller)
                     .environmentObject(settings)
+                    .modifier(AppThemeModifier(theme: settings.appTheme))
+                    .dynamicTypeSize(settings.appFontSize.dynamicTypeSize)
             } else {
                 ContentUnavailableView("Download Not Found", systemImage: "questionmark.circle")
+                    .modifier(AppThemeModifier(theme: settings.appTheme))
+                    .dynamicTypeSize(settings.appFontSize.dynamicTypeSize)
             }
         }
         .windowResizability(.contentSize)
@@ -50,5 +59,10 @@ struct FirelinkApp: App {
                 .keyboardShortcut("r", modifiers: [.command])
             }
         }
+
+        MenuBarExtra("Firelink", systemImage: "arrow.down.circle", isInserted: $showMenuBarIcon) {
+            TrayMenuView()
+                .environmentObject(controller)
+        }
     }
 }

Sources/Firelink/SettingsView.swift

@@ -4,6 +4,7 @@ import SwiftUI
 private enum SettingsSection: String, CaseIterable, Hashable {
     case downloads = "Downloads"
     case locations = "Locations"
+    case lookAndFeel = "Look and feel"
     case network = "Network"
     case siteLogins = "Site Logins"
     case power = "Power"
@@ -13,6 +14,7 @@ private enum SettingsSection: String, CaseIterable, Hashable {
     static let orderedCases: [SettingsSection] = [
         .downloads,
         .locations,
+        .lookAndFeel,
         .network,
         .siteLogins,
         .power,
@@ -23,6 +25,7 @@ private enum SettingsSection: String, CaseIterable, Hashable {
     var symbolName: String {
         switch self {
         case .downloads: "arrow.down.circle"
+        case .lookAndFeel: "paintpalette"
         case .network: "network"
         case .locations: "folder"
         case .siteLogins: "key.fill"
@@ -43,6 +46,7 @@ private enum SettingsSection: String, CaseIterable, Hashable {
 }
 
 struct SettingsView: View {
+    @EnvironmentObject private var settings: AppSettings
     @State private var selection: SettingsSection = .downloads
 
     var body: some View {
@@ -69,6 +73,7 @@ struct SettingsView: View {
             }
         }
         .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
+        .themeBackground(settings.appTheme.theme.background)
     }
 
     private var settingsSidebar: some View {
@@ -96,6 +101,8 @@ struct SettingsView: View {
         switch selection {
         case .downloads:
             DownloadSettingsPane()
+        case .lookAndFeel:
+            LookAndFeelSettingsPane()
         case .network:
             NetworkSettingsPane()
         case .locations:
@@ -112,6 +119,52 @@ struct SettingsView: View {
     }
 }
 
+private struct LookAndFeelSettingsPane: View {
+    @EnvironmentObject private var settings: AppSettings
+    @AppStorage("showMenuBarIcon") private var showMenuBarIcon = true
+
+    var body: some View {
+        Form {
+            Section("App Theme") {
+                Picker("Theme", selection: $settings.appTheme) {
+                    ForEach(AppTheme.allCases) { theme in
+                        Text(theme.rawValue)
+                            .tag(theme)
+                    }
+                }
+                .pickerStyle(.radioGroup)
+                
+                Text("Select a color palette for the app's user interface.")
+                    .font(.caption)
+                    .foregroundStyle(.secondary)
+            }
+            
+            Section("Display") {
+                Picker("Font Size", selection: $settings.appFontSize) {
+                    ForEach(AppFontSize.allCases) { size in
+                        Text(size.rawValue).tag(size)
+                    }
+                }
+                
+                Picker("List Row Density", selection: $settings.listRowDensity) {
+                    ForEach(ListRowDensity.allCases) { density in
+                        Text(density.rawValue).tag(density)
+                    }
+                }
+            }
+            
+            Section("Menu Bar") {
+                Toggle("Show menu bar icon", isOn: $showMenuBarIcon)
+                
+                Text("Provides quick access to downloads and queues from the macOS menu bar. Restart required if hiding.")
+                    .font(.caption)
+                    .foregroundStyle(.secondary)
+            }
+        }
+        .formStyle(.grouped)
+    }
+}
+
 private struct AboutSettingsPane: View {
     @StateObject private var updateChecker = AppUpdateChecker()
     @State private var availableUpdate: AvailableUpdate?

Sources/Firelink/Theme.swift

@@ -0,0 +1,140 @@
+import SwiftUI
+import AppKit
+
+enum AppFontSize: String, Codable, CaseIterable, Identifiable, Sendable {
+    case small = "Small"
+    case standard = "Standard"
+    case large = "Large"
+
+    var id: String { rawValue }
+
+    var dynamicTypeSize: DynamicTypeSize {
+        switch self {
+        case .small: return .small
+        case .standard: return .medium
+        case .large: return .xLarge
+        }
+    }
+}
+
+enum ListRowDensity: String, Codable, CaseIterable, Identifiable, Sendable {
+    case compact = "Compact"
+    case standard = "Standard"
+    case relaxed = "Relaxed"
+
+    var id: String { rawValue }
+
+    var verticalPadding: CGFloat {
+        switch self {
+        case .compact: return 4
+        case .standard: return 8
+        case .relaxed: return 14
+        }
+    }
+}
+
+enum AppTheme: String, Codable, CaseIterable, Identifiable, Sendable {
+    case system = "System Default"
+    case light = "Light"
+    case dark = "Dark"
+    case dracula = "Dracula"
+    case nord = "Nord"
+
+    var id: String { rawValue }
+
+    var theme: Theme {
+        switch self {
+        case .system, .dark:
+            return Theme.system
+        case .light:
+            return Theme.modernLight
+        case .dracula:
+            return Theme.dracula
+        case .nord:
+            return Theme.nord
+        }
+    }
+
+    var appearance: NSAppearance? {
+        switch self {
+        case .system: return nil
+        case .light: return NSAppearance(named: .aqua)
+        case .dark, .dracula, .nord: return NSAppearance(named: .darkAqua)
+        }
+    }
+}
+
+struct Theme: Equatable, Sendable {
+    var background: Color?
+    var secondaryBackground: Color?
+    var text: Color?
+    var secondaryText: Color?
+    var accent: Color?
+
+    static let system = Theme(
+        background: nil,
+        secondaryBackground: nil,
+        text: nil,
+        secondaryText: nil,
+        accent: nil
+    )
+
+    static let modernLight = Theme(
+        background: Color(nsColor: NSColor(calibratedRed: 0.98, green: 0.98, blue: 0.99, alpha: 1.0)),
+        secondaryBackground: Color(nsColor: NSColor(calibratedRed: 0.94, green: 0.94, blue: 0.96, alpha: 1.0)),
+        text: Color.primary,
+        secondaryText: Color.secondary,
+        accent: Color.accentColor
+    )
+
+    static let dracula = Theme(
+        background: Color(nsColor: NSColor(calibratedRed: 0.16, green: 0.16, blue: 0.21, alpha: 1.0)),
+        secondaryBackground: Color(nsColor: NSColor(calibratedRed: 0.27, green: 0.28, blue: 0.35, alpha: 1.0)),
+        text: Color(nsColor: NSColor(calibratedRed: 0.97, green: 0.97, blue: 0.95, alpha: 1.0)),
+        secondaryText: Color(nsColor: NSColor(calibratedRed: 0.38, green: 0.44, blue: 0.58, alpha: 1.0)),
+        accent: Color(nsColor: NSColor(calibratedRed: 1.00, green: 0.47, blue: 0.65, alpha: 1.0)) // Pink
+    )
+
+    static let nord = Theme(
+        background: Color(nsColor: NSColor(calibratedRed: 0.18, green: 0.20, blue: 0.25, alpha: 1.0)), // nord0
+        secondaryBackground: Color(nsColor: NSColor(calibratedRed: 0.23, green: 0.26, blue: 0.32, alpha: 1.0)), // nord1
+        text: Color(nsColor: NSColor(calibratedRed: 0.85, green: 0.87, blue: 0.91, alpha: 1.0)), // nord4
+        secondaryText: Color(nsColor: NSColor(calibratedRed: 0.57, green: 0.63, blue: 0.70, alpha: 1.0)), // nord3
+        accent: Color(nsColor: NSColor(calibratedRed: 0.53, green: 0.75, blue: 0.82, alpha: 1.0)) // nord8
+    )
+}
+
+struct AppThemeModifier: ViewModifier {
+    let theme: AppTheme
+
+    func body(content: Content) -> some View {
+        content
+            .tint(theme.theme.accent)
+            .onAppear {
+                NSApp.appearance = theme.appearance
+            }
+            .onChange(of: theme) { _, newTheme in
+                NSApp.appearance = newTheme.appearance
+            }
+    }
+}
+
+struct ThemeBackgroundModifier: ViewModifier {
+    let color: Color?
+
+    func body(content: Content) -> some View {
+        if let color {
+            content
+                .scrollContentBackground(.hidden)
+                .background(color)
+        } else {
+            content
+        }
+    }
+}
+
+extension View {
+    func themeBackground(_ color: Color?) -> some View {
+        modifier(ThemeBackgroundModifier(color: color))
+    }
+}

Sources/Firelink/TrayMenuView.swift

@@ -0,0 +1,38 @@
+import SwiftUI
+
+struct TrayMenuView: View {
+    @Environment(\.openWindow) private var openWindow
+    @EnvironmentObject private var controller: DownloadController
+
+    var body: some View {
+        Button("Show main window") {
+            openWindow(id: "main")
+            NSApp.activate(ignoringOtherApps: true)
+        }
+
+        Button("Add downloads") {
+            openWindow(id: "add-downloads")
+            NSApp.activate(ignoringOtherApps: true)
+        }
+
+        Menu("Start queue") {
+            ForEach(controller.queues) { queue in
+                Button(queue.name) {
+                    controller.startQueue(queueID: queue.id)
+                }
+            }
+        }
+
+        Button("Stop downloads") {
+            for download in controller.downloads where download.status == .downloading {
+                controller.pause(download)
+            }
+        }
+
+        Divider()
+
+        Button("Exit") {
+            NSApplication.shared.terminate(nil)
+        }
+    }
+}