Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,10 @@ Rename this heading to the version number when you release it.
level: recommended
ko: GitHub에서 업데이트 파일을 받지 못하면 Filee 다운로드 서버(dl.filee.sh)에서 받아요
en: Updates come from Filee's download server (dl.filee.sh) when GitHub doesn't answer
en: In-app updates now install in-place directly on macOS app bundles and Windows Portable without opening download pages
-->

- **In-app updates now install in-place directly on macOS and Windows Portable**: Previously, portable Windows copies and macOS app bundles directed users to manual browser download pages. Filee now downloads and installs in-place automatically: Windows Portable safely extracts the verified portable zip and swaps files via a detached background PowerShell helper (preserving user `data` and portable settings), while macOS unpacks the verified app bundle and swaps it via a detached helper with quarantine removal and automatic rollback on failure.
- **Updating from Settings → About works when GitHub's downloads don't answer** (#1593). The in-app update on Windows
gave up when GitHub's download link didn't answer within 20 seconds, which some networks hit every time. Filee now
takes the same file from its own download server (`dl.filee.sh`) instead, and the rest of that update goes there
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ winget install KnifeLemon.Filee

Portable releases keep their data beside the app; see [portable mode](docs/PORTABLE.md).

Filee shows new releases in its menu and updates itself, keeping your settings and engines.
Filee shows new releases in its menu and updates itself in-place across Windows (both Setup and Portable), macOS app bundles, and Linux, keeping your settings and engines without redirecting to manual download pages.
After an update, a few slides show what's new.

**Windows: Filee doesn't start (no window, no error)?**
Expand Down
21 changes: 16 additions & 5 deletions docs/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -820,11 +820,15 @@ have no semibold) instead of the app's embedded Noto fonts.
Inno Setup's: 0 done, 1 could not start, 2 cancelled before installing (also a declined UAC prompt), 4 failed.
- **In-app updates** (`UpdateService`): an installed copy downloads `Filee-<v>-SHA256SUMS.txt`, its `.sig` and
`Filee-<v>-win[-arm64]-Setup.exe` from the GitHub release, checks the signature with the update key, the Setup's
SHA-256 and its Authenticode publisher, and runs it with `/SILENT /NORESTART`. A file GitHub doesn't hand out (an
HTTP error, a timeout, a cut connection) is taken from the download mirror, `https://dl.filee.sh/<v>/<file name>`
(`UpdateService.MirrorRoot`, filled by `build/sign-release.ps1`); after one GitHub failure, the update's other files
try the mirror first. The checks don't depend on the source. A file that arrived and was refused is not fetched
again from the other source. Linux and macOS files aren't on the mirror.
SHA-256 and its Authenticode publisher, and runs it with `/SILENT /NORESTART`. Portable Windows copies (`win-portable`,
`win-arm64-portable`) download `Filee-<v>-win[-arm64]-Portable.zip`, verify its SHA-256 (and `.sig`), safely extract the
archive verifying path traversal (Zip Slip defense), and delegate file replacement to a background helper script
(`powershell.exe -ExecutionPolicy Bypass -File update-portable.ps1`), preserving the user's `data` folder and `filee.portable`
marker before restarting Filee with `--background --whats-new`. A file GitHub doesn't hand out (an HTTP error, a timeout,
a cut connection) is taken from the download mirror, `https://dl.filee.sh/<v>/<file name>` (`UpdateService.MirrorRoot`,
filled by `build/sign-release.ps1`); after one GitHub failure, the update's other files try the mirror first. The checks
don't depend on the source. A file that arrived and was refused is not fetched again from the other source. Linux and macOS
files aren't on the mirror.
- **Testing**: `Filee.Setup.Tests` runs installs, updates (also over a simulated 1.x installation) and uninstalls
against `MemoryRegistry`, a fake `ISetupSystem` and scratch folders, and renders every page. `/SANDBOX=<folder>`
runs the real Setup with a registry file and all folders inside `<folder>`; `build-installer.ps1 -CheckOnly` (CI)
Expand Down Expand Up @@ -855,6 +859,13 @@ and standalone shell scripts (`install.sh`, `uninstall.sh`).
- **Uninstallation**: `uninstall.sh` removes the application directory, desktop launcher, and `~/.local/bin/filee` symlink
after verifying the `.filee-package` marker. User settings and converted files are kept.

## macOS app bundle and updates

On macOS, Filee is packaged as `Filee.app` and distributed as a self-contained archive (`Filee-<version>-<rid>.tar.gz` for `osx-arm64` and `osx-x64`) and disk image (`.dmg`).

- **In-app updates** (`UpdateService`): Running from a `Filee.app` bundle enables self-updating (`CanSelfUpdate`). Checks GitHub releases for matching `<rid>.tar.gz` and `<rid>-SHA256SUMS.txt` assets. Verifies archive SHA-256 and `.sig` before extraction. Archive extraction validates that all entries stay within the secure staging directory.
- **Atomic bundle replacement**: `UpdateAsync` stages the new `Filee.app` in a private temporary workspace, spawns a detached `/bin/sh` helper script, and requests application shutdown (`App.Quit`). Once Filee exits, the helper backs up the existing `.app` bundle, synchronizes the new bundle with `/usr/bin/ditto` (preserving bundle structure and code signatures), clears quarantine attributes via `/usr/bin/xattr -dr com.apple.quarantine`, refreshes the `~/.local/bin/filee` CLI link if present, and launches the updated application with `open -n` and `--background --whats-new` (falling back to direct executable launch). On failure, the helper automatically rolls back to the previous bundle, records diagnostics, and writes an update failure marker.

## Filee Connect

Filee Connect (`Filee.App.Services.Connect`) is an embedded local Wi-Fi server providing instant device-to-device file transfers and quick note exchanges between desktop and mobile devices. See [FILEE-CONNECT.md](FILEE-CONNECT.md) for full details.
Expand Down
Loading