{"id":24110530,"url":"https://github.com/ehough/docker-kodi","last_synced_at":"2025-04-06T23:17:29.330Z","repository":{"id":31412724,"uuid":"127813400","full_name":"ehough/docker-kodi","owner":"ehough","description":"Dockerized Kodi with audio and video","archived":false,"fork":false,"pushed_at":"2024-08-09T11:45:08.000Z","size":76,"stargazers_count":242,"open_issues_count":23,"forks_count":61,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-30T21:07:37.443Z","etag":null,"topics":["audio","docker","htpc","kodi","media","video"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/erichough/kodi/","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ehough.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/code-of-conduct.md","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":"2018-04-02T21:15:33.000Z","updated_at":"2025-03-14T23:05:34.000Z","dependencies_parsed_at":"2025-02-07T03:00:43.733Z","dependency_job_id":null,"html_url":"https://github.com/ehough/docker-kodi","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehough%2Fdocker-kodi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehough%2Fdocker-kodi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehough%2Fdocker-kodi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehough%2Fdocker-kodi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ehough","download_url":"https://codeload.github.com/ehough/docker-kodi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247563940,"owners_count":20958971,"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":["audio","docker","htpc","kodi","media","video"],"created_at":"2025-01-11T01:15:29.200Z","updated_at":"2025-04-06T23:17:29.309Z","avatar_url":"https://github.com/ehough.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile"],"sub_categories":[],"readme":"# erichough/kodi\n\nDockerized [Kodi](https://kodi.tv/) with audio and video.\n\n![Kodi screenshot](https://kodi.tv/sites/default/files/page/field_image/about--devices.jpg \"Kodi screenshot\")\n\n## Features\n\n* fully-functional [Kodi](https://kodi.tv/) installation in a [Docker](https://www.docker.com/) container\n* **audio** ([ALSA or PulseAudio](https://kodi.wiki/view/Linux_audio)) and **video** (with optional OpenGL hardware \n  video acceleration) via [x11docker](https://github.com/mviereck/x11docker/)\n* simple, Ubuntu-based image that adheres to the [official Kodi installation instructions](https://kodi.wiki/view/HOW-TO:Install_Kodi_for_Linux#Installing_Kodi_on_Ubuntu-based_distributions)\n* clean shutdown of Kodi when its container is terminated\n\n## Host Prerequisites\n\nThe host system will need the following:\n\n1. **Linux** and [**Docker**](https://www.docker.com)\n\n   This image should work on any Linux distribution with a functional Docker installation.\n   \n1. **A connected display and speaker(s)**\n\n   If you're looking for a headless Kodi installation, look elsewhere!\n\n1. **[X](https://www.x.org/) or [Wayland](https://wayland.freedesktop.org/)**\n\n   Ensure that the packages for an X or Wayland server are present on the Docker host. Please consult your distribution's \n   documentation if you're not sure what to install. A display server does *not* need to be running ahead of time.\n\n1. **[x11docker](https://github.com/mviereck/x11docker/)**\n\n   `x11docker` allows Docker-based applications to utilize X and/or Wayland on the host. Please follow the `x11docker` \n   [installation instructions](https://github.com/mviereck/x11docker#installation) and ensure that you have a \n   [working setup](https://github.com/mviereck/x11docker#examples) on the Docker host.\n       \n## Usage\n\n### Starting Kodi\n\nUse `x11docker` to start the `erichough/kodi` Docker image. Detailing the myriad of `x11docker` options is beyond the \nscope of this document; please consult the [`x11docker` documentation](https://github.com/mviereck/x11docker/) to find \nthe set of options that work for your setup.\n\nBelow is an example command (split into multiple lines for clarity) that starts Kodi with a fresh X.Org X server with\nPulseAudio sound, hardware video acceleration, a persistent Kodi home directory, and a shared read-only Docker mount for\nmedia files:\n\n    $ x11docker --xorg                                 \\\n                --pulseaudio                           \\\n                --gpu                                  \\\n                --homedir /host/path/to/kodi/home      \\\n                -- -v /host/path/to/media:/media:ro -- \\\n                erichough/kodi\n           \nNote that the optional argument passed between a pair of `--` defines additional arguments to be passed to `docker run`.\n\n### Stopping Kodi\n\nYou can shut down Kodi just as you normally would; i.e. by using the power menu from the Kodi home screen. \nBehind the scenes, the Docker container and `x11docker` processes will terminate cleanly.\n\nYou can also [terminate the container from the command line](doc/advanced.md#command-line-shutdown).\n\n### Example systemd Service Unit\n\n    [Unit]\n    Description=Dockerized Kodi\n    Requires=docker.service\n    After=network.target docker.service\n    \n    [Service]\n    ExecStartPre=/usr/bin/docker pull erichough/kodi\n    ExecStart=/usr/bin/x11docker ... erichough/kodi\n    Restart=always\n    KillMode=process\n    \n    [Install]\n    WantedBy=multi-user.target\n\n## Advanced\n\nThe [advanced topics](doc/advanced.md) documentation describes a few more useful features and functionality:\n\n * [Custom add-ons](doc/advanced.md#custom-add-ons)\n * [Image Variants](doc/advanced.md#image-variants)\n * [Custom Startup Behavior](doc/advanced.md#custom-startup-behavior)\n * [Command-Line Shutdown](doc/advanced.md#command-line-shutdown)\n\n## Help!\n\nSomething not working quite right? Are you stuck? Please ask your questions in the\n[discussion group](https://github.com/ehough/docker-kodi/discussions), where we exchange help and share ideas.\n\n## Contributing\n\nConstructive criticism and contributions are welcome! Please \n[submit an issue](https://github.com/ehough/docker-kodi/issues/new) or \n[pull request](https://github.com/ehough/docker-kodi/compare).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehough%2Fdocker-kodi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fehough%2Fdocker-kodi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehough%2Fdocker-kodi/lists"}