считать qr-код на Mac
обновлено · автор Anton Shakirov
qr-код нарисован для камеры телефона, а камера — ровно то, что нельзя навести на собственный экран. hop обводит код там, где он лежит: во вкладке браузера, в pdf, на слайде, в кадре на паузе, — и отдаёт вам то, что внутри.

| what it is | qr code scanner inside hop, a menu bar app for macOS |
|---|---|
| price | free — no trial, no pro tier, no account |
| licence | MIT, source on GitHub |
| requires | macOS 14 or later, Apple silicon or Intel |
| works offline | yes |
| data sent anywhere | none |
почему код на экране — неудобный случай
код уже на Mac, а читают его обычно вторым устройством, и в итоге ссылка приходит не туда, откуда всё началось, и её приходится отправлять обратно.
собственная камера Mac тоже не выручает: она смотрит на вас, а не на экран. значит, дело вообще не в камере. код надо прочитать из тех пикселей, из которых он уже состоит.
как считать qr-код на Mac
жест тот же, что и для скриншота: грубо обвели код — и то, что в нём лежит, возвращается текстом, который можно прочитать до того, как что-то по нему делать. порядок тут важен: код на экране — это адрес, который никто не проверял, а камера телефона открывает его раньше, чем вы успеете посмотреть. для веб-адреса появляется кнопка «открыть ссылку», всё остальное копируется как текст.
хоткей, что ещё читается тем же кадром и где модуль включается — подробная инструкция на вашем языке: распознавание текста в инструкции
в кадр необязательно брать только код: текст вокруг читается тем же проходом, поэтому счёт, обведённый целиком, отдаёт и ссылку, и номер заказа сразу.
тот же кадр, тот же жест и то же окно модуль применяет к обычному тексту на экране. снять текст с экрана
коды, которых на экране нет
когда код лежит в файле, а не перед глазами, обводить экран — крюк. перетащите картинку в окно или вставьте её через ⌘V.
- билет или посадочный талон, сохранённый в pdf
- фотография афиши, меню или наклейки на посылке
- скриншот, который прислал коллега в переписке
- счёт с кодом оплаты и номером для сверки
код, застрявший в кадре видео, — та же работа в другой обёртке: картинка есть, а файла, из которого она взялась, нет. достать текст из видео на паузе
бесплатные способы прочитать qr-код на Mac
их ходит три, и каждый для своих случаев. лучше понять, в каком случае вы, до того, как что-то ставить.
снять скриншот кода и дать его Live Text
⌘⇧4, обвести код, открыть снимок и поискать в нём ссылку. этот путь советуют почти все ответы на форумах, и когда он срабатывает, он не стоит ничего.
сработает он или нет, зависит от того, отдаст ли система эту картинку Live Text вообще. для холста, который приложение нарисовало само, это монетка, и узнаёте вы уже после того, как файл создан. в любом случае на рабочем столе теперь лежит png, который вам не был нужен.
навести на экран телефон
камера iPhone читает коды без всякого приложения, если включена нужная настройка. для кода на афише ничто на этой странице её не обгонит.
для кода на собственном мониторе это круг: разблокировать, открыть, навести, поймать фокус. а ссылка потом открывается на телефоне, пока вы сидите за Mac.
у Apple есть своя инструкция и про камеру, и про настройку, которая ей нужна (страница английская): как считать qr-код — руководство пользователя iPhone
загрузить картинку на сайт-декодер
сайты, которые принимают картинку и печатают, что в коде, — и шорткаты для macOS, которые передают друг другу, устроены в основном так же: отправляют картинку в веб-api и читают ответ.
для ссылки на публичную страницу сойдёт. для кода оплаты, билета или одноразового входа — совсем другое дело: чтобы узнать, что внутри, вся картинка целиком уезжает на чужой сервер.
итого: код на бумаге или в фотографии, которую можно просто открыть, — берите бесплатный путь и не думайте. простой случай заканчивается там, где код сидит в месте, которое система картинкой не отдаст: кадр на паузе, произвольный прямоугольник, где код где-то внутри. дальше любой бесплатный путь идёт через скриншот, а часто и через чужой сайт.
что меняет hop, когда код уже на экране
| что у вас | бесплатный путь | с hop |
|---|---|---|
| код на бумаге, на афише или на чужом экране | телефон прочитает его за секунду | не нужен — берите телефон |
| код в фотографии или на веб-странице | Live Text читает его прямо там | результат тот же самый |
| код в кадре видео, поставленного на паузу | снять скриншот, открыть снимок, надеяться, что распознается | обвести прямо там, где играет |
| код в приложении, которое не отдаёт системе картинку | скриншот, сохранить, открыть, прочитать — и файл остался лежать | один кадр, и убирать за собой нечего |
| код, рядом с которым напечатан номер для сверки | код прочитать одним способом, номер перебить руками | один проход возвращает и то и другое |
| код оплаты или одноразовый вход | сайтам-декодерам нужно загрузить картинку | разбирается на этом Mac, работает и с выключенным Wi-Fi |
считанный код — это непроверенные данные
qr-код нельзя прочитать глазами, и именно поэтому в нём удобно прятать плохой адрес. наклейка поверх кода на парковочном автомате, подменённый код в счёте — на вид не отличить ни вам, ни сканеру, который сначала действует.
сначала чтение, действие потом
hop показывает прочитанное и на этом останавливается. кнопка «открыть ссылку» появляется только у веб-адресов: телефонный номер, пароль от Wi-Fi или карточка контакта остаются обычным текстом, который вы читаете и пускаете в дело сами. никто никуда не звонит, ни к какой сети не подключается и никого в контакты не добавляет.
увидеть адрес до того, как он откроется, — не мелочь: в этом и вся разница между «прочитать код» и «подчиниться коду».
прочитанное попадает и в историю буфера, так что код, считанный час назад, никуда не делся. что хранит история буфера обмена
штрихкоды выходят тем же проходом
у распознавания нет отдельного режима, в который надо переключаться. текст, qr-коды и обычные штрихкоды с упаковки читаются разом, поэтому кадр с наклейкой на посылке отдаёт и трек-номер, и код сразу.
ничего не уходит с вашего Mac
код разбирается на месте, движком Vision от Apple — тем же самым, которым пользуется система. никакая картинка никуда не загружается, ваш экран не видит ни один сервер, и работает это с выключенным Wi-Fi.
для кодов это важнее, чем для текста. то, что меньше всего хочется отдавать чужому сервису распознавания в обмен на бесплатное приложение, — ровно то, что сканируют второпях.
у hop нет ни аккаунтов, ни профилей, ни телеметрии. единственное, что он отправляет, — номер собственной версии, когда проверяет обновление.
сам разбор — это распознавание штрихкодов у Apple, описанное и открытое любому приложению для Mac (страница английская): VNDetectBarcodesRequest — документация для разработчиков Apple
frequently asked questions
- умеет ли Mac читать qr-коды с экрана?
- сам по себе — нет, во всяком случае не с произвольного куска экрана. Live Text читает код внутри того, что система признала картинкой: фотография, изображение на веб-странице. отсюда и обычный совет сначала снять скриншот и открыть его. hop обходится без скриншота и читает тот прямоугольник, который вы обвели.
- можно ли считать qr-код без телефона?
- да, в этом и смысл. код читается с экрана Mac или из файла с картинкой, а ссылка открывается в том браузере, перед которым вы и так сидите.
- работает ли это без интернета?
- да. разбор идёт на вашем Mac, движком Vision от Apple. ничего не загружается и связь не нужна — она нужна только той ссылке, которую вы решите открыть.
- откроет ли он ссылку сам?
- нет. сначала вы видите прочитанное и нажимаете «открыть ссылку», если хотите. и кнопка эта бывает только у веб-адресов: пароль от Wi-Fi или карточка контакта остаются текстом, потому что считанный код — это непроверенные данные.
- как прочитать qr-код с паролем от Wi-Fi на Mac?
- обведите его — и получите имя сети и пароль текстом, который дальше вписываете в настройки Wi-Fi сами. hop не подключит вас к сети: код Wi-Fi — это чужие учётные данные, которые кто-то напечатал, и подключаться по одному его слову приложению не стоит.
- читает ли он штрихкоды наравне с qr-кодами?
- да, тем же проходом, что и текст, — переключать нечего. обычные штрихкоды с упаковки читаются так же, как qr-код.
- а если код мелкий или слегка размыт?
- обведите с запасом и попробуйте ещё раз: кадр может быть грубым, лишняя площадь вокруг кода ничего не стоит. места тут больше, чем кажется: на macOS 26.6.2 код со ссылкой в 43 символа читался ещё с квадрата в 28 пикселей и перестал на 24. если не берётся миниатюра, обычно хватает открыть картинку в полный размер.
- это бесплатно?
- полностью. ни пробного периода, ни платной версии, ни того, что надо разблокировать. у hop открытый исходный код, и модуль распознавания открыт всем ровно так же.
other tools in hop
- keep awakedownloads, renders and calls run to the end. even with the lid closed.
- speed testdownload, upload and responsiveness — measured through Apple's own servers.
- app firewallsee which programs go online, and where — block any of them with one click.
what people do with this
об авторе

Anton Shakirovсоздаёт hop
создаёт hop и все страницы этого сайта. девятнадцать инструментов под одной иконкой в menu bar, MIT и открытый код. на issue и письма отвечает сам.