PYCECCLIENT(1)

NAME
pyCecClient - demo client for the libCEC Python bindings

SYNOPSIS
pyCecClient

DESCRIPTION
pyCecClient is the example program shipped with the Python bindings for libCEC. It opens a connection to the first CEC adapter it detects, registers itself on the HDMI CEC bus as a recording device named pyLibCec, and then reads commands from standard input until told to quit.

It takes no command line arguments and has no configuration file. It exists to demonstrate the cec Python module and to serve as a starting point for scripts of your own; for day to day use of a CEC adapter see cec-client(1), which offers rather more.

All libCEC log messages at level traffic and above are printed as they arrive, as are key presses and incoming CEC commands.

COMMANDS
Commands are typed at the Enter command: prompt and are case insensitive.

self
    List the logical addresses libCEC has claimed on the bus. The active source, if it is one of them, is marked with an asterisk.

as, activesource
    Broadcast an active source message, making this device the active source.

standby
    Put all devices on the bus into standby.

scan
    Scan the bus and print, for every device found, its logical and physical address, vendor, CEC version, OSD name, power status, and whether it is the active source.

tx bytes
    Transmit a raw CEC frame. bytes is a colon separated list of hexadecimal octets, the first of which carries the source and destination logical addresses, for example tx 10:04 to send an image view on to the TV.

q, quit
    Exit.

EXIT STATUS
pyCecClient exits 0 once the command loop ends. It also exits 0 when no adapter is found or when the adapter cannot be opened, printing a diagnostic first.

FILES

/usr/lib/python3/dist-packages/cec.py
    The Python bindings this program demonstrates, provided by the python3-libcec package.

SEE ALSO
cec-client(1)

The libCEC API documentation is published at https://pulse-eight.github.io/libcec/.

AUTHOR
libCEC and its Python example are Copyright (C) 2011-2015 Pulse-Eight Limited.

This manual page was written for the Debian project, and may be used by others.