Requirements and troubleshooting
What Ramble runs on, and what to check when something doesn’t show up.
Requirements
- iPhone: iOS 18.6 or later.
- Apple Watch: watchOS 10.0 or later. That’s Apple Watch Series 4 and later, every Apple Watch SE, and every Apple Watch Ultra.
- A connection, now and then. Recording works anywhere. Transcription happens in the cloud, so notes send once the watch has Wi-Fi, cellular, or your iPhone nearby.
To see your versions, open Settings → General → About on the iPhone, and the Watch app on the iPhone → General → About for the watch.
Apple Watch
›The iPhone app installed, but the watch app didn’t
Check the watch’s watchOS version first. If it’s older than 10.0, the App Store installs the iPhone app and quietly skips the watch app. Update the watch in the Watch app on the iPhone → General → Software Update.
If the version is fine, open the Watch app on the iPhone, scroll down to Available Apps, and tap Install next to Ramble. To have this happen on its own next time, turn on Automatic App Install under Watch app → App Store.
›The watch shows “Set up”
The watch isn’t connected to Ramble yet. Open Ramble on your iPhone once, and tap Get started if it’s your first time. The watch connects on its own and waiting notes send. Until then they’re safe on the watch.
›The watch shows “No phone”
Ramble isn’t on your iPhone. Install it from the App Store and open it once. Waiting notes send on their own.
›The watch shows “Mic off”
Ramble needs the microphone on the watch. On the watch, open Settings → Privacy & Security → Microphone and turn on Ramble.
›A note says “Unlock to send”
Your 25 free notes are used. The note is saved on the device that recorded it. Unlock Ramble in Settings on your iPhone, and held notes send on their own, from the watch too. Bought it already? Tap Restore Purchases in Settings.
›Notes wait on the watch
The watch sends each note straight to Ramble over Wi-Fi, cellular, or your iPhone. Away from the iPhone, it sends while the app is open or soon after you stop. In Low Power Mode, watchOS turns off Wi-Fi and cellular away from the iPhone, so notes wait until the iPhone is back. Opening Ramble on the watch sends anything waiting.
Nothing is lost. The watch keeps each note until Ramble has it.
›A note says “Too long to transcribe” or “Couldn’t send”
Notes stop at 60 minutes, and Ramble can’t take a longer file. “Couldn’t send” means the file was damaged. Either way the audio stays on your devices.
Transcription
›A note stays on “Transcribing…”
Most notes take seconds, long ones a little longer. If the transcription services are busy or down, Ramble keeps trying on its own for up to 20 hours. You don’t need to do anything.
›A note says “Couldn’t transcribe”
Ramble couldn’t turn the audio into text, or couldn’t reach a transcription service in time. Open the note on your iPhone and tap Retry. You can retry once, and the retry never uses a free note. A note that couldn’t transcribe gives its free note back.
›A note says “No speech detected”
Ramble heard nothing to transcribe, like a recording in a pocket. Nothing is sent to your agent or webhook.
›Names or words come out wrong
In Settings → Transcription on the iPhone, set your Language, and add names and jargon to Vocabulary. New notes from the watch and the iPhone use them.
›“Ramble can’t finish setting up right now”
The iPhone couldn’t reach Ramble, or Ramble has paused new setups for the day. Keep recording: notes wait as “Waiting to send”, and setup finishes on its own when you open Ramble later.
Purchase
›I bought Ramble on another iPhone
Open Ramble with the same Apple ID and it unlocks on its own. If it doesn’t, tap Restore Purchases in Settings.
›“This purchase is in use on 10 iPhones”
One purchase works on up to 10 iPhones. Each fresh start after a reinstall counts as one. If you need more, email support@ramble.watch.
›I want a refund
Purchases go through Apple, so Apple handles refunds at reportaproblem.apple.com.
Your agent
›My agent isn’t getting my notes
Open Settings → Your agent on the iPhone. Each agent shows when it last checked in and how many notes are waiting for it.
- “Hasn’t checked in”:the agent isn’t checking. Tap Connect again and paste it the fresh message, or paste it the instructions for the agent. Notes wait for 30 days, so nothing is lost yet.
- “Waiting for your agent”:the note is ready and the agent hasn’t picked it up. Many agents check on a schedule, so this can take a while.
- “Not picked up”: the copy expired after 30 days, was deleted, or its agent was disconnected before reading it.
›A note says “Saved, no agent connected”
An agent receives only notes that reach Ramble’s server after it connected. Connect one in Settings → Your agent, and your next notes go to it. Older notes stay on your iPhone.
›The pairing code expired or didn’t work
A code works once and expires after 10 minutes. Tap New code and paste the fresh message to your agent.
›My agent gets 401, 403, 429, or connection errors
401 means the agent was disconnected; connect it again with a new code. 403 usually means its HTTP client is filtered, and it should send a User-Agent header. Agent calls have no rate limit, but on a 429 it should wait the seconds in Retry-After. Agents in a sandbox need the relay host on their network allowlist. Details are in making requests and platform notes.
›A note says “Didn’t send”
Your webhook didn’t accept it after 3 tries. Fix the endpoint, then open the note and tap Retry. See webhooks.
Still stuck? Email support@ramble.watch.