https://github.com/flangvik/qrucible
Python utility that generates "imageless" QR codes in various formats
https://github.com/flangvik/qrucible
Last synced: 8 months ago
JSON representation
Python utility that generates "imageless" QR codes in various formats
- Host: GitHub
- URL: https://github.com/flangvik/qrucible
- Owner: Flangvik
- License: gpl-3.0
- Created: 2024-06-06T13:41:21.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-10T15:07:39.000Z (almost 2 years ago)
- Last Synced: 2025-02-05T20:29:52.728Z (over 1 year ago)
- Language: Python
- Homepage:
- Size: 708 KB
- Stars: 106
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## QRucible
A tiny Python utility that generates "imageless" QR codes in various formats and obfuscates keywords in emails by illustrating them using tables. This is useful for evading keyword-based and AI-assisted QR code phishing-specific detections. Partially released with an accompanying [blog post](https://flangvik.com/posts/2024-06-13-pixelless-qr-codes-with-qrucible/) at x33fcon 2024, with more features added during Defcon 32.
## Install
```
pip3 install -r requirements.txt
python3 QRucible.py
```
For pytesseract and the keyword obfuscation to work correctly, you may also need to install Tesseract OCR separately
For Ubuntu:
```sh
sudo apt-get install tesseract-ocr
```
For macOS using Homebrew:
```sh
brew install tesseract
```
For Windows:
Download the Tesseract installer from [tesseract GitHub](https://github.com/UB-Mannheim/tesseract/wiki).
Run the installer and follow the instructions.
## Usage
```
usage: QRucible.py [-h] -u URL [-s SIZE] [-i INPUT] [-o OUTPUT] [--css] [--tables] [--eml] [--obfuscate OBFUSCATE [OBFUSCATE ...]]
A tiny Python utility that generates "imageless" QR codes in various formats and obfuscates keywords in emails
options:
-h, --help show this help message and exit
-u URL, --url URL The URL to be encoded in the QR code.
-s SIZE, --size SIZE The box size of the QR code. (default: 40)
-i INPUT, --input INPUT
The input HTML (template) file, replaces the string QR_PLACEHOLDER with the QR code
-o OUTPUT, --output OUTPUT
The output path to an HTML or EML file.
--css Generate QR code using the CSS method.
--tables Generate QR code using the table method. Default
--eml Generate an EML file instead of an HTML file.
--obfuscate OBFUSCATE [OBFUSCATE ...]
Keywords to obfuscate by illustrating them as tables.
```
## CSS/Table QR Code Example
The below QR code is generated using HTML tables
```
.\QRucible.py -u https://youtu.be/dQw4w9WgXcQ -i '.\MFA_QR_CODE _TEMPLATE.html' --tables --eml
```
## Keyword Obfuscation Example
The keywords marked in the email below are illustrated using tiny tables, not text, and will therefore confuse AI trying to understand context / bypass keyword flagging/detection.
```
.\QRucible.py -u https://youtu.be/dQw4w9WgXcQ -i '.\MFA_QR_CODE _TEMPLATE.html' --tables --obfuscate QR mobile device MFA
```
# Credits
CSS method is based on this example: https://codepen.io/jasonadelia/pen/DwWaNW