Quick start
Your first five minutes
01
Open People
The People screen is your home base. On iPhone, the bottom bar gives you Settings and New Person. On iPad and Mac, the same actions appear in the toolbar or sidebar layout.
02
Create a New Person
Start with Full name. Add Work and Notes if you already know them. You can leave almost everything blank and fill it in later.
03
Use Add
Open a profile and use Add for catch-ups, tasks, contact info, dates, facts, custom details, gifts, debts, relationships, and people in their orbit.
04
Review before saving
When Orbari reads text or a recording, it shows a Review screen. Tick what belongs, untick what does not, then choose Add to Orbari.
People
Use the People list
Add someone from the empty state
- Open People.
- If the list is empty, choose Add Person.
- Fill in the New Person form and choose Save.
- The new profile appears in your list.
Add someone when you already have people
- On iPhone, use the New Person button in the bottom action bar.
- On Mac, use New Person in the toolbar or File menu.
- On iPad, use the add action in the people interface.
- Use Save when the profile is ready.
Use the list tools
The People list can search, filter, and sort your orbit. It also has shortcuts for Add from Text or Recording, Interviews, Family & Pets, Tasks, Tree, and Constellation views when those tools are available on the current device.
New Person
Fill out the New Person form
Name
- Enter the person's Full name.
- If Orbari shows Family name suggestions, choose one to keep surnames consistent across relatives.
- Use Custom initials only if you want the avatar letters to differ from the automatic initials.
Work
- Add Job title if it helps you remember what they do.
- Add Company if that context matters.
- Leave both blank for personal contacts where work is irrelevant.
Notes
Use Notes for the broad things you want visible on the profile: how you know them, what they care about, or anything you want to remember before reaching out. The placeholder in the app is Anything you want to remember.
Save or cancel
Save creates the profile. Cancel closes the sheet without adding anything. The free version lets you keep up to five people before unlocking Orbari.
Profiles
Understand a person's profile
Header
Name, avatar, work line, notes, lifespan marker, and identity details appear at the top.
Names & pronunciation
Alternate names, names in other scripts, phonetic spelling, pronunciation audio, and terms of address.
Contact
Phone, email, social profile, website, and address entries. Tapping a row can call, email, open, or copy.
Important dates
Birthdays, anniversaries, first met dates, passed-away dates, and custom dates.
Follow-ups and tasks
Promises, due dates, and follow-ups from catch-ups live close to the person they belong to.
Relationships
Full contacts, relatives, friends, pets, and people tracked under someone else's orbit.
Edit the base profile
- Open the person's profile.
- Open Add.
- Choose Edit Person.
- Update Full name, Custom initials, Work, or Notes.
- Choose Save.
Add from text
Paste, record, extract, review
Start Add from Text or Recording
- Open People.
- Choose Add from Text or Recording.
- Paste a message thread, email, transcript, or rough notes into Text.
- On devices with recording available, use Record a catch-up instead, then Stop & transcribe.
- Choose Extract.
Review extracted people
- On the Review screen, each person gets a checkmark toggle.
- Use the match badge to keep a new person, link to an existing person, or make a matched person new.
- Untick people or facts that do not belong.
- If Orbari spots Possible duplicates, choose Merge or Keep separate.
Review relationships and catch-up
- In Relationships, tick only the links that are correct.
- In Catch-up, turn Log this catch-up on or off.
- Choose With to decide whose profile receives the catch-up.
- Choose Kind if the type of catch-up needs changing.
- Choose Add to Orbari when the review looks right.
Catch-ups
Log a conversation by hand
Open Log Catch-up
- Open a person's profile.
- Choose Log Catch-up. On iPhone, it may appear as the prominent bottom action on the profile.
- Set When did you catch up?
- Choose Kind.
- Write notes under What did you talk about? Bullet points are great.
- Choose Save.
Record this catch-up
If Recording is available, choose Record this catch-up. Orbari keeps the recording on your device so you can listen back later, and it will try to fill in your notes from what was said.
Add follow-ups
- Dates mentioned in your notes can appear under Suggested follow-ups.
- Choose a suggestion to add it.
- Use Add follow-up to add one yourself.
- Set Title, On, and Add to.
- Save the catch-up.
Relationships
Link people, family, and pets
Add Relationship
- Open a person's profile.
- Choose Add, then Add Relationship.
- Under Connect to, choose the other full contact.
- Under Relationship, choose Type.
- For family types, choose Kind when needed: Full / Biological, Half, Step, Adoptive, Foster, or Social.
- Read the sentence preview, then choose Save.
Add to Their Orbit
- Open a person's profile.
- Choose Add, then Add to Their Orbit.
- Enter the person's name or pet's name.
- Choose Type: person or pet.
- Choose Relation. For pets, you can also add Breed / details.
- Add Notes and choose Save.
When to use each
Use Add Relationship when both people deserve full profiles. Use Add to Their Orbit for children, partners, relatives, friends, or pets you want to remember around someone else without turning every mention into a full contact.
Dates and tasks
Remember what matters next
Add Important Date
- Open a profile and choose Add, then Add Important Date.
- Choose Occasion: Birthday, Anniversary, First met, Passed away, or Custom.
- If you choose Custom, enter a Label.
- Choose Date. Turn on Year unknown when you only know the day and month.
- For First met, add the story under How you met.
- Turn on Remind me every year when you want a repeating Apple Reminders reminder.
- Choose Save. If Orbari shows Just checking warnings, review them; saving again confirms the date.
Add Task
- Open a profile and choose Add, then Add Task.
- Enter the Task title, such as Return her ladder.
- Add optional Details.
- Turn on Set a due date when the task has a deadline.
- Choose Save.
Add Gift or Debt
Gift ideas can store Gift, Link, Price, and Status. Debts store Who owes whom, Amount, and Reason. When editing a debt, Settled keeps the debt on the profile but quietly crosses it out.
Sync and sharing
Move data only when you choose
Turn on iCloud + Markdown sync
- Open Settings.
- Open Sync.
- Unlock Orbari if Sync is marked Premium.
- Turn on iCloud + Markdown sync.
- Check Status and Last sync when you want to confirm it ran.
- Use Export now to write a fresh Markdown pass.
Choose a Markdown folder or Obsidian vault
- Open Settings, then Sync.
- Choose Folder.
- Pick a folder you control, such as an Obsidian vault.
- Use Default Folder later to return to Orbari's default iCloud Drive location.
- Turn on Subcontacts get their own files if you want tracked people and pets exported separately.
Share people
- Open a person's profile and choose Share, or open Settings, then Share, then Share people.
- Review the People and Connections count.
- Leave Include notes and facts off unless you deliberately want to share private details.
- Choose Share. On Mac, you can also Save to disk.
Import people
- Open Settings, then Share.
- Choose Import from a file or Import from vCard or CSV.
- Review the preview before anything changes.
- For existing people, tick only the details you want to bring in.
- Choose Import or Add people.
Settings
Where app-wide controls live
General
Appearance, background tint, accent colour, profile icons, staleness cues, full names in list, remembering options, app icon, and on-device AI status.
Privacy
Lock Orbari, biometric unlock, auto-lock, Change PIN, and Lock now.
People
Custom Fields lets you manage reusable details like Favourite food, Birthday, or any field you use often.
Sync
iCloud + Markdown sync, Markdown folder, Export now, LAN sync options, and Connect to a Mac where supported.
Share
Share people, Import from a file, and Import from vCard or CSV.
Plan
Free people count, Unlock Orbari, Restore Purchases, and premium status.
Check AI availability
Open Settings, then General, then On-device AI. Status can show Ready, Not supported on this device, Turn on Apple Intelligence, Preparing local model, or Requires a newer OS. Manual entry still works when AI is unavailable.
Change the look of Orbari
Open Settings, then General. Use Appearance for System, Light, or Dark; Background tint for the page wash; Accent colour for controls; and Profile icons to choose one or two initials and where those initials come from.
Restore a purchase
Open Settings, then Plan, then Restore Purchases. Your unlock is tied to your Apple Account through the App Store.
Mac shortcuts
Move quickly on Mac
Most Mac shortcuts match the menu bar. If a shortcut is contextual, open a person's profile first.
New Person
⌘N
File ▸ New Person
Add from Text
⌘I
File ▸ Add from Text
New Interview
⇧⌘I
File ▸ New Interview
New Task
⌘T
File ▸ New Task
Tasks
⇧⌘T
File ▸ Tasks
Log Catch-up
⌘L
Open a person first
List view
⌘1
View ▸ List
Tree view
⌘2
View ▸ Tree
Constellation view
⌘3
View ▸ Constellation
Back / Forward
⌘[ / ⌘]
Move through profile history
Settings
⌘,
Open Orbari settings
Lock now
⌃⌘L
Shown when app lock is enabled
Cancel
Esc
Close most sheets without saving
Troubleshooting
Common fixes
Sync is not updating
Check that sync is enabled, that the same Apple Account is signed in on each device, and that iCloud has had time to catch up. For folder sync, confirm the selected folder is still available.
AI capture is not available
Open Settings, then General, then On-device AI. If the status is not Ready, follow the message shown there. Manual entry, tasks, dates, relationships, and ordinary notes still work without AI capture.
Restore your purchase
Open Orbari settings and use Restore Purchase. Your unlock is tied to your Apple Account through the App Store.
Get help
Email support@orbari.app with your device, OS version, and a short description of what happened.