Description
n8n-nodes-image-orientation
This repository contains the n8n community node Image Orientation.
The node uses Tesseract.js (OSD – Orientation and Script Detection) to analyze an image and detect how the text is oriented. You can then use n8n’s built-in Image node to rotate the image if needed.
Tesseract is an open-source OCR (Optical
Character Recognition) engine that can recognize machine-printed text in images (e.g. PNG or JPEG) or in images embedded in PDF files.
n8n is a fair-code licensed workflow automation platform.
Installation
Follow the installation guide in the n8n community
nodes documentation.
Compatibility
This node has been tested with n8n v1.119.2, but it should also work on newer and older versions.
Usage
Input
- The node expects a binary image as input
- The binary property name is configurable in the node settings (default:
data).
Output
The node returns the Tesseract.js OSD output as JSON and always passes the binary data through unchanged.
Key output properties include:
-
orientation_degrees
How many degrees the image would need to be rotated clockwise so that the text is upright.
This value can be used directly in n8n’s Image node to rotate the image. -
orientation_confidence
How confident Tesseract is that the detected orientation is correct.
You can use this in an IF node to avoid rotating images when the confidence is too low. -
text_detected
A boolean indicating whether Tesseract was able to detect enough text to determine an orientation.true→ Orientation values are considered valid.false→ Likely no text (or not enough text) was detected in the image.
Note: The input binary data is always forwarded to the output item unchanged.
Examples
Example #1 – Text detected, rotation required
The text is detected and the image should be rotated 270 degrees clockwise to be upright.
{
"tesseract_script_id": 12,
"script": "Latin",
"script_confidence": 8.703704833984375,
"orientation_degrees": 270,
"orientation_confidence": 14.62347412109375,
"text_detected": true
}
Example #2 – Text detected, no rotation required
The text is detected and the image is already correctly oriented (orientation_degrees is 0).
{
"tesseract_script_id": 12,
"script": "Latin",
"script_confidence": 9.5,
"orientation_degrees": 0,
"orientation_confidence": 42.1,
"text_detected": true
}
Example #3 – No text detected
Tesseract could not detect enough text to determine an orientation.
All OSD values are null and text_detected is false.
{
"tesseract_script_id": null,
"script": null,
"script_confidence": null,
"orientation_degrees": null,
"orientation_confidence": null,
"text_detected": false
}
