macOS-Files is a macOS port of Files, built on the recent Linux port. The goal is to merge this macOS port into the upstream Files (Windows) repository.
Files is created and maintained by the Files Community and its contributors. The Linux port (Uno Platform, Skia, X11) is the work of the LinuxFiles contributors; the macOS platform layer (AppKit and the macOS platform services) is the work of LeXtudio Inc..
Warning
Status: alpha. Expect missing features and rough edges, and do not rely on it for data you cannot afford to lose. The official, supported Files for Windows is at files.community.
macOS-Files is currently not affiliated with the Files (Windows) project or the Linux port. Code changes here follow the original Files MIT/MPL license, and the upstream copyright and contributor notices are preserved.
This port runs Files natively on macOS through Uno Platform (Skia, AppKit). The shell, Settings, file operations, Trash (macOS ~/.Trash), archives, clipboard and drag and drop, mounted volumes (including eject and Time Machine status), iCloud Drive, Finder tags, network locations (Bonjour) and connected iOS devices are in place.
Requires the .NET SDK; the app targets net10.0-desktop.
dotnet build src/Files.App/Files.App.csproj -c Debug
dotnet src/Files.App/bin/Debug/net10.0-desktop/Files.dllTo package a runnable Files.app bundle (ad-hoc signed by default):
scripts/macos/pack-app.sh -o /Applications # or: -o dist, add --dmg for a disk imageFor local development with an embedded automation/introspection agent, see scripts/macos/devflow.sh.
- macOS bugs and feature requests: open an issue in this repository.
- Security issues: use this repository's private Security Advisories. See SECURITY.md.
Contributions to this macOS port are welcome. See CONTRIBUTING.md.
- Files Community and all upstream contributors: the Files app, its design, code and translations (via Crowdin) that this port is built on. Files is MIT/MPL licensed, Copyright (c) 2018 - present Files Community.
- LinuxFiles and its contributors: the Linux port (Uno Platform, Skia, X11) and the shared POSIX layer this macOS port is based on.
- LeXtudio Inc.: the macOS platform layer and the macOS port.
- Uno Platform: WinUI on Skia/AppKit for macOS, which makes this port possible.
- SkiaSharp, Selawik (UI font) and Uno.Fonts.Fluent (icons).
- TagLibSharp, Markdig, ColorCode, LibGit2Sharp, SharpCompress, 7-Zip and the .NET Community Toolkit.
The full list of third-party components and licenses is in NOTICE.md and .github/NOTICE.md. "Files" and its logo are the Files Community's; they are used here to identify the upstream project and its ports, with no endorsement implied.
MIT and MPL, following the original Files licensing. Copyright (c) 2018 - present Files Community; Copyright (c) 2026 LeXtudio Inc. (macOS port).