{"id":19742702,"url":"https://github.com/lapicidae/vdr-epg-daemon","last_synced_at":"2025-02-27T23:22:25.885Z","repository":{"id":40477975,"uuid":"256588402","full_name":"lapicidae/vdr-epg-daemon","owner":"lapicidae","description":"VDR EPG Daemon docker image based on debian or Ubuntu","archived":false,"fork":false,"pushed_at":"2025-02-14T05:16:56.000Z","size":157,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-14T06:25:54.915Z","etag":null,"topics":["docker-image"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lapicidae.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-17T19:10:16.000Z","updated_at":"2025-02-14T05:16:59.000Z","dependencies_parsed_at":"2023-02-13T00:01:04.595Z","dependency_job_id":"3d6e6b0b-29de-4c85-9db7-e6ee6dc931c7","html_url":"https://github.com/lapicidae/vdr-epg-daemon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapicidae%2Fvdr-epg-daemon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapicidae%2Fvdr-epg-daemon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapicidae%2Fvdr-epg-daemon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lapicidae%2Fvdr-epg-daemon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lapicidae","download_url":"https://codeload.github.com/lapicidae/vdr-epg-daemon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241072678,"owners_count":19904824,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-image"],"created_at":"2024-11-12T01:33:16.533Z","updated_at":"2025-02-27T23:22:25.856Z","avatar_url":"https://github.com/lapicidae.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![epgd](epgd-logo.svg)](https://github.com/vdr-projects/vdr-epg-daemon)\n\nepgd - a EPG daemon which fetches the EPG and additional data from various sources (like epgdata, eplists.constabel.net, ...) and provide it to the [epg2vdr](https://github.com/horchi/vdr-plugin-epg2vdr) plugin via a database (MariaDB or MySQL).  \nThe epgd obtains the EPG from the sources by plugins. A plugin for [epgData](https://www.epgdata.com), [tvm](https://github.com/3PO/epgd-plugin-tvm/) and [tvsp](https://github.com/chriszero/epgd-plugin-tvsp) is contained.  \nIt is designed to handle large amount of data and pictures in a distributed environment with one epg-server and many possible vdr-clients.\n\n\n# [lapicidae/vdr-epg-daemon](https://github.com/lapicidae/vdr-epg-daemon)\n\n[![GitHub Repo stars](https://img.shields.io/github/stars/lapicidae/vdr-epg-daemon?color=3c0e7b\u0026logo=github\u0026logoColor=fff\u0026style=for-the-badge)](https://github.com/lapicidae/vdr-epg-daemon)\n[![Docker Pulls](https://img.shields.io/docker/pulls/lapicidae/vdr-epg-daemon?color=3c0e7b\u0026label=pulls\u0026logo=docker\u0026logoColor=fff\u0026style=for-the-badge)](https://hub.docker.com/r/lapicidae/vdr-epg-daemon)\n[![Docker Stars](https://img.shields.io/docker/stars/lapicidae/vdr-epg-daemon?color=3c0e7b\u0026label=stars\u0026logo=docker\u0026logoColor=fff\u0026style=for-the-badge)](https://hub.docker.com/r/lapicidae/vdr-epg-daemon)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/lapicidae/vdr-epg-daemon/docker.yml?logo=github\u0026logoColor=ffffff\u0026style=for-the-badge)](https://github.com/lapicidae/vdr-epg-daemon/actions/workflows/docker.yml)\n\nVDR EPG Daemon docker image based on [debian](https://hub.docker.com/_/debian) or [Ubuntu](https://hub.docker.com/_/ubuntu) and [s6-overlay](https://github.com/just-containers/s6-overlay).\n\n\n## Features\n\n* regular and timely application updates\n* easy user mappings (PGID, PUID)\n* integrated [tvm](https://github.com/3PO/epgd-plugin-tvm/) and [tvsp](https://github.com/chriszero/epgd-plugin-tvsp) plugin\n* epghttpd webinterface (including mostly german station logos)\n* eMail notifications via [msmtprc](https://marlam.de/msmtp) - a very simple and easy to use SMTP client\n* log to file with built-in log rotation\n\n### *Note*\nThe images are automatically rebuilt when any of the following sources receive an update:\n\n* [debian](https://hub.docker.com/_/debian) Official Docker Image - stable-slim\n* [Ubuntu](https://hub.docker.com/_/ubuntu) Official Docker Image - latest\n* [vdr-epg-daemon](https://github.com/horchi/vdr-epg-daemon) GitHub repository\n* [epgd-plugin-tvm](https://github.com/3PO/epgd-plugin-tvm) GitHub repository\n* [epgd-plugin-tvsp](https://github.com/chriszero/epgd-plugin-tvsp) GitHub repository\n\n\n## Getting Started\n\n### Dependencies\n\nA MariaDB or MySQL server with integrated [epglv](https://github.com/vdr-projects/vdr-epg-daemon/blob/master/epglv/README) is required to store the epg details.  \nFor example, you can use the [mariadb-epglv](https://github.com/lapicidae/mariadb-epglv) docker image.\n\n### Usage\nHere are some example snippets to help you get started creating a container.\n\n#### *docker-compose (recommended)*\n\nCompatible with docker-compose v2 schemas.\n```yaml\nversion: \"2.1\"\nservices:\n  vdr-epg-daemon:\n    image: ghcr.io/lapicidae/vdr-epg-daemon:latest\n    container_name: vdr-epg-daemon\n    environment:\n      - PUID=1000\n      - PGID=1000\n      - TZ=Europe/London\n      - LANG=de_DE.UTF-8 #other languages are currently not supported\n    volumes:\n      - /path/to/cache:/epgd/cache\n      - /path/to/config:/epgd/config\n      - /path/to/epgimages:/epgd/epgimages\n      - /path/to/channellogos:/epgd/channellogos #optional\n      - /path/to/log:/epgd/log #optional\n    ports:\n      - 9999:9999\n    restart: unless-stopped\n```\n\n#### *docker cli*\n\n```bash\ndocker run -d \\\n  --name=vdr-epg-daemon \\\n  -e PUID=1000 \\\n  -e PGID=1000 \\\n  -e TZ=Europe/London \\\n  -e LANG=de_DE.UTF-8 `#other languages are currently not supported` \\\n  -p 9999:9999 \\\n  -v /path/to/cache:/epgd/cache \\\n  -v /path/to/config:/epgd/config \\\n  -v /path/to/epgimages:/epgd/epgimages \\\n  -v /path/to/channellogos:/epgd/channellogos `#optional` \\\n  -v /path/to/log:/epgd/log `#optional` \\\n  --restart unless-stopped \\\n  ghcr.io/lapicidae/vdr-epg-daemon:latest\n```\n\n### Parameters\n\nContainer images are configured using parameters passed at runtime.  \nThese parameters are separated by a colon and indicate `\u003cexternal\u003e:\u003cinternal\u003e` respectively.  \nFor example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.\n\n| Parameter | Function |\n| :----: | --- |\n| `-p 9999` | epghttpd Webinterface |\n| `-e PUID=1000` | for UserID - see below for explanation |\n| `-e PGID=1000` | for GroupID - see below for explanation |\n| `-e TZ=Europe/London` | Specify a [timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List) to use (e.g. Europe/London) |\n| `-e LANG=de_DE.UTF-8` | Default locale; see [list](https://sourceware.org/git/?p=glibc.git;a=blob_plain;f=localedata/SUPPORTED;hb=HEAD) (only `de_DE.UTF-8` is currently supported) |\n| `-e LOGO_INTERNAL=false` | Optional - Use your own station logos in `/epgd/channellogos` |\n| `-e LOGO_OVERWRITE=false` | Optional - Do not overwrite existing logos in `/epgd/channellogos` (only relevant if internal logos are used) |\n| `-e START_EPGHTTPD=false` | Optional - Disable webinterface (epghttpd) |\n| `-e RESTART_EPGD=true` | Optional - Restart epgd once at 3:30 AM after the start of the container |\n| `-e RESTART_EPGD_AT=3:30` | Optional - Change default restart time ([examples](https://www.ibm.com/docs/en/zos/2.5.0?topic=descriptions-run-command-specified-time)) |\n| `-e KNOCK_EPLISTS=false` | Optional - Disable connection ceck  |\n| `-e LOG2FILE=true` | Optional - Write log to file in `/epgd/log` |\n| `-v /epgd/config` | Config files |\n| `-v /epgd/epgimages` | EPG images for use in other plugins (e.g. [live plugin](https://github.com/MarkusEh/vdr-plugin-live)) |\n| `-v /epgd/cache` | Downloaded, temporary files |\n| `-v /epgd/channellogos`| TV station logos used in Webinterface |\n| `-v /epgd/log` | Logfiles if `LOG2FILE=true` |\n\n### User / Group Identifiers\n\nWhen using volumes (`-v` flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`.\n\nEnsure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.\n\nIn this instance `PUID=1234` and `PGID=4321`, to find yours use `id user` as below:\n\n```bash\n  $ id username\n    uid=1234(dockeruser) gid=4321(dockergroup) groups=4321(dockergroup)\n```\n\n\n## Thanks\n\n* **[VDR EPG Daemon Team](https://github.com/horchi/vdr-epg-daemon)**\n* **[Klaus Schmidinger (kls)](http://www.tvdr.de/)**\n* **[vdr-portal.de](https://www.vdr-portal.de/)**\n* **[just-containers](https://github.com/just-containers)**\n* **[linuxserver.io](https://www.linuxserver.io/)**\n* **...and all the forgotten ones**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flapicidae%2Fvdr-epg-daemon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flapicidae%2Fvdr-epg-daemon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flapicidae%2Fvdr-epg-daemon/lists"}