OmniPressix

Limits, notes and troubleshooting

Limits and notes#

  • The available formats are those under Card format and a custom format up to 200 × 280 mm, each also in portrait. Label sheets only exist for the Avery Zweckform sheets mentioned there.
  • The blocked zones are guide values according to ISO with a safety margin and are visible only in the editor; the PDF does not leave these areas free.
  • Background images from layouts of older versions (without a stored original) cannot be re-cropped; after a format change choose the image again.
  • Background images are embedded in the PDF as JPEG.
  • Custom fonts: .ttf, .otf and font collections (.ttc, .otc; each font of the collection is loaded separately), no variable fonts with several weights in one file (the base weight is used). Bold and italic exist only if the matching file of the family is loaded.
  • The built-in fonts support the Western European character set (umlauts, ß, €). Other characters need a font of your own.
  • A barcode or QR code needs some free space all around (quiet zone) so that scanners read it reliably. Code 128 can only encode ASCII characters, umlauts in the content lead to an error message; a QR code, on the other hand, also handles umlauts and other Unicode characters. With a lot of content a QR code becomes finer-grained (more small modules) – for a small card field short contents such as a number or a short URL are therefore better than long texts.
  • Image fields support only JPEG and PNG (SVG is converted to a PNG when loaded; in the fixed image of an image field the PDF draws simple SVG as a vector, see Photos), at most 20 MB per photo. Fixed images are not rotated according to EXIF, only photos in the photo folder.
  • Photos are personal data and stay in the photo folder until they are deleted. Edited photos also have their original in the subfolder original; both are removed on deleting.
  • The rounding of the preview (card corners) is only cosmetic, the PDF is rectangular – except with cut contour, when the plotter cuts the corners round.

Troubleshooting#

ProblemSolution
build-all.sh: “Permission denied”Start with bash build-all.sh or run chmod +x build-all.sh once
go is not found under WindowsAfter installing Go open a new terminal. If that does not help, restart the computer
go mod tidy failsCheck the internet connection and proxy settings
Port in useChoose another port: go run . -addr 127.0.0.1:9000
The browser does not openOpen the address from the terminal output by hand
“Barcode invalid” / “QR code invalid” in the fieldThe content contains characters that the chosen format cannot encode (with Code 128 e.g. umlauts) – switch to QR code or avoid umlauts in the content
Scanner shows Chinese or Japanese characters instead of umlautsCode created with an older version: print again. Since 2.1.0 QR codes carry the “UTF-8” information. With DataMatrix/PDF417 the scanner must be set to ISO-8859-1 (Latin-1), which is the default there
Umlauts in the CSV are brokenSave the file as UTF-8 or export from Excel as “CSV UTF-8”
Message “Please choose at least one side”Set a tick at “Print front” or “Print back”
With a card printer there is a white edge or the card is too largeSwitch off the tick “Print with bleed”, it is only meant for cutting yourself
Field stays empty in the PDFCheck whether the placeholder matches exactly a column name of the card data
Numbers from the .ods look different than expected (e.g. postcode without leading 0)The displayed cell content is taken over. Format the column as text in LibreOffice or choose a number format with leading zeros
Image field stays empty with “From photos”The file name of the photo (without extension) must match exactly the value of the chosen CSV column, e.g. 1000123456.jpg to 1000123456. Is the photo uploaded in the “Photos” area?
Message “The running program is outdated” after adding an image fieldProgram and user interface (web/index.html) belong together (see the entry further below) – replace the whole project folder and restart the program
Font is not loadedonly .ttf, .otf, .ttc and .otc are read; the message names the reason
Front and back are printed although only one is ticked, or the message “The running program is outdated” appearsProgram and user interface (web/index.html) belong together. Replace the whole project folder with the newest version, quit the program with Ctrl+C, restart it with go run . and reload the page with Ctrl+F5. The user interface is inside the program file at start, so old programs keep delivering the old version. In the terminal every PDF request shows a line such as PDF-Anfrage: 3 Karten, Vorderseite=false, Rückseite=true
The message “Turn the card over” does not appearIt only appears if both ticks “Print front” and “Print back” are set and “Printer prints on both sides (duplex)” is off
The message “Turn the card over” appears although the printer prints on both sidesSwitch on “Printer prints on both sides (duplex)” in the Print window
The print dialog does not appearCheck the browser’s pop-up and print blockers, as a substitute create the PDF and print it by hand
PDF error with a card numberThe message names the card and page; check the CSV row there