Arslan on your iPhone,
working on your Mac.
Set it up in a few minutes, fix the usual snags, or write to the developer directly.
support@aralem.dev · questions, problems, ideas
Report a bug on GitHubPublic issues for Arslan for Mac and the iPhone link
01What you need
02Pair in three steps
- On your Mac, open Arslan › Settings › Connections › iPhone
Turn on Use Arslan from your iPhone, then click Add iPhone. A code appears; it works once, for 10 minutes.
- On your iPhone, open Arslan and scan the code
The app asks for the camera only to read this code.
- Back on the Mac, click Allow
The phone shows each step. On the Mac it reads Connecting… until the first message arrives, then Connected.
Just looking? On the iPhone's first screen, tap Try the demo. It never connects to a real Mac.
03Common questions
The app says my Mac is offline
Check that the Mac is awake, Arslan is running, Use Arslan from your iPhone is on, both devices use the same Apple ID, and both are online. What you send while the Mac is offline waits and goes when it is back.
Pairing is stuck, or the code stopped working
The code lasts 10 minutes and works once. If it has expired, click Add iPhone again on the Mac and scan the new one. Keep both apps open for the first few seconds after you click Allow.
Pairing the same iPhone again replaces its old entry on the Mac instead of adding a second one.Mac 0.1.54+
How do approvals work?
When the agent on your Mac wants to do something that needs your OK, it asks first, on the Mac and on your phone. Approve with Face ID or Touch ID, or decline; the first answer counts. A card nobody answers stays open for 30 minutes, and running out is not a no: Arslan tells you what is waiting.Mac 0.1.61+ Earlier versions close it after five minutes. Voice can ask for things, but it can never approve.
It says to update Arslan on the Mac before I can approve with Touch ID
Touch ID approvals (for example on iPhone SE) need Arslan for Mac 0.1.54 or later. Open Arslan on the Mac and install the update it offers, or download the latest version from aralem.dev/arslan. Face ID approvals work with earlier versions too.
Voice input
Hold to talk, let go to check the text, then send. Each recording can be up to 60 seconds. Recognition runs on your iPhone in the app's language (English or Chinese); recordings are never saved or uploaded. The first time, iOS may need to download its speech resources, which can be large, so Wi-Fi is best.
Can I send photos or files from my iPhone?
Not in this version: files go from your Mac to your phone, where you can open them. Sending photos and files from the iPhone to the Mac is planned for a later version.
Notifications
Arslan tells you when the Mac needs an approval or has finished a task. Previews are decrypted on your iPhone. To keep message text off the lock screen, turn off Show content in notifications in the app's settings.
Which AI model does it use?
The one you set up in Arslan for Mac, with your own API key. The iPhone app never talks to an AI service; before your first message it asks you to agree to your Mac sending your requests to that service. You can withdraw that in the app's Settings › Privacy.
How do I unpair?
On the iPhone: Settings › Unpair clears the iPhone. On the Mac: Settings › Connections › iPhone › Remove removes the phone and deletes the messages waiting for it in your iCloud. Do both to remove a phone completely.
04Reporting a problem
Tell us the versions (iPhone app version, Arslan for Mac version from its About window, iOS and macOS), what you did, and what you expected. A screenshot helps. Please never send API keys, pairing codes or pairing links.