XmlTV - Bindings - OpenHAB

Download Documentation Add-ons Community Blog About About
  • Get Involved

    • Who We Are
    • Contribute
    • Events
  • Support openHAB

    • Foundation (opens new window)
    • Donate
  • Resources

    • Showcase/How-tos
    • Privacy Policy
    • Trademark Policy
    • Artwork
    • Feed Overview
    • myopenHAB (opens new window)
GitHub (opens new window)
  • Stable (4.2.3)
  • Latest (4.3.0)
Archived
  • 4.1
  • 4.0
  • 3.4
  • 3.3
  • 3.2
  • 3.1
  • 3.0
  • 2.5
  • Bindings

    • ABB/Busch-free@home Smart Home binding
    • Adorne
    • aha Waste Collection
    • Air Quality
    • air-Q
    • AirGradient
    • AirVisual Node
    • Alarm Decoder
    • AllPlay
    • Amazon Dash Button
    • Amazon Echo Control
    • Amber Electric
    • Ambient Weather
    • AmpliPi
    • Android Debug Bridge
    • AndroidTV
    • Anel NET-PwrCtrl
    • Anthem
    • ArgoClima
    • Astro
    • Asuswrt
    • Atlona
    • Autelis Pool Control
    • Automower
    • AVM FRITZ!
    • aWATTar
    • Belkin Wemo
    • BenQ Projector
    • BigAssFan
    • Bluetooth
    • Bond Home
    • Bosch Indego
    • Bosch Smart Home
    • Bose SoundTouch
    • Broadlink
    • BSB-LAN
    • BTicinoSmarther
    • Buienradar
    • C-Bus
    • Caddx
    • ChatGPT
    • Chromecast
    • Cm11a (X10 controller)
    • ComfoAir
    • CoolMasterNet
    • CoronaStats
    • D-Link Smart Home
    • Daikin
    • DALI
    • DanfossAirUnit
    • DBQuery
    • deCONZ
    • Denon / Marantz
    • Denon HEOS
    • Deutsche Bahn
    • Digiplex/EVO
    • digitalSTROM
    • DMX
    • DolbyCP
    • Dominoswiss
    • Doorbird
    • Drayton Wiser
    • DSC Alarm
    • DSMR
    • DWD Pollenflug
    • DWD Unwetter
    • Easee
    • EchonetLite
    • Ecobee
    • EcoTouch
    • Ecovacs
    • Ecowatt
    • ekey
    • ElectroluxAir
    • Elero Transmitter Stick
    • ELRO Connects
    • Emotiva
    • Energi Data Service
    • Enigma2
    • EnOcean
    • Enphase
    • EnturNo
    • Ephemeris
    • Epson Projector
    • Etherrain
    • evcc
    • evohome
    • Exec
    • Feed
    • Feican
    • Fine Offset Weather Station
    • Flic Button
    • FMI Weather
    • FolderWatcher
    • Folding@home
    • Foobot
    • Freebox
    • FreeboxOS
    • Freecurrency
    • French Government Energy Data
    • Fronius
    • FS Internet Radio
    • FTP Upload
    • Gardena
    • GCE
    • Gembird energenie
    • Generac MobileLink
    • GlobalCache
    • Go-eCharger
    • Govee Lan-API
    • GPIO
    • GPSTracker
    • GREE
    • GridBox
    • GROHE ONDUS
    • Groupe PSA
    • Growatt
    • Guntamatic
    • Haas Sohn Pellet Stove
    • HAI by Leviton OmniLink
    • Hayward Omnilogic
    • HCC Rubbish Collection
    • HDanywhere
    • Helios
    • HeliosVentilation
    • Herzborg
    • Home Connect
    • Homematic
    • HomeWizard
    • HP Printer
    • HTTP
    • Hunter Douglas (Luxaflex) PowerView
    • Hydrawise
    • Hyperion
    • Iammeter
    • iAquaLink
    • iCalendar
    • iCloud
    • IHC / ELKO
    • Insteon
    • Intesis
    • IoTaWatt
    • IP Camera
    • IpObserver
    • IPP
    • iRobot
    • IRtrans
    • Ism8
    • Jablotron Alarm
    • Jeelink
    • Jellyfin
    • JuiceNet
    • Kaleidescape
    • Keba
    • KM200
    • KNX
    • Kodi
    • Konnected
    • Kostal Inverter
    • KVV
    • LaMetric
    • LCN
    • Leap Motion
    • LG HomBot
    • LG TV control using serial protocol
    • LG webOS
    • LIFX
    • Linky
    • Linux Input
    • LiquidCheck
    • LIRC
    • LIVISI SmartHome
    • Log Reader
    • Logitech Harmony Hub
    • Loxone
    • Lutron
    • Luxom
    • LuxtronikHeatpump
    • MagentaTV
    • Mail
    • MAX!
    • MCD
    • MCP23017
    • MEATER
    • MecMeter
    • MELCloud
    • MercedesMe
    • Meteo Alerte
    • meteoblue
    • Meteostick
    • MfFan
    • Miele Cloud
    • Miele@home
    • Mikrotik RouterOS
    • Milight/Easybulb/Limitless
    • Millheat
    • Minecraft
    • Modbus
    • Monoprice Whole House Audio
    • MPD
    • MQTT
    • MyBMW
    • Mycroft
    • MyNice
    • myStrom
    • Nanoleaf
    • Neato
    • NEEO
    • NeoHub
    • Nest
    • Netatmo
    • Network
    • Network UPS Tools
    • Nibe Heatpump
    • NibeUplink
    • Niko Home Control
    • Nikobus
    • NoboHub
    • NovaFineDust
    • NTP
    • Nuki
    • Nuvo Grand Concerto & Essentia G
    • NZ Water Alerts
    • Oceanic
    • OJElectronics
    • Omnik Inverter
    • OneBusAway
    • OneWire
    • OneWire GPIO
    • Onkyo
    • OpenGarage
    • OpenSprinkler
    • OpenTherm Gateway
    • OpenUV
    • OpenWeatherMap
    • OpenWebNet (BTicino/Legrand)
    • Oppo Blu-ray player
    • Orbit B-hyve
    • Orvibo
    • Panasonic Blu-ray Player
    • Paradox Alarm System binding
    • PegelOnline
    • Pentair Pool
    • PHC
    • Philips Hue
    • Philips Somneo
    • pilight
    • Pioneer AVR
    • Pixometer
    • PJLink
    • PLCLogo
    • PLEX
    • Plugwise
    • PlugwiseHA
    • Powermax
    • PPC SMGW
    • ProteusEcoMeter
    • Prowl
    • Public Transport Switzerland
    • Pulseaudio
    • Pushbullet
    • Pushover
    • Pushsafer
    • Qbus
    • Qolsys IQ
    • Radio Browser
    • RadioThermostat
    • RegoHeatPump
    • Remote openHAB
    • Renault
    • Resol
    • Revogi
    • RFXCOM
    • RME
    • Robonect
    • Roku
    • Rotel
    • Russound
    • Sager Weathercaster
    • SAICiSMART
    • Salus
    • Samsung Smartthings
    • Samsung TV
    • Satel Integra Alarm System
    • SEMSPortal
    • Senec Home
    • Seneye
    • senseBox
    • Sensibo
    • SensorCommunity
    • Serial
    • Serial Button
    • Shelly
    • Siemens RDS
    • SiemensHVAC
    • Silvercrest Wifi Plug
    • Sinopé
    • SleepIQ
    • SMA Energy Meter
    • SmartMeter
    • Smhi
    • SMSModem
    • SNCF
    • SNMP
    • Solar-Log
    • SolarEdge
    • SolarForecast
    • SolarMax
    • Solarwatt
    • Solax
    • Somfy myLink
    • Somfy Tahoma
    • Somfy URTSI II
    • Sonnen
    • Sonos
    • Sony PlayStation
    • SonyAudio
    • SonyProjector
    • Souliss
    • Speedtest
    • Spotify
    • Squeezebox
    • Sure Petcare
    • Synop Analyzer
    • Systeminfo
    • TA C.M.I.
    • tado°
    • Tankerkönig
    • TapoControl
    • TasmotaPlug
    • Telegram
    • Teleinfo
    • Tellstick
    • Tesla
    • TeslaPowerwall
    • The Weather Company
    • Tibber
    • TiVo
    • TouchWand
    • TP-Link Smart Home
    • tplinkrouter
    • TR-064
    • TRÅDFRI
    • UniFi
    • UnifiedRemote
    • UPB
    • UpnpControl
    • ValloxMV
    • Vektiva
    • Velbus
    • Velux
    • Venstar Thermostat
    • VentaAir
    • Verisure
    • VeSync
    • Video Disk Recorder (VDR)
    • VigiCrues
    • Vitotronic
    • Vizio
    • Volumio
    • VolvoOnCall
    • Warmup
    • WeatherUnderground
    • WebexTeams
    • WebThing
    • WiFi LED
    • Windcentrale
    • WlanThermo
    • WLED
    • Wolf Smartset
    • Wunderground Update Receiver
    • X
    • Xiaomi Mi Smart Home
    • Xiaomi Wifi devices (Mi IO)
    • XmlTV
    • XMPPClient
    • Yamaha MusicCast
    • Yamaha Receiver
    • Yeelight
    • YIOremote
    • Z-Way
    • ZigBee
    • ZoneMinder
    • ZWave
  • System Integrations

  • Automation

  • Data Persistence

  • Data Transformation

  • Voice

  • User Interface

