flutter_device_apps_macos
A Flutter plugin to list installed macOS apps, get app icons, check installation status, launch apps, and find file handlers. Also detects packaged app technologies.
Requirements
Requires macOS 12+, Flutter 3.44+, and Dart 3.12+. Swift Package Manager and CocoaPods are supported.
API reference · Guide: List installed macOS apps in Flutter
Main package
flutter_device_apps re-exports this plugin for macOS app discovery and
management. Main package · Main package README
Usage
Add the macOS package to your Flutter app.
flutter pub add flutter_device_apps_macos
import 'package:flutter_device_apps_macos/flutter_device_apps_macos.dart';
Call WidgetsFlutterBinding.ensureInitialized() if you use the API before
runApp(). The binding is already available in initState() and UI callbacks.
List installed macOS apps
final apps = await FlutterDeviceAppsMacos.listApps(
includeSystem: false,
onlyLaunchable: true,
includeIcons: false,
includeSpotlight: false,
bundleIdentifierPrefix: null, // e.g. 'com.apple.'
bundleIdentifierContains: null, // e.g. 'TextEdit'
);
Both bundle ID filters are case-sensitive and must match when provided.
Use null or '' to disable a filter. Set includeSpotlight: true to also
include accessible results from the Spotlight index.
Get apps by bundle ID or path
final app = await FlutterDeviceAppsMacos.getApp(
bundleIdentifier: 'com.apple.TextEdit',
includeIcon: true,
);
final apps = await FlutterDeviceAppsMacos.getApps(
['com.apple.TextEdit', '/Applications/Example Editor.app'],
includeIcons: true,
);
A bundle ID selects the preferred copy. An absolute path selects a specific copy.
getApp() returns null if the app is unavailable. getApps() returns results
in input order and deduplicates by resolved path. It returns [] when no apps
are found.
Detect packaged app technologies
final technologies = await FlutterDeviceAppsMacos.detectAppTechnologies(
bundleIdentifier: 'com.example.editor',
);
final engines = technologies?.gameEngines;
Matches come from bundle files and the main executable's Mach-O metadata.
They can appear in more than one category.
An unavailable app returns null. Empty lists indicate that the scan found
no supported markers for those categories.
| Category | Supported technologies |
|---|---|
frameworks |
Flutter, Electron, Qt, Chromium Embedded Framework, Cocoa, Mac Catalyst, WebKit, Core Data, SwiftData, SceneKit, RealityKit, SpriteKit |
programmingLanguages |
Dart, Swift |
uiToolkits |
Flutter, Qt Widgets, Qt Quick, AppKit, SwiftUI, UIKit, AVKit |
gameEngines |
Unity, Godot, SpriteKit |
runtimes |
Electron, Java Runtime, JavaScriptCore, Python, .NET, Mono |
libraries |
Qt Core, Qt Widgets, Qt Quick, Chromium Embedded Framework, AVKit, libVLC, SDL2, SDL3, Combine, Core ML, Metal, MetalKit, OpenGL, Core Graphics, QuartzCore, AVFoundation, Core Media, Core Audio, Audio Toolbox |
Godot matches the PCK header in the bundle resource named after its executable.
Dart matches a Flutter Kernel header or AOT snapshot symbols in App.framework.
Swift matches compiler metadata in the executable, and Mac Catalyst matches its
build platform. The scan reads direct dependency records across Apple Silicon
and Intel Mach-O slices. Code loaded through a helper or at runtime may be absent
from those records.
detectAppFrameworks() and MacosAppFramework remain available as deprecated APIs
with their original flat results.
List running apps
final runningApps = await FlutterDeviceAppsMacos.listRunningApps();
Returns a snapshot with one entry per running app instance.
Find apps that can open a file
const filePath = '/Users/me/Documents/Report.pdf';
final reader = await FlutterDeviceAppsMacos.getDefaultAppForFile(
filePath: filePath,
);
final handlers = await FlutterDeviceAppsMacos.listAppsForFile(filePath: filePath);
Use a handler's appPath with openFileWithApp to open the file in that app.
In the example, use Open with → Choose file → List compatible apps.
More APIs
All methods below belong to FlutterDeviceAppsMacos.
| Method | Purpose |
|---|---|
getAppIcon |
Get 64×64 PNG icon bytes. |
isAppInstalled |
Check whether the app is installed and accessible. |
isSystemApp |
Check system app status using the app's location. |
isAppLaunchable |
Check whether the app passes the launch preflight. |
getInstallSourceInfo |
Get App Store receipt and quarantine indicators. |
getDeclaredCapabilities |
Get usage descriptions and embedded entitlements. |
openApp |
Launch the app. |
revealAppInFinder |
Show and select the app in Finder. |
moveAppToTrash |
Move the app bundle to Trash using its resolved path. |
openFileWithApp |
Open a file using the selected app path. |
addAppSearchFolder |
Select and save an additional discovery folder. |
listAppSearchFolders |
List saved discovery folders. |
removeAppSearchFolder |
Remove a folder from future discovery scans. |
macOS setup
The generated Info.plist is sufficient for standard app discovery and
management. macOS applies App Sandbox and filesystem permissions to each
operation.
For a sandboxed app that lets users choose files or folders, set User Selected
File to Read Only under Signing & Capabilities. In a Flutter app, add
the key inside <dict> in macos/Runner/DebugProfile.entitlements and
macos/Runner/Release.entitlements. Apple App Sandbox
<key>com.apple.security.files.user-selected.read-only</key>
<true/>
Add the app-scoped bookmark entitlement if you use addAppSearchFolder to
keep access to search folders across launches. Apple bookmark entitlements
<key>com.apple.security.files.bookmarks.app-scope</key>
<true/>
The example includes both entitlements. For openFileWithApp, keep file access
active until the call completes. moveAppToTrash requires write access to the
bundle. Discovery and access details
Community Standards
Issues · Contributing · Code of Conduct · Security Policy
License
MIT © 2026 okmsbun
Libraries
- flutter_device_apps_macos
- Independent macOS app discovery and management APIs for Flutter.
- macos_app_declared_capabilities
- macos_app_info
- macos_app_install_source_info
- macos_app_search_folder
- macos_app_technologies
- macos_running_app_info