Troubleshooting
Common problems and quick fixes.
| Problem | Try this |
|---|---|
| macOS says the app is damaged or from an unidentified developer | Right-click, Open. Or xattr -dr com.apple.quarantine /Applications/Hanouti.app |
| Windows SmartScreen blocks the installer | More info, then Run anyway (until the installer is signed) |
| "Read-only mode" banner | The licence needs renewal. Connect to the internet and open Licence, then Refresh |
| Activation refused: no seat available | Deactivate an old machine from the Licence page, or ask support |
| Nothing prints | Run the test page; check the transport (USB, network, driver); try the generic profile or OS-driver mode |
| Arabic prints as squares on a receipt | Set the Arabic mode of the printer profile to raster |
| Star printer ignores commands | Switch it to ESC/POS emulation mode |
| Labels drift or the gap is wrong | Run the printer's calibration, then check label size and gap |
| Restore says "newer version" | Update the app, then restore |
| A scanner types extra characters | Set the scanner to keyboard mode with Enter as suffix |
If it persists, note the version (Help menu) and contact support.