Features

Features

Release-by-release history: CHANGELOG.md · GitHub Releases

What's new in version 1.4 / 1.4.1 / 1.4.2 / 1.4.3 (build 23)

1.4.3 (build 23, 16 Sep 2026): maintenance release built with Xcode 27 and the 27.0 SDKs (iOS/iPadOS 27, macOS 27, tvOS 27, visionOS 27, watchOS 27), verified on the new simulators — iPhone 18 Pro / Pro Max, iPhone 17e, iPhone Air, iPad Pro 13-inch (M5), Apple TV 4K (3rd generation), Apple Watch Series 12, Apple Vision Pro; the Notifications row handles the new ephemeral permission state and the EC connection / connection-test code was hardened for Swift 6 (no behaviour change). Xcode 27.0 still ships no iPhone Duo simulator.

1.4.2 (build 22, 12 Sep 2026): on Apple TV the Restore from iCloud button is now reachable with the remote (focus sections in the walkthrough) and the password field opens the keyboard (it is alone in its row, with a Show password row); on iPhone/iPad/Vision Pro the Download and Connect to… dialogs are anchored to the tapped row; every text follows the device's text size (no fixed font sizes left); singular “one server profile”.

1.4.1 (build 21), same day, replaces 1.4 on every platform (Apple had already approved 1.4 on Apple TV and Vision Pro, so the fixed build needed a new version number): the Apple TV build of 1.3 and of build 19 shipped without the iCloud entitlements, so sync and backup restore never worked on tvOS; the walkthrough's iCloud backup search is now more patient (about 30 s, Search again button); the Apple TV color picker shows real color dots.

• Guided introduction (walkthrough) — at the first launch after the update every platform (iPhone, iPad, Mac, Apple Vision Pro, Apple TV) shows a short presentation: what the app is, transfers and search, server profiles and Offline mode, the quick actions of that platform (icon menu, Dock/menus/shortcuts, Siri Remote), the demo mode, then two setup pages — iCloud sync and notifications. Skip is always available; you can replay it from About → Show the introduction again.
• iCloud backup found → Restore — the iCloud page of the walkthrough looks for an existing backup (a few seconds, with retries) and, if it finds one, shows Found a backup with N server profiles (last updated …) with a Restore from iCloud button: profiles and passwords (iCloud Keychain) land on the new device without typing anything. The backup is one for all platforms — iPhone, iPad, Mac (DMG, Homebrew and Mac App Store), Vision Pro and Apple TV share the same iCloud Key-Value store and keychain access group. With no backup the page offers Turn on iCloud sync; either way you can enable it later from the app settings.
• Notifications without toggles — the in-app switches (master, completed downloads, disconnections, checks while disconnected, interval) are gone. The walkthrough — or the single Notifications › row that remains in the settings — asks for the system consent once; from then on you decide how to receive them in the system Settings (banners, sounds, badges; on iPhone/iPad also the Scheduled Summary). The row shows the current state (On, Summary, Off, Not requested) and opens the app's page in the system Settings. The app sends every alert that matters: download started, download completed, aMule server unreachable and reachable again, connection to the server lost, eD2k / Kad disconnected and reconnected (drops only when the server's auto-reconnect is off, reconnections only after a drop it has seen). Checks run every 5 minutes while the app is open (also in Offline mode) and about every 15 minutes in the background on iOS.
• App color — the Icon color setting is now App color: the seven colors also tint buttons, links, toggles, the selected tab and the walkthrough on every platform (Apple TV gets the setting too, as a picker), while the icon keeps changing on iPhone, iPad and Vision Pro and the Dock icon on the Mac.
• Shortcuts and Siri on every platform — the App Intents, previously iOS-only, now ship on iOS/iPadOS, macOS (Mac App Store build: the SwiftPM-built DMG cannot export them), visionOS and tvOS: aMule status, Download speed / Upload speed (numbers in kB/s), Number of queued downloads, Status of a download / Pause a download / Resume a download / Set a download's priority (by name), Pause all / Resume all, Remove completed downloads, Add eD2k link(s), Search files on aMule (returns the result names), Connect / Disconnect aMule from the eD2k network, Start or stop the Kad network. Six App Shortcuts appear in the Shortcuts app out of the box; all of them work with the app closed.
• Clipboard and sharing — the Add eD2k link sheet (iPhone, iPad, Vision Pro, Mac) takes several links at once: paste a list, one per line, or any text that contains them (a web page, a Notes entry, a message) and the app extracts the ed2k://|file|… links, shows how many it found and queues them all. A native Paste button avoids the clipboard permission prompt; on the Mac the sheet pre-fills from the clipboard and the Dock menu / Transfers menu get Add links from the Clipboard (⇧⌘L). Downloads can be shared as eD2k links (context menu and selection bar) to Notes, Messages, Mail or any share target.
• Apple TV keyboard fixed — typing with the Siri Remote or the iPhone Apple TV Keyboard no longer replaces the previous character or bounces the cursor: the connection form, the Add link sheet and the search field now use a native text field that keeps the keyboard's provisional text and commits it when editing ends (the system search bar was replaced by a field with a Search button).
• Legibility on Apple TV — the action buttons at the top of Transfers and Servers keep a readable label with the tinted look.
• iPhone Duo — the layouts are adaptive (no fixed frames, no device checks) and were reviewed on every iPhone/iPad simulator available in Xcode 27.0 (iOS 27); no dedicated iPhone Duo simulator exists yet, so nothing device-specific was added — the app follows the system's size classes on the new form factor.

