Help Center

Everything you need to know about using Basil AI

🚀 Quick Start Guide

1. Grant Permissions

When you first launch Basil AI, you'll need to grant:

  • Microphone Access: Required for recording
  • Speech Recognition: Required for transcription
  • Location (Optional): To tag recordings with location on supported devices

2. Start Your First Recording

Tap the record button to begin. Basil AI uses a short 3-second countdown before recording starts so you have a moment to get ready.

  • What to expect: The countdown is normal and helps prevent clipped openings
  • Privacy: Recognition behavior depends on your language and privacy settings
  • After first use: Basil may ask for notification permission after your first recording, not during initial setup

3. Review and Organize

Open the recordings list to search, filter by folder, and open any session for transcript review, export, or sharing.

  • Search: Use search if a recording seems hard to find
  • Folders: Organize sessions by project, client, team, or topic
  • Sync: Pro subscribers can sync recordings across supported Apple devices with iCloud

4. Upload an Audio or Video File

From the recordings screen, use the import or upload option to choose a local audio file or common DRM-free video file from Files. For videos, Basil AI extracts the audio locally, discards the copied video, then generates a transcript, applies speaker separation where supported, and creates an AI summary on your device when available for your selected recognition mode and language.

  • Best for: Meetings, interviews, lectures, podcasts, saved voice memos, and video recordings with speech audio
  • Where to find it: Start from the recordings screen and choose a file stored locally in Files
  • Video support: DRM-free MP4, MOV, and M4V files are supported when your device can read them
  • For large imports: Keep Basil AI open until processing completes
  • After processing: Open the recording to review the transcript, speaker-separated sections, and summary

✨ Special Features

📂 Upload Audio or Video + On-Device Summaries

Already have a media file? Import audio or a DRM-free video into Basil AI and let the app process it locally.

  • Import existing audio or supported DRM-free video instead of recording from scratch
  • For video imports, Basil keeps only the extracted audio in your recording entry
  • Get speaker separation where supported, including clear "me versus others" style separation in current workflows
  • Review AI summaries for key takeaways, decisions, and follow-ups
  • Use local-first processing controls to keep sensitive conversations as private as possible

💡 Pro Tip: Cleaner audio leads to better speaker separation, so interview recordings and close-mic meeting audio usually perform best.

🌐 Recognition Language

Choose how Basil AI listens. You can use your device language automatically or manually select a recognition language in Settings.

  • Open Settings to change the recognition language
  • The device icon indicates languages that support on-device recognition
  • Some languages may require an internet connection depending on Apple's speech support
  • If transcript quality looks wrong, check the selected language first

🔒 Privacy Mode

Use On-Device Recognition Only in Settings when you want the strongest privacy posture.

  • Turn it on to prefer on-device recognition only
  • Turn it off if you want broader recognition support or better results in cases that may use Apple's servers
  • Availability depends on your selected language and the capabilities Apple exposes on that device

💡 Pro Tip: If privacy is your top priority, keep On-Device Recognition Only enabled and choose a language marked for on-device support.

🌿 The "Basil" Keyword

Say "Basil" during any recording to mark important moments!

  • Triggers immediate entity extraction
  • Creates a bookmark in your transcript
  • Provides haptic feedback (vibration)
  • Shows a green toast notification

💡 Pro Tip: Use "Basil" before stating action items, decisions, or important information to ensure they're captured.

📱 Quick Actions (3D Touch)

Long press the Basil AI app icon for quick actions:

  • Start Recording: Immediately begin a new recording
  • View Recordings: Jump to your recordings list

🗣️ Siri Shortcuts

Use Siri to control Basil AI hands-free:

Built-in Voice Commands:

  • "Hey Siri, start recording in Basil AI"
  • "Hey Siri, stop recording in Basil AI"
  • "Hey Siri, show my recordings in Basil AI"

Custom Shortcuts:

  1. Open Settings app → Shortcuts
  2. Tap the + button
  3. Search for "Basil AI"
  4. Choose an action (Start Recording, Stop Recording, etc.)
  5. Record your custom phrase like "Start my meeting"

💡 Pro Tip: Basil AI shortcuts work with Focus modes - set up automatic recording when entering Work focus!

