jesmann/gracenote2xml repository overview

Updated 7/18/2025 and working

gracenote2xml
Docker container for gracenote2xml
Update from zap2xml

This is gracenote2xml with Environment Variables driving the configuration. By default it runs every 12 hours to update your EPG data from gracenote. This container will take a second account for gracenote and will merge the received xml files into one using tv_merge.

Quick Run

docker run -d --name jesmann/gracenote2xml -v /xmltvdata:/data -e [email protected] -e PASSWORD=**password** -e OPT_ARGS="-I -D -a" -e [email protected] -e PASSWORD2=**secondpassword** -e OPT_ARGS2="-I -D" -e XMLTV_FILENAME=xmltv.xml 

jesmann/gracenote2xml
Environment Settings
You can configure the following environment variables below:

Required
USERNAME - zap2it.com/gracenote username
PASSWORD - zap2it.com/gracenote password
Optional
OPT_ARGS - additional command line arguments for zap2xml
USERNAME2 - Second zap2it.com/gracenote username
PASSWORD2 - Second zap2it.com/gracenote password
OPT_ARGS2 = additional command line arguments for zap2xml for the second username
XMLTV_FILENAME - filename for your xmltv file (default: xmltv.xml)
SLEEPTIME - time in seconds to wait before next run (default: 43200)


example dockercompose

version: '3'



services:

  gracenote2xml:

    image: jesmann/gracenote2xml:latest

    container_name: gracenote2xml

    restart: always

    volumes:

        - /xmltvdata:/data

    environment:

        - USERNAME=email # from tvlistings.gracenote.com/grid-affilates.hyml?gapzap (or zap2it)

        - PASSWORD=**password**

        - OPT_ARGS= # optional see zap2xml setup

        - USERNAME2=email #optional 2nd account

        - PASSWORD2=**password** # optional 2nd account

        - OPT_ARGS2=

        - XMLTV_FILENAME=guide.xml # optional xmltv.xml is default