This page is part of archived documentation for openHAB 2.5. Go to the current stable version

# CUPS Binding v1

The openHAB CUPS binding allows interaction with printers and their print queues via a CUPS server.

There is also a binding specifically for openHAB 2 here (opens new window).

# Prerequisites

To set up this binding, it is necessary to know the names of the printers registered with the CUPS server.

One way to get this information is to download the current cups4j.runnable-x.x.x.jar file from (opens new window) and query the printers by using the following command

java -jar cups4j.runnable-x.x.x.jar -h <CUPS server name> getPrinters

# Binding Configuration

The binding can be configured in the file services/cups.cfg.

Property Default Required Description
host Yes The hostname or IP address of the CUPS server
port 631 No The port used to connect to the CUPS server
refresh 60000 No The refresh interval (in milliseconds)

# Item Configuration

Each item binding should have this format:


<printerName> is the name or URL of the printer, as registered with the CUPS server. whichJobs has a default value of NOT_COMPLETED; possible values are:

  • ALL

# Example Use Case

The CUPS Binding can be used to switch on a printer if there are print jobs in the queue and switch it off if the queue is empty.

# Items

Number  Print_Jobs_Completed  "Completed print jobs"   (FF_Office)   { cups="" }
Number  Print_Jobs_Queued     "Unfinished print jobs"  (FF_Office)   { cups="MX-870#NOT_COMPLETED" }
Switch  Printer               "Printer"

# Rules

import org.openhab.model.script.actions.Timer

var Timer printerTimer = null

rule "CUPS-Printer Queue"
    Item Print_Jobs_Queued changed
    if (Print_Jobs_Queued.state>0) {
        if (printerTimer!=null) {
        if (Printer.state==OFF) {
    else if (Printer.state==ON) {
        printerTimer = createTimer(now.plusMinutes(5)) [|