explaingit

lggurgel/qrme

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

qrme decodes every QR code inside an uploaded PDF or photo on the server, returning typed, readable results like payment codes, links, and Wifi credentials.

Mindmap

mindmap
  root((qrme))
    What it does
      Decode QR from PDF or photo
      Typed payload results
      Auto delete uploads
    Tech stack
      Django
      Celery
      Redis
      Postgres
      Docker
    Use cases
      Pix payment check
      Link safety check
      Wifi and contact QR
    Install
      Progressive Web App
      Android share sheet
      Desktop paste

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Decode a QR code trapped inside a PDF or a phone screenshot without needing a camera.

USE CASE 2

Check a Pix payment QR code's payee, amount, and tamper status before paying.

USE CASE 3

Verify whether a QR code link points to the real domain or a lookalike/shortener.

USE CASE 4

Share a PDF from a messaging app directly into the qrme app on Android to decode it.

What is it built with?

PythonDjangoCeleryRedisPostgresDocker

How does it compare?

lggurgel/qrme0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker and Docker Compose installed, setup is a single make up command.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

qrme solves a very specific annoyance: you have a QR code trapped inside a PDF or a screenshot on your phone, and you cannot point your phone's camera at its own screen to scan it. Instead, you upload the PDF or photo to qrme and it decodes every QR code inside it on the server, handing you back the content as text you can copy. No signup is required, and the uploaded file is deleted right after decoding. The results are more than plain text. qrme looks at what kind of QR code it found and organizes the answer accordingly. A Pix payment code, for example, shows the payee, the amount, and a check confirming the code has not been tampered with. A link shows the real underlying domain along with warnings if it uses a link shortener or looks like it is imitating another domain. Wifi passwords, contact cards, and two factor authentication codes are also recognized and broken into clear fields rather than dumped as raw text. qrme is installable as a Progressive Web App. On Android, it can register itself in the system share sheet, so you can share a PDF from a messaging app directly into qrme for decoding. On a desktop computer, you can simply paste a screenshot onto the page. Under the hood, the project runs Django for the web API, Celery workers for the actual decoding, Redis as the task queue and cache, and Postgres for the database, all wired together with Docker Compose for local setup. PDFs are converted to images before scanning, and decoding tries a fast library first, falling back to a second method for low contrast or skewed codes. The project takes privacy seriously: uploaded files are deleted immediately after processing, decoded results expire automatically after an hour, and files are checked by their actual content rather than trusted by file extension. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Show me the Docker Compose command to run qrme locally with make up.
Prompt 2
Explain how qrme classifies different QR code payload types like Pix, Wifi, and links.
Prompt 3
Walk me through deploying qrme to Railway using DEPLOYMENT.md.
Prompt 4
What security measures does qrme use to keep uploaded files and decoded data safe?

Frequently asked questions

What is qrme?

qrme decodes every QR code inside an uploaded PDF or photo on the server, returning typed, readable results like payment codes, links, and Wifi credentials.

What language is qrme written in?

Mainly Python. The stack also includes Python, Django, Celery.

What license does qrme use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is qrme to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is qrme for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.