# aniCe > aniCe (also written anice) is a free, open-source native Android and Mac app for file transfer, clipboard sharing, SMS, notifications and device controls over direct Bluetooth or local-network connections. Website: https://anisharyal09.github.io/web-anice/ Native application repository: https://github.com/anisharyal09/aniCe Technical source: the native repository's committed main documents, reviewed at b395ed3. ## Availability and platforms - Public beta v0.9.0-beta.3 is available. A development version in source is not a published release; check GitHub Releases for later releases. - [Download Android APK](https://github.com/anisharyal09/aniCe/releases/download/v0.9.0-beta.3/aniCe-android.apk) - [Download Mac ZIP](https://github.com/anisharyal09/aniCe/releases/download/v0.9.0-beta.3/aniCe-mac.zip) - Android 10 / API 29 or later; companion-owned background BLE requires API 31 / Android 12 or later. - Apple silicon Mac with macOS 14 or later. Intel Mac, Windows and iPhone apps are unsupported. - Current Mac builds are unsandboxed, use development Keychain storage, are self-signed and are not Apple-notarized. Secure Enclave isolation and an independent security audit are not claimed. ## Product behavior - Pair with a QR invitation or six-digit OPAQUE PIN exchange and approve on both devices. Native P-256 identities and pinned local trust authorize later connections, not names or discovery locators. - File transfer supports one sequential batch of 1–128 regular local files. File pickers, Android Share, Finder drops, menu-bar sending and Edge Drop are entry points into the same feature. Edge Drop is on by default at the right edge and can be moved or disabled. - Receiving is configured per trusted sender. New pairings enable automatic receiving; existing peers retain their saved choice, and a peer without a saved choice remains off. Otherwise the receiver reviews and approves each batch. - Files are SHA-256 verified and published without overwriting existing files. Verified prefixes and prepared jobs can recover for fifteen minutes, including across app restarts. LAN reconnects to the same trusted peer resume after verification; Bluetooth continuation after LAN loss requires an explicit action. Folders, symbolic links and unavailable cloud-only files are unsupported. - Clipboard v1 supports plain text and links up to 64 KiB. Automatic sharing is off by default and must be enabled on both peers; Android clipboard reading requires actual input focus. Text-selection and Share actions deliver supplied text without reading the clipboard. Open in Mac opens an HTTP(S) link without replacing the Mac clipboard. - Optional clipboard history stays on its device, with 20/50/100-item capacity. Resetting identity or forgetting trust does not erase saved history. Quick Paste Tray (Option-Command-V) copies local saved text for ordinary paste and does not inject text into another app. - Android is the source of SMS; Mac conversation data is memory-only and clears when the last peer link retires. Active SIM choice is supported. RCS and MMS sending are unsupported. - Selected Android notifications and supported actions/replies are mirrored on Mac. Source icons use LAN; there is no notification history/offline queue. Incoming-call controls and caller identity require separate permissions, and call audio remains on the phone. - Now Playing controls supported Mac playback over an existing authenticated channel. Artwork uses LAN; audio stays on Mac. Player and output volume capabilities are negotiated independently. - Mac Desk Deck uses foreground, lease-bound telemetry and controls for CPU, memory, OS thermal pressure, power, approved apps and supported audio outputs. Screenshot opens Mac controls, not an image transfer. Display brightness and temperature are not advertised. - Phone-to-Mac input uses authenticated BLE and requires Mac Event Posting permission. Mac-to-Android input uses separate system Classic Bluetooth HID, OS pairing and an explicit aniCe device link; Floating Key is Option-Command-K. Neither direction is screen mirroring. - Do Not Disturb sync sends Android changes to configured Mac On/Off Shortcuts, not the reverse direction; disconnected changes are not replayed. - Find Device alerts an already-connected peer. It does not track location or establish a connection. ## Native technical architecture - Android: Kotlin, Jetpack Compose and native APIs. Mac: Swift 6, SwiftUI and AppKit. A small shared Rust bridge supplies OPAQUE PIN pairing; feature and transport owners remain native. - Device identity: protected native P-256 keys, 65-byte uncompressed public points, SHA-256 fingerprints and strict DER at the identity-signing boundary. Current Mac storage does not claim Secure Enclave isolation. - QR bootstrap: ephemeral P-256 ECDH, a 256-bit PSK and fingerprint commitment. PIN bootstrap: opaque-ke 4.0.1, Ristretto255/TripleDH, SHA-512 and Argon2id. Signed local receipts do not create a distributed atomic trust transaction. - Trusted sessions: RFC 9528 EDHOC method 0/suite 5 with mandatory message 4. EDHOC uses ChaCha20-Poly1305; application records use separate exporter-derived directional AES-256-GCM keys. - Records: strict 64-bit ordered counters, 12-byte nonces, 16-byte GCM tags, encrypted ready/readyAck, 4,000-byte standard/BLE plaintext and 524,416-byte LAN profile-4 plaintext. Limits are one hour and 2^20 records per direction. Reserved nonces are never rolled back/resealed. - BLE: unauthenticated 20-byte compatibility discovery, stable GATT characteristics, session fragmentation v2, 4,096-byte logical messages and eight-message/32-KiB queues. Mac is peripheral; Android is central. No BLE bonding is requested by aniCe. - LAN: anonymous _anice._tcp Bonjour/NSD discovery, current TXT revision 3/frame profile 4 and five-byte TCP frame headers. Manual LAN works without BLE after pairing; automatic LAN uses authenticated BLE event/demand rendezvous. Each transport authenticates afresh with independent keys and counters. - Native transfer maxima: BLE 3,072-byte chunks/four-chunk credit; LAN capability 4 up to 524,288-byte (512-KiB) chunks/eight-chunk (4-MiB) credit. Qualification probing can reduce delayed paths to two 65,536-byte chunks/128 KiB. These are negotiated bounds, not promised throughput. - DATA owners: FeatureDispatch carries authenticated channel/generation/capacity events. Transfer chunks enter a bounded feature FIFO; storage and decoding do not block shared dispatch. Native identity and active trust validation remain live on authenticated operations. - Lifecycle: event-driven monotonic deadlines, no one-second idle polling, encrypted HELLO/ACK and PING/PONG. Automatic BLE renews at 55 minutes or 2^20-1024 records. Manual LAN needs another Connect after expiry; coordinated LAN renewal remains unimplemented. - Android LAN timeout defaults to Never, but explicit disconnect, session bounds, network/process loss and leases still govern access. Force-stop/reboot have no automatic-recovery promise; automatic Mac login launch is not implemented. - Updates: separate GitHub HTTPS discovery/downloads, stable default and beta opt-in confirmation. Android verifies package/version/signing lineage before system installation. Mac verifies archive paths, bundle/arm64 identity and pinned signing certificates; a signed helper retains the old bundle until startup confirmation. - Performance: at least 8 MiB/s LAN each way and at most 100-ms control round trip with 25-ms added latency are physical acceptance gates; connected-idle CPU at most 0.5% of one core is an objective. Matched Debug/USB idle BLE sampling reported median Android CPU 3.166% to 0.322% and Mac 0.385% to 0.030%. These are relative workload observations, not product speeds or battery promises; active playback and concurrent transfers are separate workloads. - Host fixtures and native interchange are not physical-device acceptance or an independent cryptographic audit. Minimum-OS acceptance, Release/battery work and broader lifecycle combinations remain separate gates. ## Website references - [Native architecture and sidebar summary](https://anisharyal09.github.io/web-anice/architecture/) - [Pairing and cryptographic bootstrap](https://anisharyal09.github.io/web-anice/architecture/#pairing) - [EDHOC and record security](https://anisharyal09.github.io/web-anice/architecture/#sessions) - [BLE/LAN and lifecycle](https://anisharyal09.github.io/web-anice/architecture/#transports) - [File transfer bounds and recovery](https://anisharyal09.github.io/web-anice/architecture/#transfers) - [Feature protocols and permissions](https://anisharyal09.github.io/web-anice/architecture/#features) - [Storage and privacy](https://anisharyal09.github.io/web-anice/architecture/#storage) - [Release and update verification](https://anisharyal09.github.io/web-anice/architecture/#updates) - [Performance targets and measurement limits](https://anisharyal09.github.io/web-anice/architecture/#performance) - [File transfer setup](https://anisharyal09.github.io/web-anice/guides/android-to-mac-file-transfer.html) - [Clipboard sharing setup](https://anisharyal09.github.io/web-anice/guides/android-mac-clipboard-sharing.html) - [SMS, playback and device guides](https://anisharyal09.github.io/web-anice/guides/android-mac-continuity.html) - [All setup guides](https://anisharyal09.github.io/web-anice/guides/) - [First installation and permissions](https://anisharyal09.github.io/web-anice/guides/first-installation-permissions.html) ## Native application sources - [Root architecture](https://github.com/anisharyal09/aniCe/blob/main/ARCHITECTURE.md) - [Native README](https://github.com/anisharyal09/aniCe/blob/main/README.md) - [Protocol/version index](https://github.com/anisharyal09/aniCe/blob/main/protocol/README.md) - [Background BLE](https://github.com/anisharyal09/aniCe/blob/main/docs/BACKGROUND_CONNECTIONS.md) - [LAN ownership](https://github.com/anisharyal09/aniCe/blob/main/docs/LAN_CONNECTIONS.md) - [Performance and validation](https://github.com/anisharyal09/aniCe/blob/main/docs/PERFORMANCE.md) - [Feature specifications](https://github.com/anisharyal09/aniCe/tree/main/docs/features) - [Installation and updates](https://github.com/anisharyal09/aniCe/blob/main/docs/GETTING_STARTED.md) - [Security policy](https://github.com/anisharyal09/aniCe/blob/main/SECURITY.md) - [Published releases](https://github.com/anisharyal09/aniCe/releases) ## Browser preview boundary The browser preview uses sample data. It does not connect devices, implement the native cryptographic protocol, or perform real transfers/device input. The small hero handoff never accesses real files or clipboard content. Explicit Copy actions in the full simulator may write sample text; file drops inspect local names/sizes. The website has no analytics/account sign-in; its appearance preference stays in the browser.