📂 Search, Folders, and Notes Export

Keep recordings easy to find and easy to share.

  • Create folders to organize recordings by project, client, or team
  • Use search and folder filters in the recordings view to quickly locate past sessions
  • Export transcripts as Markdown to Files and Apple Notes workflows
  • Open Settings for full data controls, including exporting or deleting your stored data

🖥️ Works Across Apple Devices

Basil AI supports iPhone, iPad, and Mac. One purchase can work across supported Apple devices using the same Apple account.

  • Use iPhone for capture on the go
  • Use iPad or Mac for review, export, and longer work sessions
  • Some features, such as location tagging, can vary by platform

❓ Frequently Asked Questions

How long can I record?

Free users: 60 minutes per month
Pro users: Up to 8 hours continuous recording

Where is my data stored?

All recordings and transcripts are stored locally on your device and in your personal iCloud account. Nothing is sent to our servers.

How does the transcription work?

Basil AI is designed around local-first transcription using Apple's speech recognition. Exact behavior depends on your selected language and whether On-Device Recognition Only is enabled in Settings. In some configurations, Apple may require network-backed recognition.

Can I upload audio or video files?

Yes. Basil AI can import local audio files and common DRM-free video files from Files and process them into a transcript, speaker-separated sections where supported, and an AI summary. For larger imports, keep the app open until processing completes.

What happens when I upload a video?

Basil AI checks the file locally, rejects protected or DRM-restricted videos, verifies that the video has an audio track, extracts the audio into an .m4a file, and then discards the copied video. Your recording entry uses the extracted audio for playback, transcription, speaker separation, summaries, and entities.

Which video files are supported?

Basil is designed for common DRM-free video files that AVFoundation can read, especially MP4, MOV, and M4V. Unsupported containers, protected files, and videos without audio fail with a clear message instead of creating an empty transcript.

What does diarization mean?

Diarization means Basil AI separates a conversation by speaker so it is easier to tell who said what. In current workflows, speaker separation is best understood as supported separation where available rather than guaranteed named identification for every speaker in every recording.

Do uploaded files stay private?

Basil AI is built to keep processing local when your settings and selected language support it. For video uploads, audio extraction happens locally and the copied video is discarded after extraction. If you enable On-Device Recognition Only, Basil will prefer privacy-first recognition paths. Some languages or recognition modes may require internet access through Apple's speech services.

When should I upload a file instead of recording live?

Use upload when you already have an audio or DRM-free video file from another source, such as a saved meeting, imported interview, lecture capture, screen recording, webinar clip, or voice memo that you want summarized and transcribed inside Basil AI.

What languages are supported?

Basil AI supports a wide range of recognition languages, and you can change the transcription language in Settings. Some languages support on-device recognition, while others may require an internet connection depending on Apple's speech support for that language.

How do I change the transcription language?

Open Settings and choose the recognition language you want to use. You can follow the device language automatically or manually pick a language. If you see a device icon next to a language, that language supports on-device recognition on your device.

What does "On-Device Recognition Only" do?

This privacy setting tells Basil AI to use on-device recognition only when possible. It is the best choice when privacy matters most, but it can reduce language coverage or recognition flexibility in cases where Apple requires network-backed speech recognition.

Why does recording start after a countdown?

Basil AI uses a short 3-second countdown before recording begins. This is expected behavior and gives you a moment to position the device, pause background chatter, or get ready before the session starts.

When will Basil ask for notification permission?

Notification permission is requested after your first recording flow, not during the very first app launch. If you did not see that prompt immediately, that is normal.

Can I edit transcripts?

Transcripts are read-only within the app to maintain accuracy. You can export to Markdown and edit in any text editor.

How do I export recordings?

Tap any recording, then use the share or export action to save as Markdown. You can send exports to Files and Apple Notes workflows. In Settings, you'll also find options to export all your data or delete all stored data.

What's the difference between Free and Pro?

Free users get:

  • 60 minutes of recording or upload transcription per month
  • Full transcription quality
  • Export to Notes and Files

Pro users get:

  • Longer recording capacity, including up to 8-hour continuous recording sessions
  • Cross-device sync
  • No watermarks on exports
  • Additional paid plan options may be available in-app, including recurring and lifetime offers

