diff --git a/qr_script/README.md b/qr_script/README.md
new file mode 100644
index 0000000..4758940
--- /dev/null
+++ b/qr_script/README.md
@@ -0,0 +1,42 @@
+# QR Code Generator
+
+Generates PNG QR codes from a CSV/TSV file using `qrencode`.
+
+## Input Format
+
+| Column 1       | Column 2      |
+|----------------|---------------|
+| data to encode | output name   |
+| 123456         | my_qr         |
+
+- First row is a header (skipped).
+- Column 1: the text/data to encode into a QR code.
+- Column 2: base filename (`.png` is appended).
+
+## Prerequisites
+
+```bash
+sudo apt install qrencode
+```
+
+## Usage
+
+```bash
+# CSV file (auto-detects comma delimiter)
+python qr_generator.py data.csv
+
+# With output directory
+python qr_generator.py data.csv -o ./output
+
+# Custom module size (default: 10)
+python qr_generator.py data.csv -s 8
+
+# TSV or other delimiter
+python qr_generator.py data.tsv -d $'\t'
+```
+
+### Example
+
+```bash
+python qr_generator.py ../qr_file.csv -o ./qr_output
+```