foo2xqx-wrapper

foo2xqx-wrapper [-h|--help|--debug] [-z#] [-p#] [-l#] [-n#] [-s#] [-m#] [-q#] [-Y#] [-S%] [-u%] [-b%] [-g#] [-t] [-e|-o] [-P|-L] [-dmodel] [ <input.pcl >output.xqx ]

-z#
    Set resolution: 0=300dpi, 1=450, 2=600, 3=900, 4=1200, 5=1800 (HQ), 6=2400

-p#
    Page width in pixels (e.g., -p612 for letter)

-l#
    Page length in pixels (e.g., -l792 for letter)

-n#
    Number of copies (1-100)

-s#
    Media type: 1=plain, 2=thick, 3=transparency, 4=envelope, 5=labels, 6=heavy, 7=recycled

-m#
    Model: 0=std, 1=alt margins/toner save

-q###
    Quality mode: 101=normal, 102=draft, 110=photo, 111=pres

-Y#
    Duplex: 0=none, 1=long-edge, 2=short-edge, 3=tumble

-S%
    Saturation adjustment (50-200%)

-u%
    Hue adjustment (-50 to +50%)

-b%
    Brightness adjustment (50-200%)

-g#
    Gamma correction (0.1-4.0)

-t
    Tumble (reverse short-edge duplex)

-P
    Portrait orientation

-L
    Landscape orientation

-dmodel
    Printer model variant

--help
    Show usage summary

--debug
    Enable debug output

The foo2xqx-wrapper is a command-line wrapper script for the foo2xqx printer filter, part of the open-source foo2zjs project. It enables printing support for non-PostScript printers using the proprietary XQX page description language, primarily Kyocera printers like the TASKalfa series and FS models.

Designed for integration with the CUPS printing system, it processes print jobs by interpreting options from the command line and CUPS environment variables (e.g., PPD settings). The wrapper applies transformations for resolution, media type, quality, duplexing, and color adjustments before passing rasterized data to the core foo2xqx engine, which converts input (often Ghostscript-generated PCL) to printer-native format.

Users typically do not invoke it directly; CUPS calls it as a filter (input/output via stdin/stdout). For testing, pipe input: gs ... | foo2xqx-wrapper options > output.xqx. Supports resolutions up to 1200dpi, various paper sizes, and economy modes for toner saving.

Requires the foo2zjs package, including firmware loading utilities for some models. Provides debug output with --debug. Essential for Linux users with compatible Kyocera hardware lacking native drivers.

Firmware may need manual loading via foo2xqx-usb or foo2xqx-net for some models; test compatibility as not all Kyocera printers supported. High resolutions increase processing time and memory use. CUPS PPD files required for seamless integration.

Kyocera FS-1120MFP, FS-1220MFP, TASKalfa 2551ci, 3051ci, 3551ci, 4551ci, and similar XQX-enabled models. Check foo2zjs wiki for full list.

Install foo2zjs package: apt install printer-driver-foo2zjs (Debian/Ubuntu) or compile from source at foo2zjs.rkkda.com. Run getweb 1018 for firmware.

Developed as part of the foo2zjs project initiated by Rick Zaker in 2003 for HP ZJS printers; foo2xqx support added ~2007 for Kyocera XQX. Maintained by OpenPrinting.org; latest releases incorporate CUPS 2.x compatibility and bug fixes for modern kernels.

foo2zjs-wrapper(1), foo2qpdl-wrapper(1), lp(1), lpadmin(8), cups(8)