Help & FAQ

Support

Common questions, and how to reach us.

Can I use Ferry without an AI service?

Yes. Without any setup, Ferry uses the system's on-device translation, text recognition and speech recognition. The first time you translate a language pair, the system offers to download it; after that it works offline.

With an AI service configured, translations usually read more naturally, and you also get AI voices, voice transcription and multimodal image recognition.

Where do I get an API key, and what does it cost?

Sign up with the AI service you want to use, add credit, and create an API key in its dashboard. Paste the key into Ferry's settings. The service bills you directly for what you use. Ferry adds no markup and never handles payment.

You can tap "Detect Capabilities" in the provider editor to verify your key with zero token usage, and providers like OpenRouter display per-million-token pricing right in the model picker. We recommend setting a monthly spending limit with your provider.

Ferry says my key is invalid or out of credit

Check that the key was copied in full with no extra spaces and that your account has credit. If you use a self-hosted or third-party relay service, check the API address too. Ferry shows the specific reason; tap Details to see the provider's original message, which is useful to include when you contact us.

How do I use Ferry from other apps? (iPhone, iPad)

Set as Default Translation App: On iOS 18.4 or later, open Settings → Apps → Default Apps → Translation and choose Ferry. Then select text in any app and tap Translate.

Use the System Share Sheet: Tap Share in any app and choose Ferry to send text, web or X links, a single image (for OCR translation), 2–30 screenshots (to stitch into a long screenshot), a video (to extract bilingual subtitles), or an audio file. You can also paste or drag images and audio directly into Ferry's source box.

How do Long Screenshot Stitch and Video Subtitle Capture work on iPhone & iPad?

Tap "Long Stitch" or "Video Subtitles" under Quick Start on the home screen (or long-press the bottom camera button):

Long Screenshot & Stitch: Pick 2–30 overlapping screenshots from Photos to automatically deduplicate sticky headers/footers, or start a cross-app scrolling broadcast and scroll in any app (Ferry pauses capture while its own UI is visible). After stitching, tap "Crop / Pages" to remove unwanted pages without lag, crop to a box, or slice out a horizontal band, and tap "Translate on Image" to paint translations right over the layout.

Video Subtitle Stitch: Import a video from Photos/Files or start a cross-app subtitle recording for streaming apps. Draw or drag the green subtitle band to mark where subtitles appear (excess bottom area below higher subtitles is trimmed automatically), then switch between Original, Bilingual, and Translated views or tap "Adjust Box" anytime.

The shortcuts don't work on my Mac

Selection translate needs Accessibility access, and screenshots, scrolling capture and Subtitle Stitch need Screen & System Audio Recording access. Open System Settings → Privacy & Security, turn Ferry on in each list, then quit and reopen Ferry.

macOS asks again about screen recording from time to time (currently about once a month). This applies to every screenshot app; just allow it.

If a shortcut conflicts with another app, change it in Ferry's settings.

How do I move my settings to a new device?

With iCloud sync, your settings and history appear automatically on any device signed in to the same Apple Account. You only need to enter your API key again, since keys are never uploaded.

Without iCloud: on the old device, choose Export Settings in Ferry, set a password, and save the encrypted file. On the new device, choose Import Settings and enter the same password.

Can you see what I translate?

No. Ferry has no server. Long screenshot stitching and subtitle extraction happen on your device, your content goes only to the AI service you configure, and on-device translation never leaves your device. See the privacy policy.

Contact us

Email service@huaguomt.com and we'll get back to you as soon as we can.

To help us help you faster, include your device model and OS version, your Ferry version, the steps that led to the problem, and a screenshot if you can.