Version 1.3 (build 18)

• Offline mode with local cache — the old "Disconnected for inactivity" is gone. After the chosen idle period (setting renamed "Go offline after inactivity"), or when the app goes to the background, the EC connection is closed to save battery and data, but the last data (transfers, servers, statistics, log) stays on screen under an Offline · data updated at HH:MM banner. The connection resumes by itself at the first tap or click, when the app returns to the foreground, or with the Reconnect button; when you reopen the app the cached snapshot appears instantly while it reconnects. The snapshot is a small JSON file per server in the app's cache folder — no database needed. On the Mac the idle timer is now real (clicks and key presses count as activity) and is off by default, so a monitoring window stays live; on Apple TV the app simply goes offline when it leaves the screen.
• iCloud sync of server profiles (opt-in, off by default) — More → App settings → Sync profiles with iCloud (iPhone/iPad/Vision Pro), Settings ⌘, → General (Mac App Store), Settings (Apple TV). Profiles, the default profile and deletions travel through iCloud Key-Value Storage; passwords through the iCloud Keychain. Conflicts are resolved by the most recent change; the same server saved on two devices is merged, not duplicated. A device without profiles shows "N server profiles found on iCloud · Restore" on the connection screen. It works on every official build, including the Developer ID DMG (which embeds an iCloud provisioning profile); only a local swift build copy without signing lacks it.
• Quick actions — long-press the app icon on iPhone/iPad: Add eD2k link, Pause all downloads, Resume all downloads, Search. The app connects by itself if needed (or wakes up from Offline) and reports how many downloads were paused/resumed. On the Mac the same actions are in the Dock menu (right-click the icon while the app runs) and in the new Transfers menu: Add eD2k link… (⌘L), Pause all (⌥⌘P), Resume all (⌥⌘R), Remove completed. visionOS and tvOS have no app-icon menu: Siri and Shortcuts remain the way to act from outside the app there.
• Apple TV app — see Apple TV.
• About section everywhere — More → About (iPhone/iPad/Vision Pro), Settings ⌘, → About and the About aMule Remote panel (Mac), Settings → About (Apple TV): version and build, author, MIT license (full text in the app), Guide (wiki), Report a problem (opens a GitHub issue pre-filled with version, build, platform and OS), Source code, Privacy policy. The Mac Help menu links to the same pages.
• License — the project is now released under the MIT License.

Version 1.2 (build 17)

• Notifications, redesigned (replaced in 1.4 by the system-level model, see above) — one master Notifications switch: turning it on asks for permission and sends a test notification ("Notifications on"); turning it off silences everything. Under it, separate toggles for completed downloads, eD2k/Kad disconnections and checks while disconnected, plus a check interval (1, 5, 15, 30 minutes or 1 hour). Checks keep running after the idle disconnect on every platform (iPhone, iPad, Mac, Apple Vision Pro); on iOS they also run in the background with Background App Refresh (never more often than every 15 minutes, to protect the battery). eD2k/Kad drops are reported only when the server's auto-reconnect is off — if amuled reconnects by itself there is nothing to warn about.
• Apple Vision Pro — native visionOS app, same features as iPhone/iPad.
• App icon colors — seven colors (green, blue, red, orange, purple, teal, graphite), each with light, dark and tinted variants, selectable in the app settings on iPhone, iPad and Vision Pro; on the Mac the Dock icon follows the chosen color and the system theme. (Apple Watch keeps the original icon: watchOS has no API for alternate icons.)
• Mac app aligned with iOS/iPad — same buttons, icons and layout in Transfers, Search, Servers, Statistics and Settings; the Mac gets the "Disconnect after inactivity" setting too.
• Transfers toolbar — a single ✓ button opens a menu with Select (multi-selection with the action bar: resume, pause, stop, priority, delete) and Remove completed.
• Show/hide password (eye icon) in every password field.
• Fixes — the Mac theme no longer gets stuck in dark mode when switching System → Dark → Light; a search that occasionally didn't start on the first try now always starts (the app stops any stale search on the server first).
• Icons everywhere — SF Symbols on every list row and setting.
• English store listing and availability in more countries (including those where Apple Vision Pro is sold).

Version 1.1 (build 16)

