Skip to content

macos share menu #305

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sameerasw merged 5 commits into from
Oct 27, 2026
Merged

macos share menu #305

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d8a99c1
Add macOS Share menu handoff to Quick Share
hkay-dev Sep 23, 2026
1ac467c
Show item previews and auto-send from the Share sheet
sameerasw Oct 13, 2026
b49cb30
Clean up staged share files after transfer and harden the Share exten…
sameerasw Oct 13, 2026
3959036
fix: re-opening app on share extension
sameerasw Oct 27, 2026
fad2f44
Merge remote-tracking branch 'origin/develop' into codex/macos-share-…
sameerasw Oct 27, 2026
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
121 changes: 121 additions & 0 deletions AirSync.xcodeproj/project.pbxproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -602,6 +602,127 @@
};
name = "Self Compiled";
};
A1700000000000000000000C /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
APPLICATION_EXTENSION_API_ONLY = YES;
AUTOMATION_APPLE_EVENTS = NO;
CODE_SIGN_ENTITLEMENTS = AirSyncShareExtension.entitlements;
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 32;
DEVELOPMENT_TEAM = WCB4HTANA6;
ENABLE_APP_SANDBOX = YES;
ENABLE_HARDENED_RUNTIME = YES;
ENABLE_RESOURCE_ACCESS_AUDIO_INPUT = NO;
ENABLE_RESOURCE_ACCESS_CALENDARS = NO;
ENABLE_RESOURCE_ACCESS_CAMERA = NO;
ENABLE_RESOURCE_ACCESS_CONTACTS = NO;
ENABLE_RESOURCE_ACCESS_LOCATION = NO;
ENABLE_RESOURCE_ACCESS_PHOTO_LIBRARY = NO;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_FILE = AirSyncShareExtension/Info.plist;
INFOPLIST_KEY_CFBundleDisplayName = AirSync;
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
"@executable_path/../../../../Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 14.5;
MARKETING_VERSION = 4.1.0;
PRODUCT_BUNDLE_IDENTIFIER = "sameerasw.airsync-mac.share";
PRODUCT_NAME = "$(TARGET_NAME)";
RUNTIME_EXCEPTION_ALLOW_DYLD_ENVIRONMENT_VARIABLES = NO;
RUNTIME_EXCEPTION_ALLOW_JIT = NO;
RUNTIME_EXCEPTION_ALLOW_UNSIGNED_EXECUTABLE_MEMORY = NO;
RUNTIME_EXCEPTION_DEBUGGING_TOOL = NO;
RUNTIME_EXCEPTION_DISABLE_EXECUTABLE_PAGE_PROTECTION = NO;
RUNTIME_EXCEPTION_DISABLE_LIBRARY_VALIDATION = NO;
SKIP_INSTALL = YES;
SWIFT_OPTIMIZATION_LEVEL = "-Onone";
SWIFT_VERSION = 5.0;
};
name = Debug;
};
A1700000000000000000000D /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
APPLICATION_EXTENSION_API_ONLY = YES;
AUTOMATION_APPLE_EVENTS = NO;
CODE_SIGN_ENTITLEMENTS = AirSyncShareExtension.entitlements;
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 32;
DEVELOPMENT_TEAM = WCB4HTANA6;
ENABLE_APP_SANDBOX = YES;
ENABLE_HARDENED_RUNTIME = YES;
ENABLE_RESOURCE_ACCESS_AUDIO_INPUT = NO;
ENABLE_RESOURCE_ACCESS_CALENDARS = NO;
ENABLE_RESOURCE_ACCESS_CAMERA = NO;
ENABLE_RESOURCE_ACCESS_CONTACTS = NO;
ENABLE_RESOURCE_ACCESS_LOCATION = NO;
ENABLE_RESOURCE_ACCESS_PHOTO_LIBRARY = NO;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_FILE = AirSyncShareExtension/Info.plist;
INFOPLIST_KEY_CFBundleDisplayName = AirSync;
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
"@executable_path/../../../../Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 14.5;
MARKETING_VERSION = 4.1.0;
PRODUCT_BUNDLE_IDENTIFIER = "sameerasw.airsync-mac.share";
PRODUCT_NAME = "$(TARGET_NAME)";
RUNTIME_EXCEPTION_ALLOW_DYLD_ENVIRONMENT_VARIABLES = NO;
RUNTIME_EXCEPTION_ALLOW_JIT = NO;
RUNTIME_EXCEPTION_ALLOW_UNSIGNED_EXECUTABLE_MEMORY = NO;
RUNTIME_EXCEPTION_DEBUGGING_TOOL = NO;
RUNTIME_EXCEPTION_DISABLE_EXECUTABLE_PAGE_PROTECTION = NO;
RUNTIME_EXCEPTION_DISABLE_LIBRARY_VALIDATION = NO;
SKIP_INSTALL = YES;
SWIFT_VERSION = 5.0;
};
name = Release;
};
A1700000000000000000000E /* Self Compiled */ = {
isa = XCBuildConfiguration;
buildSettings = {
APPLICATION_EXTENSION_API_ONLY = YES;
AUTOMATION_APPLE_EVENTS = NO;
CODE_SIGN_ENTITLEMENTS = AirSyncShareExtension.entitlements;
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 32;
DEVELOPMENT_TEAM = WCB4HTANA6;
ENABLE_APP_SANDBOX = YES;
ENABLE_HARDENED_RUNTIME = YES;
ENABLE_RESOURCE_ACCESS_AUDIO_INPUT = NO;
ENABLE_RESOURCE_ACCESS_CALENDARS = NO;
ENABLE_RESOURCE_ACCESS_CAMERA = NO;
ENABLE_RESOURCE_ACCESS_CONTACTS = NO;
ENABLE_RESOURCE_ACCESS_LOCATION = NO;
ENABLE_RESOURCE_ACCESS_PHOTO_LIBRARY = NO;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_FILE = AirSyncShareExtension/Info.plist;
INFOPLIST_KEY_CFBundleDisplayName = AirSync;
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
"@executable_path/../../../../Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 14.5;
MARKETING_VERSION = 4.1.0;
PRODUCT_BUNDLE_IDENTIFIER = "sameerasw.airsync-mac.share";
PRODUCT_NAME = "$(TARGET_NAME)";
RUNTIME_EXCEPTION_ALLOW_DYLD_ENVIRONMENT_VARIABLES = NO;
RUNTIME_EXCEPTION_ALLOW_JIT = NO;
RUNTIME_EXCEPTION_ALLOW_UNSIGNED_EXECUTABLE_MEMORY = NO;
RUNTIME_EXCEPTION_DEBUGGING_TOOL = NO;
RUNTIME_EXCEPTION_DISABLE_EXECUTABLE_PAGE_PROTECTION = NO;
RUNTIME_EXCEPTION_DISABLE_LIBRARY_VALIDATION = NO;
SKIP_INSTALL = YES;
SWIFT_VERSION = 5.0;
};
name = "Self Compiled";
};
B9673B602E35A2A3006D284A /* Debug */ = {
isa = XCBuildConfiguration;
baseConfigurationReferenceAnchor = B9673B592E35A2A1006D284A /* airsync-mac */;
Expand Down
182 changes: 182 additions & 0 deletions AirSyncShareExtension/SharePreviewLoader.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,182 @@
import AppKit
import QuickLookThumbnailing
import UniformTypeIdentifiers

struct SharePreviewItem: Identifiable {
let id = UUID()
let name: String
let detail: String
let icon: NSImage
let thumbnail: NSImage?
let byteCount: Int64?
let isFolder: Bool
}

@MainActor
struct SharePreviewLoader {
static let thumbnailByteLimit: Int64 = 25 * 1024 * 1024
private let thumbnailSize = CGSize(width: 96, height: 96)

func load(_ items: [NSExtensionItem]) async -> [SharePreviewItem] {
var previews: [SharePreviewItem] = []
for item in items {
let attachments = item.attachments ?? []
if attachments.isEmpty {
if let text = item.attributedContentText?.string, !text.isEmpty {
previews.append(textPreview(text, name: "Shared Text"))
}
} else {
for provider in attachments {
if let preview = await preview(provider) {
previews.append(preview)
}
}
}
}
return previews
}

private func preview(_ provider: NSItemProvider) async -> SharePreviewItem? {
if provider.hasItemConformingToTypeIdentifier(UTType.url.identifier),
let url = try? await loadURL(provider) {
return url.isFileURL ? await filePreview(url) : linkPreview(url)
}

let identifiers = provider.registeredTypeIdentifiers
if let imageType = identifiers.first(where: { UTType($0)?.conforms(to: .image) == true }) {
return await imagePreview(provider, typeIdentifier: imageType)
}
if let fileType = identifiers.first(where: {
guard let type = UTType($0) else { return false }
return type.conforms(to: .data) && !type.conforms(to: .text) && !type.conforms(to: .url)
}) {
let type = UTType(fileType)
return SharePreviewItem(
name: provider.suggestedName ?? "Shared Item",
detail: type?.localizedDescription ?? "File",
icon: type.map { NSWorkspace.shared.icon(for: $0) } ?? NSImage(named: NSImage.multipleDocumentsName) ?? NSImage(),
thumbnail: nil,
byteCount: nil,
isFolder: false
)
}
if let textType = identifiers.first(where: { UTType($0)?.conforms(to: .text) == true }),
let data = try? await loadData(provider, typeIdentifier: textType),
let text = String(data: data, encoding: .utf8) {
return textPreview(text, name: provider.suggestedName ?? "Shared Text")
}
return nil
}

private func filePreview(_ url: URL) async -> SharePreviewItem {
let values = try? url.resourceValues(forKeys: [.isDirectoryKey, .fileSizeKey, .localizedTypeDescriptionKey])
let isFolder = values?.isDirectory == true || url.hasDirectoryPath
let size = values?.fileSize.map(Int64.init)
let kind = values?.localizedTypeDescription ?? "File"
let icon = NSWorkspace.shared.icon(forFile: url.path)

var thumbnail: NSImage?
if !isFolder, let size, size <= Self.thumbnailByteLimit {
thumbnail = await quickLookThumbnail(url)
}
return SharePreviewItem(
name: url.lastPathComponent,
detail: isFolder ? "Folder" : [kind, size.map(Self.format)].compactMap { $0 }.joined(separator: " · "),
icon: icon,
thumbnail: thumbnail,
byteCount: isFolder ? nil : size,
isFolder: isFolder
)
}

private func imagePreview(_ provider: NSItemProvider, typeIdentifier: String) async -> SharePreviewItem? {
guard let data = try? await loadData(provider, typeIdentifier: typeIdentifier) else { return nil }
let size = Int64(data.count)
let type = UTType(typeIdentifier)
return SharePreviewItem(
name: provider.suggestedName ?? "Shared Image",
detail: [type?.localizedDescription ?? "Image", Self.format(size)].joined(separator: " · "),
icon: type.map { NSWorkspace.shared.icon(for: $0) } ?? NSImage(),
thumbnail: size <= Self.thumbnailByteLimit ? downsampled(data) : nil,
byteCount: size,
isFolder: false
)
}

private func linkPreview(_ url: URL) -> SharePreviewItem {
SharePreviewItem(
name: url.host ?? url.absoluteString,
detail: url.absoluteString,
icon: NSImage(systemSymbolName: "link", accessibilityDescription: nil) ?? NSImage(),
thumbnail: nil,
byteCount: Int64(url.absoluteString.utf8.count),
isFolder: false
)
}

private func textPreview(_ text: String, name: String) -> SharePreviewItem {
let snippet = text.trimmingCharacters(in: .whitespacesAndNewlines)
.replacingOccurrences(of: "\n", with: " ")
return SharePreviewItem(
name: name,
detail: String(snippet.prefix(120)),
icon: NSImage(systemSymbolName: "text.alignleft", accessibilityDescription: nil) ?? NSImage(),
thumbnail: nil,
byteCount: Int64(text.utf8.count),
isFolder: false
)
}

private func quickLookThumbnail(_ url: URL) async -> NSImage? {
let request = QLThumbnailGenerator.Request(
fileAt: url,
size: thumbnailSize,
scale: NSScreen.main?.backingScaleFactor ?? 2,
representationTypes: .thumbnail
)
return try? await QLThumbnailGenerator.shared.generateBestRepresentation(for: request).nsImage
}

private func downsampled(_ data: Data) -> NSImage? {
guard let source = CGImageSourceCreateWithData(data as CFData, nil) else { return nil }
let options: [CFString: Any] = [
kCGImageSourceCreateThumbnailFromImageAlways: true,
kCGImageSourceCreateThumbnailWithTransform: true,
kCGImageSourceThumbnailMaxPixelSize: thumbnailSize.width * 2,
]
guard let image = CGImageSourceCreateThumbnailAtIndex(source, 0, options as CFDictionary) else { return nil }
return NSImage(cgImage: image, size: .zero)
}

private func loadURL(_ provider: NSItemProvider) async throws -> URL {
try await withCheckedThrowingContinuation { continuation in
_ = provider.loadObject(ofClass: NSURL.self) { url, error in
if let error {
continuation.resume(throwing: error)
} else if let url = url as? NSURL {
continuation.resume(returning: url as URL)
} else {
continuation.resume(throwing: CocoaError(.fileReadUnknown))
}
}
}
}

private func loadData(_ provider: NSItemProvider, typeIdentifier: String) async throws -> Data {
try await withCheckedThrowingContinuation { continuation in
_ = provider.loadDataRepresentation(forTypeIdentifier: typeIdentifier) { data, error in
if let error {
continuation.resume(throwing: error)
} else if let data {
continuation.resume(returning: data)
} else {
continuation.resume(throwing: CocoaError(.fileReadUnknown))
}
}
}
}

nonisolated static func format(_ bytes: Int64) -> String {
ByteCountFormatter.string(fromByteCount: bytes, countStyle: .file)
}
}
Loading
Loading