FerryQR

A privacy-first QR scanner for Android that ferries each code to the right app. Where most scanners stop at the text of a code, FerryQR hands the code to the app or system feature that can act on it.

中文说明

Features

  • Opens codes in their own apps. Links go to the app that handles them; Wi-Fi, contacts, events, passkeys, eSIMs, phone numbers, messages, email and map locations go to the matching part of the phone. FerryQR also reads some specific codes and shows their content, so far the information in boarding pass codes.
  • Strong scanning. The advanced scanning found in Alipay and WeChat, such as automatic zoom and picking one of several codes, is here too. Images on the phone can be scanned by sharing them to FerryQR or opening them with it, and a screenshot shared to FerryQR quickly reads a code on the screen.
  • One scanner in place of many. Codes meant for a particular app, WeChat mini program codes included, open straight in that app after a scan in FerryQR, so its own scanner is no longer needed. Some apps need the LSPosed module.
  • History and favorites. Scanned codes are kept on the phone as history, and entries can be added to favorites. Favorites stay at the top of the history and can be renamed and reordered; up to four can be added to the shortcuts shown when the FerryQR icon is long pressed.
  • Shows codes. Tapping an entry in the history draws its code again, to be scanned by another phone or saved as an image. The code can be switched to another format to suit the reader, enlarged, and shown at full brightness, so it scans more reliably.
  • Creates codes and barcodes. FerryQR draws every format ZXing writes and suggests the one that suits the text best. Codes are ready to share, copy or save once created.
  • Quick Settings tile. Once added to Quick Settings, it starts scanning from the notification shade.

Install

FerryQR needs Android 11 or later on a 64-bit ARM phone. Download the APK from Releases.

LSPosed module

Some codes lead to a feature or page inside an app only when that app's own scanner reads them. With FerryQR enabled as an LSPosed module, FerryQR ferries their content straight into those apps, so one scanner does what is otherwise spread across them. Without the module, FerryQR can at most open such an app's scanner for the code to be scanned again; opening the code in the browser first, for the browser to pass it on to the app, is also worth a try. WeChat, DiDi and Meituan are supported so far. Alipay takes scan results from other apps through its official entry, so it works without the module.

  1. In LSPosed, enable FerryQR and tick WeChat, DiDi and Meituan in its scope.
  2. Restart those apps.
  3. Open FerryQR and check in the settings, at the top left of the scanner, that the module is active for each app.

Privacy

FerryQR asks only for the camera and has no internet access. A code's content is passed only to the app it is opened in. History stays on the phone, and whether content that may hold sensitive information is kept in history can be chosen item by item in the settings. The create page reads the clipboard only once, as it opens. Without camera access, images can still be scanned.

License

MIT. FerryQR uses zxing-cpp, ZXing and WeChatQRCode, all licensed under Apache 2.0.

Releases

v2.3.2

Stable

11/21/2026, 6:44:39 PM

TL;DR

  • Two-factor authentication codes open in an authenticator app, or show a card to copy the key
  • Each kind of sensitive content can be kept out of history
  • Passkey requests are named for what they ask
Full changelog

feat: two-factor authentication codes go straight to an authenticator app; their card shows the service, account and type, keeps the key out of sight, and offers to add, copy the key or account, and copy or share the link, with a note on what the key gives away
feat: without an authenticator app that adds keys from links, the two-factor card says so and leads with copying the key
feat: the settings choose for each kind of sensitive content whether a scan is kept in history: Wi-Fi passwords, boarding passes, eSIM activation codes, passkey requests and two-factor keys
feat: passkey requests are named for what they ask, such as signing in or creating a passkey, in history, favorites and their card
changed: eSIM activation codes, passkey requests and two-factor keys are no longer kept in history unless switched on in the settings; favoriting one still keeps it
changed: the settings for opening codes in other apps have a page of their own, and the settings follow the order of use
fixed: history titles without spaces, such as links and keys, fill their first line instead of leaving a short piece like "FIDO:/" alone on it

Assets

1

v2.3.1

Stable

11/16/2026, 4:08:22 PM

TL;DR (changes since v2.2.1)

  • Create codes in any of 13 formats, with the right one suggested
  • Boarding passes open as a readable card
  • Barcodes enlarge by tilting, growing taller or going full screen sideways
Full changelog

fixed: switching the format of an enlarged code in history shows the new format at once instead of the old one

Assets

1

v2.3.0

Stable

11/16/2026, 3:49:41 PM

TL;DR

  • Create codes in any of 13 formats, with the right one suggested
  • Boarding passes open as a readable card
  • Barcodes enlarge by tilting, growing taller or going full screen sideways
Full changelog