• Light / dark / system theme — selector on iOS (More → App settings) and macOS (Settings, ⌘,).
• 7 languages: English, Italian, Spanish, French, German, Simplified Chinese and Arabic (right-to-left layout) — in-app selector with a System option, the interface switches immediately.
• Server profiles: several named amuled servers; a default profile ★ proposed at launch; quick switching from the More tab (iOS) or the sidebar footer (macOS).
• Face ID / Touch ID lock (optional): the app asks for biometric authentication when opened and, on iOS, when it returns to the foreground; falls back to the device passcode. (Not available on Apple TV.)
• Apple Watch app: down/up speeds, network status and the download queue with progress, mirrored from the iPhone; notifications reach the wrist.
• Siri and Shortcuts (iOS; every platform since 1.4): "aMule Remote status", "Pause downloads", "Resume downloads", "Add eD2k link" — they also work with the app closed.
• Clickable ed2k:// links: a tap/click on an eD2k link in Safari, Mail or elsewhere opens the app and queues the download after confirmation.
• Adaptive icon: dark and tinted variants on iOS 18+; the Mac Dock icon follows the system theme.

Demo mode

On the connection screen, the "Try the demo mode" button (or DEMO as host and DEMO as password) opens the app filled with sample data — free content such as open movies, Linux ISOs and Project Gutenberg texts — with no server at all. Every feature works and is simulated locally (no network traffic): handy to explore the app before configuring amuled. To leave: More → Disconnect (iOS) or Disconnect (macOS). On Apple Vision Pro the demo button sits in the top-right corner of the connection window.

Transfers (downloads)

• Download queue with progress, speed, sources, ETA, priority and age (how many days the file has been queued).
• Progress bar colored by state: green = complete, blue = transferring, orange = paused, red = waiting with no sources, dark red = error.
• Actions: pause / resume / stop / delete, priority (low/normal/high/auto), category assignment.
• Multi-selection (✓ → Select) with an action bar to apply actions to several files at once.
• Add eD2k links (ed2k://…).
• Remove completed; completed files stay visible until you remove them.
• Real file names are shown (not the internal .part paths).

Search

• Local and Global (server) modes — default: Global. (Kademlia search is not offered; on macOS the Kad network can still be started/stopped from the Servers section.)
• Filters: file type, extension, min/max size (KB/MB/GB on the Mac), minimum availability (Mac).
• Tabbed search: every search opens a tab; go back to previous searches and download files whenever you like.
• Automatic timeout of 120 seconds: a search that runs too long stops by itself (results already received are kept).
• Double-click / tap a result to start downloading it.
• Highlighted results: a file already in your transfers appears in red, one you already downloaded in green.

Servers

• Server list with users, files, ping and error count.
• Connect to a specific server (double-click / tap), automatic connection, disconnect.
• Add / remove servers, update the list from a URL (server.met).
• eD2k and Kademlia network controls (start/stop) (macOS).
• On iOS the Servers section is essential: connect / disconnect, add / remove, and a "…" menu with "Update server list" and "Reload from server".

Shared files (macOS only)

• List of shared files with requests, uploads and priority.
• Reload shared folders, copy eD2k link.

Statistics and log

• Speeds, limits, users/files per network, Kad nodes, session totals — with the same sections and icons on every platform.
• Server log in real time.

aMule preferences (remote, macOS)

Read and written directly on amuled. The structure mirrors amule.conf:

• General: nickname, folders (incoming, temp, shared), categories.
• Connection: bandwidth limits, TCP/UDP ports, connection limits, enabled networks, auto-reconnect.
• Servers: list management, safe connect, score system, etc.
• Files: ICH, AICH, allocation, free space, new downloads paused…
• Security: ipfilter, protocol obfuscation, SecIdent, who can see shared files.
• Filters: message filter, online signature.
• Tweaks: core tweaks (buffers, upload queue, keepalive) and the Kademlia nodes.dat URL.
• Remote control: web server (amuleweb).

On iOS / iPadOS / visionOS the "More" tab is dedicated to diagnostics and app settings (Statistics, Log, Connection test, Profiles, App settings, Notifications, About) rather than editing amule.conf.

iOS / iPadOS / visionOS specifics

• Tab interface (Transfers, Search, Servers, More).
• Sorting for every list (including "Just added"); the sort control sits in the same place (top left) in Search and Transfers.
• Connection test (in "More"): checks that the server's EC port (4712) answers and, optionally, that a web server answers at a domain you provide (HTTPS/HTTP).
• About (in "More"): version and build number in use, license, links and Show the introduction again.
• Notifications › (in "More", since 1.4): shows the permission state and opens the app's page in the system Settings; nothing else to configure in the app.
• Offline after inactivity (default 120 s): the connection is closed to save battery and data, the cached data stays visible and the connection resumes at the first tap or when the app comes back to the foreground (see What's new in 1.3).
• Server and password saved in the Keychain.
• Server stopped: if amuled stops, the app disconnects by itself and shows a "Server stopped" banner instead of a technical network error (on macOS too).

macOS specifics

• Sortable column tables in the aMuleGUI style, with the same toolbar buttons and action bar as iOS.
• Dedicated Shared files section and the full remote preferences editor.
• Settings window (⌘,) with the same rows and icons as the iOS "App settings" section (appearance, language, App color, idle period, iCloud sync, Notifications ›, Touch ID lock), plus a Profiles tab and About.
• Transfers menu and Dock menu with the quick actions (add link, add links from the Clipboard, pause all, resume all, remove completed); Help menu with wiki, bug report and privacy links; About aMule Remote panel with the license.