# XmlTV Binding

XMLTV is an XML based file format for describing TV listings. This format is often used by Home Theater software to produce their Electronic Program Guide (http://wiki.xmltv.org/index.php/Main_Page (opens new window))

The norm allows to separate program display from its building. The building of the XMLTV file itself is taken in charge by so called "grabbers" (http://wiki.xmltv.org/index.php/HowtoUseGrabbers (opens new window)).

Some websites provides updated XMLTV files than can be directly downloaded.

Here is a sample for France and Switzerland : https://xmltv.ch/ (opens new window)

This binding takes an XMLTV file as input and creates a thing for each channel contained in it. XmlTV channels are called Media Channels in this binding in order to avoid messing with openHAB Channels.

For each thing, you will be able to get information regarding the current program and the next to come.

# Supported Things

# Discovery

Once the XmlTV bridge to a file is created, you can add all known channels by searching new things.

# Binding Configuration

Configuration Parameter Required Description Default
filePath X Full path (including filename) to an Xml TV file
refresh X XMLTV file reload interval in hours 24h
encoding X XMLTV file encoding UTF8

# Thing Configuration

Configuration Parameter Required Description Default
channelId X Id of the channel as presented in the XmlTV file
offset X Offset applied to program times (forward or backward (minutes) 0
refresh X Refresh interval in seconds 60

# Channels

Channel Type ID Item Type Description
iconUrl String Channel Icon URL
icon Image Icon of the channel

# Current program (currentprog) Channels Group

Channel Type ID Item Type Description
progStart DateTime Program Start Time
progEnd DateTime Program End Time
progTitle String Program Title
progCategory String Program Category
progIconUrl String URL to an image of the program
icon Image Icon of the program
elapsedTime Number:Time Current time of currently playing program
remainingTime Number:Time Time remaining until end of the program
progress Number:Dimensionless Relative progression of the current program

# Next program (nextprog) Channels Group

Channel Type ID Item Type Description
progStart DateTime Program Start Time
timeLeft Number:Time Time left before program start
progEnd DateTime Program End Time
progTitle String Program Title
progCategory String Program Category
progIconUrl String URL to an image of the program
icon Image Icon of the program

# Full Example

# xmltv.things

Bridge xmltv:xmltvfile:france "XmlTV" @ "TV" [filePath="/etc/openhab/scripts/tvguide.xml"] { Thing channel france2 "France 2" @ "TV" [channelId="C4.api.telerama.fr", offset=0, refresh=60] }

# xmltv.items

String france2_title "Titre" {channel="xmltv:channel:france:france2:currentprog#progTitle"} Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

← Xiaomi Wifi devices (Mi IO) XMPPClient →

Từ khóa » Xmltv Ch