QRMe docs

Install

From a release

1. Download QRMe.service.zip from the latest GitHub release.
2. Unzip the download.
3. Move QRMe.service to ~/Library/Services/.
4. Open an app’s Services menu to confirm that Create QR Code and Read QR Code appear.

Unsigned build: If macOS blocks the downloaded service, build it from source instead. A source-built service is the recommended installation path for now.

From source

git clone https://github.com/nvk/qrme.git
cd qrme
./scripts/install-service.sh

Use QRMe

Create a QR code from text

1. Select text in Safari, Notes, Mail, TextEdit, or another macOS app.
2. Control-click the selection or open the app’s Services menu.
3. Choose Create QR Code.
4. Scan the result, copy the source text, or save the QR code as a PNG.

Read a QR code from an image

1. Select a PNG, JPEG, HEIC, GIF, or TIFF image in Finder.
2. Control-click the file and open Services.
3. Choose Read QR Code.
4. Copy the decoded contents. If the result is an HTTP or HTTPS URL, QRMe also offers an explicit Open Link button.

Some browsers—including Chrome in many image contexts—do not provide image data to macOS Services. Save the image and use Finder when the command is not available.

Use the regular app

Developers can build QRMe.app with ./scripts/build-app.sh. Its Open QR Code… command reads an image file directly.

Troubleshoot

The service does not appear

• Confirm that the bundle is at ~/Library/Services/QRMe.service.
• Run ./scripts/install-service.sh again to refresh macOS Services.
• Check System Settings → Keyboard → Keyboard Shortcuts → Services and enable the QRMe commands if macOS has disabled them.
• Quit and reopen the app where you are trying to use the service.

No QR code was found

Use a sharper image with the complete code visible. Cropped edges, heavy compression, very low contrast, or extreme perspective can prevent decoding.

The selected text is too long

QRMe limits input to 1,800 UTF-8 bytes. Shorten the text so the resulting code remains practical to scan.

Build and verify

QRMe requires macOS 13 or later and Swift 5.9 or later.

swift build --disable-sandbox
swift test --disable-sandbox
swift run --disable-sandbox QRMe --self-test
./scripts/package-release.sh

The packaged service and its SHA-256 checksum are written to build/.

Uninstall

./scripts/uninstall-service.sh

You can also remove ~/Library/Services/QRMe.service manually.

Privacy

QRMe processes selected text and images locally. It has no account system, analytics, telemetry, advertising, or network service. See the short privacy statement.