Setup walkthrough

First installation & permissions guide

aniCe’s device features work peer-to-peer over Bluetooth and your local network; downloads and update checks contact GitHub. The apps are distributed outside Google Play and the Mac App Store, so you may see security prompts on first install. Review them before deciding to proceed.

1. Allowing Unknown Apps on Android

When opening aniCe-android.apk from Chrome or your file manager, Android prompts: "For your security, your phone is not allowed to install unknown apps from this source."

  1. Tap Settings on the prompt.
  2. Turn ON the toggle for Allow from this source.
  3. Tap the back button and tap Install.

2. Google Play Protect Warning ("Blocked by Play Protect")

Because aniCe is an independent release not yet distributed via the Play Store, Google Play Protect may show a warning: "Blocked by Play Protect" or "Unrecognized app".

Important: Ensure you download aniCe-android.apk only from the official GitHub Releases page or officially distributed channels before proceeding.

  • Case A: "More details" is visible: Tap More details (or the downward arrow), then tap Install anyway.
  • Case B: If NO "Install anyway" button is shown (completely blocked): On newer Android versions or certain devices (Samsung One UI, Xiaomi HyperOS, Pixel), Play Protect may completely block installation with only an "OK" button. To install:
    1. Open the Google Play Store app.
    2. Tap your Profile avatar (top-right corner) → Play Protect.
    3. Tap the Settings gear icon (⚙️) in the top-right corner.
    4. Temporarily toggle OFF Scan apps with Play Protect.
    5. Return to your downloaded aniCe-android.apk and tap Install (it will now install without being blocked).
    6. Return to the Play Store and turn Scan apps with Play Protect back ON.

3. Unlocking Android 13+ "Restricted Settings"

On Android 13 or later, advanced access such as Notification Access, SMS or call permissions may show: "Restricted setting: For your security, this setting is currently unavailable." If you trust the release and want to use the feature, review the permission and follow these steps. Labels vary by phone.

  1. Open Android Settings → Apps → aniCe (or long-press the aniCe home screen icon → App info).
  2. Tap the three vertical dots (⋮) in the top-right corner.
  3. Tap "Allow restricted settings".
  4. Authenticate with your fingerprint, face unlock, or PIN.
  5. Return to aniCe and tap Enable—the permission screen will now allow the toggle immediately.

4. Background Battery Optimization (Keeping Connections Alive)

To keep background Bluetooth listeners active and reconnect automatically when you sit at your desk:

  1. Open App info → Battery (or Battery usage).
  2. Set it to Unrestricted.

5. macOS Gatekeeper Approval

Current Mac builds are self-signed and not Apple-notarized. Install only a release you trust:

  • Homebrew (Recommended): brew install anisharyal09/tap/anice automatically clears the quarantine attribute.
  • Manual ZIP: Extract aniCe-mac.zip, move aniCe.app to Applications, and try to open it once. If macOS cannot verify the app, dismiss the prompt, then open System Settings → Privacy & Security. Scroll to Security, choose Open Anyway, authenticate, and confirm.

Do not disable Gatekeeper globally. On macOS 14, Control-click → Open is also available.

6. macOS Login Keychain Prompt ("Always Allow")

On first launch, macOS prompts: "aniCe wants to access key in your keychain. Enter your password."

aniCe stores its unique P-256 ECDSA authentication key pair in your Login Keychain. If you trust the installed release, enter your Mac user password and choose "Always Allow". macOS remembers the app’s signed identity; a build with a different signature may ask again.

7. First Pairing Walkthrough

  1. Enable Bluetooth on both devices. Use the same local network if you want LAN features.
  2. On Mac, choose Add device → Show QR code (or six-digit code).
  3. On Android, choose Add device, then scan the QR code or enter the six-digit code shown on Mac.
  4. Verify the device names on both screens and tap Approve.

Get aniCe for your devices

Free, open source, and built natively with Swift and Kotlin.

Download aniCe