Successor and fusion of the QRtransfer and OCRtransfer plugins. This plugin replaces both individual plugins and provides a unified interface for all payment data imports.
A combined Jameica/Hibiscus plugin for reading SEPA payment data from QR codes and OCR (invoices), with automatic source type detection.
| Old Plugin | Function | Status |
|---|---|---|
| QRtransfer | QR code import (EPC/EMV) | β No longer needed |
| OCRtransfer | OCR import (invoices) | β No longer needed |
| DataTransfer | Both in one + Import dialog | β This plugin |
- One plugin instead of two: Install once, instead of installing QRtransfer AND OCRtransfer separately
- Automatic detection: No manual selection needed - the plugin automatically detects QR code or OCR
- Hibiscus Import Dialog: Appears directly in Hibiscus's import menu ("Invoice File (PDF/Image) - OCR/QR")
- Review dialog: Data can be reviewed and corrected before saving
- Unified settings: Keyword search for both modes in one settings view
- File - Load PDF invoices or image files (PNG, JPG, BMP, TIFF)
- Clipboard - Read images directly from clipboard
- Webcam - Scan QR codes live with camera (local or IP camera)
- IP Camera - Use Android phone (IP Webcam/DroidCam) or RTSP cameras as QR scanner
- EPC (BCD) format - European Payment Council standard format
- EMV (TLV) format - EMV standard from payment terminals
- Multi-QR detection: Automatically find and select multiple QR codes in a PDF
- Local webcam - Direct USB/built-in camera via OpenCV VideoCapture
- IP cameras - Use your phone or network camera as QR scanner:
- Android: IP Webcam (port 8080) or DroidCam (port 4747)
- RTSP cameras: Any RTSP stream (e.g., security cameras)
- iPhone: Limited support via third-party apps
- Camera rotation: 0, 90, 180, 270 degrees (for both local and IP camera)
- Configurable protocol (HTTP/HTTPS/RTSP), address, port, path, credentials, timeout
- Settings persist across sessions
- Tesseract 5.5.2 (via tess4j 5.19.0)
- PDF text extraction (direct and OCR fallback)
- Configurable OCR settings (OEM, PSM, DPI, language, whitelist/blacklist)
- Recipient keywords: Automatic detection of recipient name
- Purpose keywords: Automatic detection of payment purpose
- Case-insensitive search
- Extended editor with double-click (line-by-line input)
Direct creation of transfer drafts in Hibiscus
- Settings: Help button with detailed explanation of all options
- Internationalization: Full German and English language support
- Jameica 2.10.0+
- Hibiscus 2.10.0+ (with ClassFinder patch - see below)
- Java 8+
- Tesseract OCR (included in plugin, but requires
tessdata/deu.traineddata- see below)
The plugin includes Tesseract OCR, but requires language training data to function. The tessdata/deu.traineddata file (German language, ~8.6MB) must be included in the plugin ZIP.
If OCR fails with "Kein Text erkannt" (No text recognized), the tessdata file may be missing. Download it from:
mkdir tessdata
curl -L -o tessdata/deu.traineddata https://github.com/tesseract-ocr/tessdata_best/raw/main/deu.traineddataOn macOS, Tesseract must be installed separately. The plugin uses tess4j, which bundles native Tesseract libraries for Windows and Linux, but not for macOS.
Installation with Homebrew:
brew install tesseract
brew install tesseract-lang-deubrew install tesseract-lang-deu installs German language support. Training files will be installed to /opt/homebrew/share/tessdata/.
If Homebrew is not installed:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install tesseract
brew install tesseract-lang-deuNote: Without this installation, the error UnsatisfiedLinkError: Unable to load library 'tesseract' will appear in the Jameica log.
Jameica Nightly Build (2026-07-19) and later: Camera permission is already included in Jameica. No additional steps needed.
Older Jameica versions: On macOS, the webcam requires the NSCameraUsageDescription key in Jameica's Info.plist. Without this, macOS will crash Jameica immediately when trying to access the camera (no permission dialog appears).
Quick Fix:
Run the provided script in Terminal:
chmod +x fix-webcam-permission.sh
./fix-webcam-permission.shManual Fix:
- Open Finder and navigate to
/Applications/jameica.app - Right-click on
jameica.appand select "Show Package Contents" - Open
Contents/Info.plistwith a text editor - Add the following entry before the closing
</dict>tag:<key>NSCameraUsageDescription</key> <string>Jameica needs camera access to scan QR codes.</string>
- Save the file and restart Jameica
Alternative (Terminal):
/usr/libexec/PlistBuddy -c "Add :NSCameraUsageDescription string 'Jameica needs camera access to scan QR codes.'" /Applications/jameica.app/Contents/Info.plistAfter this change, macOS will show a permission dialog the first time you use the webcam in Jameica.
This plugin requires a patched version of Hibiscus that uses a global ClassFinder for plugin detection. The standard Hibiscus only finds plugins loaded by its own classloader, which prevents external plugins like DataTransfer from appearing in the Import dialog.
Recommended: Use Nightly Build
The easiest solution is to switch to the current Nightly Build of Hibiscus. It already contains the necessary changes: π Use Nightly Builds
Alternative: Patched Hibiscus Version
If you don't want to switch to the Nightly Build, a patched version is also available: hibiscus-patched.zip
Installation:
- Back up your existing
hibiscus.jarfromjameica/plugins/hibiscus/ - Extract the downloaded
hibiscus-patched.zip - Replace
hibiscus.jarinjameica/plugins/hibiscus/with the patched version - Restart Jameica
Note: The plugin works with the current official Hibiscus release, but the import functions (e.g., "Invoice File (PDF/Image) - OCR/QR" in the import dialog) will not be available. You can still use the plugin via the menu (Datei > Rechnungsdatei laden, etc.).
- Download the correct version for your platform from the Releases page:
- Windows:
hbci.datatransfer-2.4.6-windows.zip - Linux:
hbci.datatransfer-2.4.6-linux.zip - macOS Intel:
hbci.datatransfer-2.4.6-macos.zip(x86_64) - macOS Apple Silicon:
hbci.datatransfer-2.4.6-macos-arm64.zip(M1/M2/M3/M4)
- Windows:
- Start Jameica
- Navigate to File > Search for plugins online... > Install plugin manually...
- Select the downloaded ZIP file
- Restart Jameica
- In Hibiscus, navigate to Transfers > Import
- Select "Invoice File (PDF/Image) - OCR/QR"
- Select a PDF or image file
- Select account (if not already set)
- Data is detected and displayed in the review dialog
- Review data and correct if necessary
- Click Create Transfer
- In the Jameica menu, select Data Transfer
- Choose one of the input methods:
- File - Opens file dialog for PDF or image files
- Clipboard - Reads image from clipboard
- Webcam - Opens camera for QR code scanning
- The plugin automatically detects the source type:
- QR code found β QR code review view opens
- No QR code β OCR review view opens
- Review detected data and correct if necessary
- Click Create Transfer
| Action | Shortcut |
|---|---|
| File (PDF/Image) | Ctrl+Shift+D |
| Clipboard | Ctrl+Shift+V |
| Webcam (QR) | Ctrl+Shift+W |
src/de/willuhn/jameica/hbci/datatransfer/
βββ DataTransferPlugin.java # Plugin entry point
βββ DataTransferIO.java # IORegistry registration (file importer only)
βββ DataTransferBaseImporter.java # Base importer with review dialog
βββ DataTransferFileImporter.java # File importer
βββ OcrSettings.java # OCR settings
βββ action/
β βββ FileAction.java # File input (PDF/Image) with auto-detection
β βββ ClipboardAction.java # Clipboard input with auto-detection
β βββ WebcamAction.java # Webcam QR code scanning
β βββ SettingsAction.java # Open settings view
βββ gui/
β βββ InvoiceView.java # OCR review view with raw text panel
β βββ QRCodeView.java # QR code review view
β βββ InvoiceDebugView.java # Debug view for detected data
β βββ SettingsView.java # Settings view with help
βββ model/
β βββ TransferData.java # Unified data model
β βββ TransferDataHolder.java # Holds TransferData + account for views
βββ parser/
βββ SmartDetector.java # Auto-detection (QR vs OCR)
βββ OcrEngine.java # Tesseract wrapper
βββ InvoiceTextParser.java # Regex parser for OCR text
βββ QrCodeParser.java # Parser interface
βββ EpcParser.java # EPC (BCD) format parser
βββ EmvParser.java # EMV (TLV) format parser
βββ QrCodeSelector.java # Multi-QR detection and selection
- tess4j 5.19.0 - Java wrapper for Tesseract 5.5.2 OCR
- PDFBox 3.0.7 - PDF text extraction and rendering
- ZXing 3.5.3 - QR code decoding (from Jameica/Hibiscus)
- JavaCV 1.5.9 - OpenCV/FFmpeg bindings for webcam and IP camera support
- JNA 5.18.1 - Native library access
- SLF4J 2.0.18 - Logging API
The plugin uses an intelligent detection algorithm:
-
File input:
- PDF files: QR code first β Text extraction β OCR fallback
- Image files: QR code first β OCR fallback
-
Clipboard input:
- QR code first β OCR fallback
-
Webcam input:
- QR code only (no OCR)
- IP camera support: Use Android phones (IP Webcam, DroidCam) or RTSP cameras as QR scanner via FFmpegFrameGrabber
- Camera rotation: Rotate camera image 0/90/180/270 degrees (for both local and IP camera)
- Compact settings layout: Scrollable settings page with side-by-side label groups and section headlines
- Device index from settings: Local webcam uses saved device index directly (no dialog if configured)
- Updated help text: IP camera setup instructions for Android, DroidCam, iPhone, and RTSP cameras
- New settings: Source (Local/IP), Protocol, Address, Port, Path, Username, Password, Timeout, Rotation
- Fixed OCR on macOS: Added
tessdata/deu.traineddata(German language training data) to plugin ZIP - OCR was failing because Tesseract had no language data - Fixed tessdata path resolution: Tessdata path is now resolved relative to plugin directory instead of working directory
- Fixed macOS ARM webcam crash: Added missing
opencv-4.7.0-1.5.9.jar(platform-independent) to macOS ARM ZIP, which was causingClassNotFoundException: org.bytedeco.opencv.opencv_videoio.VideoCaptureon Apple Silicon Macs - macOS webcam setup instructions: Added documentation explaining the
NSCameraUsageDescriptionrequirement for Jameica's Info.plist on macOS
- macOS webcam fix: Webcam now runs in a separate thread, avoiding the SWT/Swing thread conflict that caused Jameica to crash on macOS when clicking "Webcam (QR)"
- macOS ARM support: Added separate download for Apple Silicon (M1/M2/M3/M4) Macs
- Simplified device selection dialog (manual index input: 0, 1, 2...)
- Fixed plugin structure:
plugin.xml,lang/,img/now at top level of ZIP (not inside JAR)
- Fixed classfinder regex:
plugin.xmlnow matches the actual JAR name (datatransfer.jar) instead of the old name - Webcam device enumeration: Uses
FrameGrabber.listfor device selection with fallback to manual input
- Clean build: Removed nested
datatransfer.jarinside the main JAR β fixes classloader conflicts where Jameica loaded old classes from the inner JAR - Fixed classfinder regex:
plugin.xmlnow matches the actual JAR name (hbci.datatransfer.jar) instead of the old inner JAR name - Webcam reliability: Increased open timeout to 20 seconds, added global ClassLoader (
Application.getClassLoader()) for webcam JavaCV classes, improved error logging withSystem.err.println+Logger.errorin all error paths
- Hibiscus Import Dialog integration: "Invoice File (PDF/Image) - OCR/QR" appears in import dropdown
- Review dialog before transfer creation: Data can be reviewed and corrected before saving
- Progress bar with status text during processing
- Clipboard and webcam only via plugin menu (not via import dialog)
- SmartDetector:
detectFromStream()now works with any file type (no more .tmp detection errors) - New TransferDataHolder class for passing TransferData + account to views
- Importer integration for IORegistry (test version)
- Requires current Hibiscus development version
- Details: https://github.com/willuhn/hibiscus/commit/cbbce4ad6abafc652011e5c777338cc74b786d38
- Help button and help text dialog in settings
- Double-click editor for keywords (line-by-line input)
- Case-insensitive keyword search
- Multi-QR detection in PDFs (scan all pages)
- i18n fallback for QR selection dialog
- OCR view: Changed "IBAN/BIC" to "Recipient Account"
- OCR view: Changed label "Recipient" to "Name"
- QR code view: Removed city input field
- Settings: Keywords arranged vertically
- Fusion of QRtransfer and OCRtransfer into one plugin
- Automatic QR/OCR detection
- Unified settings view
- Full i18n support (German and English)
GPL v3 - See LICENSE for details.