Can I use Basil AI offline?

You can often use Basil AI without an internet connection, especially when On-Device Recognition Only is enabled and your selected language supports on-device speech recognition. Some languages or recognition modes may need internet access, so airplane mode support depends on that combination.

How do I organize recordings?

Create custom folders to organize recordings by project, client, or any category you prefer. Use folder filters and search from the recordings list if a session seems missing or you need to narrow a large library quickly.

Can I use Siri to start recording?

Yes! Say "Hey Siri, start recording in Basil AI" to begin recording hands-free. You can also create custom phrases in the Shortcuts app for personalized commands.

How does cross-device sync work?

Pro subscribers get automatic sync across all their devices. Your usage limits and recordings sync via iCloud, and one subscription works on iPhone, iPad, and Mac.

Can I use Basil AI on Mac and iPad?

Yes. Basil AI supports iPhone, iPad, and Mac. Your experience is designed to carry across devices with the same Apple account, though a few features can vary by platform.

How do I export or delete all my data?

Open Settings and look for the Your Data section. From there, you can export your full data archive or delete all stored data from Basil AI.

🔧 Troubleshooting

Recording won't start

  • Check microphone permissions in Settings → Basil AI
  • Ensure you have enough storage space
  • Force quit and restart the app
  • Free users: Check if you've reached the 60-minute monthly limit

Recording seems delayed before it starts

  • Basil AI uses a normal 3-second countdown before recording begins
  • Wait for the countdown to finish before speaking
  • If you need the beginning of a meeting, start a few seconds early

Poor transcription quality

  • Speak clearly and at a moderate pace
  • Reduce background noise
  • Keep device closer to speakers
  • Check the selected recognition language in Settings

Offline mode seems limited

  • Enable On-Device Recognition Only in Settings for the strongest privacy-first behavior
  • Choose a language that supports on-device recognition on your device
  • Some languages may require internet access through Apple's speech services

Uploaded file won't process

  • Make sure the audio or video file finished downloading locally in Files before importing
  • For videos, use a DRM-free MP4, MOV, or M4V with at least one audio track
  • Protected videos, audio-less videos, inaccessible files, and unsupported media types will show a clear import error
  • Try a clearer recording with less overlap between speakers
  • Check that your device has enough free storage for transcript and summary generation
  • Leave Basil AI open until processing completes for large files

Why didn't I see notification permission on first launch?

  • Basil AI requests notification permission later in the first-use flow
  • Complete your first recording before expecting that prompt
  • If you dismissed it, you can manage notifications in Apple's Settings app

Export issues

  • Ensure you have granted permission to save to Files
  • Check available storage space
  • Try exporting to a different location
  • Free users: Exports include a watermark

App crashes or freezes

  • Update to the latest version from App Store
  • Restart your device
  • Check available storage (need at least 1GB free)
  • Contact support if issue persists

Sync issues between devices

  • Ensure iCloud Drive is enabled on all devices
  • Check iCloud storage isn't full
  • Sign in with the same Apple ID on all devices
  • Pull down to refresh recordings list

💡 Pro Tips

🎯 Better Entity Detection

Start sentences with action words: "Todo:", "Decide:", "Schedule:", "Follow up:"

🔋 Battery Optimization

Enable "Low Power Recording" in settings for longer sessions with minimal battery drain.

📝 Quick Notes

Say "Note to self" followed by your thought to create a clearly marked personal note.

🎤 Better Audio

Use AirPods or external mics for clearer audio in noisy environments.

📊 Meeting Templates

Start meetings with "Attendees are..." to automatically populate the attendees list.

⚡ Quick Export

Swipe right on any recording for quick share options without opening details.

📂 Faster Upload Reviews

Name your imported audio or video file clearly before uploading so it is easier to spot in the recordings list once processing finishes.

🌐 Match the Right Language

If a transcript looks off, switch the recognition language in Settings before retrying the recording or import.

🔒 Max Privacy Setup

Enable On-Device Recognition Only and choose an on-device-supported language when privacy matters more than broader speech coverage.

Still Need Help?

Our support team is here to assist you