feat: the create page draws every format ZXing writes, 13 in all, and starts from a suggested one: PDF417 for boarding passes, EAN-13 or UPC-A for numbers with a valid check digit, QR otherwise
feat: a format picker previews the text in every format and explains why a format cannot hold it, such as a wrong digit count or check digit
feat: an optional setting makes the create page start from the format chosen last time
feat: a long press on a code in history draws it in another format for the reader at hand, while the entry keeps its own
feat: history draws barcodes such as EAN-13 and Code 128 again in their own format instead of as a QR code
feat: boarding pass codes get a card with each flight's route, date, seat, class and sequence number, the booking reference, the passenger, frequent flyer and bag tag numbers, the raw content and a privacy note
feat: barcodes and PDF417 enlarge by tilting along the diagonal, by growing taller with their bars drawn again rather than stretched, or over the whole screen turned sideways, as a setting chooses
feat: an optional setting turns the screen to full brightness while a code is enlarged
feat: favorites can be reordered in history by dragging, from the menu or with accessibility actions, and the app shortcuts follow the order
feat: passkey requests older than five minutes are marked as likely expired, and passkey, eSIM and Wi-Fi Easy Connect cards offer to try again
fixed: an enlarged code fits the screen when the phone is turned or the window is resized
fixed: result cards about as tall as the screen follow a swipe down from anywhere on them instead of shaking under the finger
fixed: passkey, eSIM and Wi-Fi Easy Connect cards say the system did not take a code only after a camera scan was offered to it
fixed: sharing from a history card leaves the card open, as sharing the code image already did
fixed: turning the screen in history no longer closes an open card

Assets

1

v2.2.1

Stable

11/5/2026, 4:19:54 PM

fixed: swiping a history entry acts only once the row has moved halfway across, so a short quick flick no longer deletes or stars it by accident
changed: the tick and the colored background during a swipe mark the point past which letting go deletes the entry or changes its favorite; flinging the row back from there cancels the swipe

Assets

1

v2.2.0

Stable

11/5/2026, 8:17:08 AM

feat: the LSPosed module opens codes in DiDi and Meituan as well as WeChat, such as bike codes and Meituan, Dianping and Maoyan links
feat: mini program codes reach WeChat in the form its own scanner reads them, so the mini program opens at once
feat: a settings page shows whether the module works in each app, and sets how each app takes codes: directly, or shown to its camera
feat: the module's state comes from LSPosed itself, and an updated FerryQR takes effect in running apps without restarting them
feat: a toast confirms each code ferried to another app
feat: without the module, a code still in front of the camera opens its app's scanner for a second scan, and other codes show a card with the actions available
feat: DiDi and Meituan links that the apps register as App Links open in them directly
feat: WeChat red packet codes and more WeChat Pay links open in WeChat
feat: cards, history, favorites and shortcuts name what a code is, such as "Meituan bike [no.]", "WeChat Pay code", a Wi-Fi network or a contact
feat: mini program codes in history are named by their content as WeChat reads it
feat: result cards show save, copy and share under the code instead of in a long press menu, and put all actions on one line when they fit
feat: history, the create page and settings open as pages of their own, with the system's predictive back animation
feat: the create page keeps its actions under the code, offers the same apps as result cards, and settles in one motion as the keyboard opens or closes
fixed: the create page toolbar no longer jumps sideways when the offered apps change
fixed: the share button no longer flashes as it becomes available
fixed: the favorite star on the create page matches the buttons beside it
fixed: a card opened from a favorite shortcut right after start offers the apps the module works in
fixed: the save and copy icons look as large and as bold as the star beside them
changed: DiDi and Meituan need to be ticked in FerryQR's scope in LSPosed, and restarted once, to take codes through the module
changed: the create page offers apps only for links, the same as result cards, and no longer for plain text
changed: the scanner no longer shows a notice when the module is active in WeChat; the settings page and the toast after each handoff show it instead

Assets

1

v2.1.0

Stable

11/4/2026, 3:33:30 AM

feat: codes can be kept as favorites with the star on result cards and the create page, or by swiping a history entry right
feat: favorites stay at the top of history, can be renamed, fold away when there are more than four, and are kept when history is cleared
feat: opening a favorite draws its code again, and tapping the code enlarges it for another phone to scan, with PDF417 turning as it grows
feat: up to four favorites can be added to the app shortcuts from the long press menu in history
feat: history entries can be deleted by swiping left, with undo, and a long press opens a menu of actions
feat: the create page keeps its actions in a floating toolbar and shares the code as an image to any app
feat: history and favorites are included in Android backup
fixed: messages on the create page appear above the keyboard instead of behind it
fixed: scan controls, hints, the camera permission panel and image results fit narrow screens and large fonts
fixed: a back gesture cancelled from history or the create page no longer leaves part of the camera visible and stops later back gestures from working

Assets

1

v2.0.2

Stable

10/30/2026, 6:57:38 PM

feat: QR codes that the quick read misses, such as small, tilted or blurred ones, get a deeper read at full resolution and a second decoder, wherever they are in view
feat: codes in view are reported together, so a QR code and a mini program code side by side both appear in the picker
feat: mini program codes that cannot be read join the picker beside the other codes, from the camera and from images
feat: the camera focuses and meters on a code that is not read yet, and zooms toward small codes of any kind
feat: small codes farther from the camera are found sooner
feat: images and screenshots are searched more thoroughly, finding mini program codes next to QR codes and small codes on full pages

Assets

1

v2.0.0

Stable

10/30/2026, 6:49:46 AM

breaking: the package name is now io.github.lcebot.ferryqr, as LSPosed modules expect, so 2.0.0 installs as a separate app

feat: read WeChat mini program codes, show their content and open them in WeChat
feat: optional LSPosed helper that hands scanned WeChat codes to WeChat's scanner directly, without aiming again or choosing between several codes; it only hooks Android camera APIs inside WeChat
feat: with the helper, result cards and history open WeChat codes in WeChat instead of asking for another scan
feat: mini program codes that are located but cannot be read are offered to WeChat, from the camera and from images
feat: open generated text in Alipay, and in WeChat with the helper
feat: WeChat and Alipay actions show the apps' own icons
feat: revised wording in English and Chinese

Assets

1