ironcast-cec 0.3.1

Python bindings for libcec

ironcast-cec - libcec bindings for Python

ironcast-cec is a fork of trainman419's python-cec under the same license, in order to allow features and maintenance to be added to the project for the use of the IronCast streaming software.

Installing:

Install dependencies

To build ironcast-cec, you need version 1.6.1 or later of the libcec development libraries:

On Gentoo:

sudo emerge libcec

On OS X:

brew install libcec

Ubuntu, Debian and Raspbian:

sudo apt-get install libcec-dev build-essential python-dev

Install from PIP

pip install cec

Installing on Windows

You need to build libcec from source, because libcec installer doesn't provide cec.lib that is necessary for linking.

Then you just need to set up your paths, e.g.:

set INCLUDE=path_to_libcec\build\amd64\include
set LIB=path_to_libcec\build\amd64

Getting Started

A simple example to turn your TV on:

import cec

cec.init()

adapter = cec.Adapter()
tv = cec.Device(adapter, cec.CECDEVICE_TV)
tv.power_on()

API

import cec

adapter_devs = cec.list_adapters() # may be called before init()
cec.init()

adapter = cec.Adapter() # use default adapter
# create an adapter using the specifed device, with the OSD name 'RPi TV' and play back device type
adapter = cec.Adapter(dev=adapter_dev, name='RPi TV', type=cec.CECDEVICE_PLAYBACKDEVICE1)

adapter.close() # close the adapter

adapter.add_callback(handler, events)

# the list of events is specified as a bitmask of the possible events:
cec.EVENT_LOG
cec.EVENT_KEYPRESS
cec.EVENT_COMMAND
cec.EVENT_CONFIG_CHANGE # not implemented yet
cec.EVENT_ALERT
cec.EVENT_MENU_CHANGED
cec.EVENT_ACTIVATED
cec.EVENT_ALL
# the callback will receive a varying number and type of arguments that are
# specific to the event. Contact me if you're interested in using specific
# callbacks

adapter.remove_callback(handler, events)

devices = adapter.list_devices()

class Device:
   __init__(id)
   is_on()
   power_on()
   standby()
   address
   physical_address
   vendor
   osd_string
   cec_version
   language
   is_active()
   set_av_input(input)
   set_audio_input(input)
   transmit(opcode, parameters)

adapter.is_active_source(addr)
adapter.set_active_source() # use default device type
adapter.set_active_source(device_type) # use a specific device type
adapter.set_inactive_source()  # not implemented yet

adapter.volume_up()
adapter.volume_down()
adapter.toggle_mute()
# TODO: audio status

adapter.set_physical_address(addr)
adapter.can_persist_config()
adapter.persist_config()
adapter.set_port(device, port)

# set arbitrary active source (in this case 2.0.0.0)
destination = cec.CECDEVICE_BROADCAST
opcode = cec.CEC_OPCODE_ACTIVE_SOURCE
parameters = b'\x20\x00'
adapter.transmit(destination, opcode, parameters)

Changelog

0.3.0 ( 2026-02-14 )

• Forked project to ironcast-cec
• Added retsyx's Adapter class, to be used instead of a global CEC context

0.2.8 ( 2022-01-05 )

• Add support for libCEC >= 5
• Windows support
• Support for setting CEC initiator
• Python 3.10 compatibility

0.2.7 ( 2018-11-09 )

• Implement cec.EVENT_COMMAND callback
• Fix several crashes/memory leaks related to callbacks
• Add possibility to use a method as a callback
• Limit maximum number of parameters passed to transmit()
• Fix compilation error with GCC >= 8

0.2.6 ( 2017-11-03 )

• Python 3 support ( @nforro )
• Implement is_active_source, set_active_source, transmit ( @nforro )
• libcec4 compatibility ( @nforro )

0.2.5 ( 2016-03-31 )

• re-release of version 0.2.4. Original release failed and version number is now lost

0.2.4 ( 2016-03-31 )

• libcec3 compatibility

0.2.3 ( 2014-12-28 )

• Add device.h to manifest
• Initial pip release

0.2.2 ( 2014-06-08 )

• Fix deadlock
• Add repr for Device

0.2.1 ( 2014-03-03 )

• Fix deadlock in Device

0.2.0 ( 2014-03-03 )

• Add initial callback implementation
• Fix libcec 1.6.0 backwards compatibility support

0.1.1 ( 2013-11-26 )

• Add libcec 1.6.0 backwards compatibility
• Known Bug: no longer compatible with libcec 2.1.0 and later

0.1.0 ( 2013-11-03 )

• First stable release

Copyright

Copyright (C) 2013 Austin Hendrix [e-mail]

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.