/qtile-widget-tvheadend

Qtile widget to display status of TVHeadend server and upcoming recordings

Primary LanguagePythonMIT LicenseMIT

TVHeadend

This module provides a simple widget showing the status (idle or recording of your TVHeadend server) and the upcoming recordings.

Demo

Here is a screenshot from my laptop showing the widget in the bar.

Screenshot

Indicators

When the server is recording a red line will be shown under the icon. If there's an error, a yellow line will show above the icon (and check the logs).

Installation

You can clone the repository and run:

python setup.py install

or, for Arch users, just copy the PKGBUILD file to your machine and build.

Configuration

Add the code to your config (~/.config/qtile/config.py):

from tvhwidget import TVHWidget
...
screens = [
    Screen(
        top=bar.Bar(
            [
                widget.CurrentLayout(),
                widget.GroupBox(),
                widget.Prompt(),
                widget.WindowName(),
                TVHWidget(),     
                widget.Clock(format='%Y-%m-%d %a %I:%M %p'),
                widget.QuickExit(),
            ],
            24,
        ),
    ),
]

Customising

You may need to add the host address and login details via the "host" and "auth" keywords.

The widget can be customised with the following arguments:

refresh_interval Time to update data
startup_delay Time before sending first web request
host TVHeadend server address
auth Auth details for accessing tvh. Can be None or tuple of (username, password)
tvh_timeout Seconds before timeout for timeout request
popup_format Upcoming recording text.
popup_display_timeout Seconds to show recordings.
warning_colour Highlight when there is an error.
recording_colour Highlight when TVHeadend is recording

Contributing

If you've used this (great, and thank you) you will find bugs so please file an issue.