https://github.com/yrzr/kodi-docker-rk35xx
Running Kodi (GBM mode) on headless RK35XX devices with full hardware transcoding enabled
https://github.com/yrzr/kodi-docker-rk35xx
ffmpeg h264 h265 hwaccel kodi rk3588 rk3588s rk35xx
Last synced: 6 months ago
JSON representation
Running Kodi (GBM mode) on headless RK35XX devices with full hardware transcoding enabled
- Host: GitHub
- URL: https://github.com/yrzr/kodi-docker-rk35xx
- Owner: yrzr
- License: mit
- Created: 2024-12-04T11:39:11.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-02-04T05:21:15.000Z (8 months ago)
- Last Synced: 2025-04-13T03:17:42.448Z (6 months ago)
- Topics: ffmpeg, h264, h265, hwaccel, kodi, rk3588, rk3588s, rk35xx
- Language: Dockerfile
- Homepage: https://hub.docker.com/repository/docker/yrzr/kodi-gbm
- Size: 11.7 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kodi Docker RK35XX
This project provides a Docker container for running Kodi (GBM mode) on headless RK35XX devices with full **hardware transcoding** enabled.
Successfully tested hardware decoding and playback of H.264 1080p and H.265 4K HDR10 videos on Rock 5B and Rock 5C. Need more tests information from other devices.
- Source code: https://github.com/yrzr/gitlab-ce-arm64v8-docker
- Docker image: https://hub.docker.com/repository/docker/yrzr/kodi-gbm
## Prerequisites
- RK35XX devices with video output capability;
- Rockchip BSP/Vendor kernel 5.10 or 6.1 are need for [ffmpeg-rockchip](https://github.com/nyanmisaka/ffmpeg-rockchip);
- Docker installed on your system;
- Docker Compose (optional, for easier management).
## Getting Started
### Option A. Use docker run command
```bash
docker run -d \
--name kodi-gbm \
--privileged \
--network host \
--restart unless-stopped \
-e WEBSERVER_ENABLED=true \
-e WEBSERVER_PORT=8080 \
-e WEBSERVER_AUTHENTICATION=true \
-e WEBSERVER_USERNAME=kodi \
-e WEBSERVER_PASSWORD=kodi \
-v /etc/localtime:/etc/localtime:ro \
-v /media:/media:ro \
-v /path/to/kodi/data:/usr/local/share/kodi/portable_data \
yrzr/kodi-gbm:rk35xx
```
### Option B. Use docker compose
Checkout the project.
```bash
git clone --depth=1 https://github.com/yrzr/kodi-docker-rk35xx.git
cd kodi-docker-rk35xx
```
Then modify `compose.yml` and start container with docker compose
```bash
edit compose.yml
docker compose up -d
```
### Option C. Build the docker image by your own
Checkout the project.
```bash
git clone --depth=1 https://github.com/yrzr/kodi-docker-rk35xx.git
cd kodi-docker-rk35xx
```
Build the image
```bash
docker compose build
```
Bring up the container
```bash
docker compose up -d
```
## Environment Variables
- WEBSERVER_ENABLED
Whether allow control of Kodi via HTTP
- WEBSERVER_PORT
The port of Webserver
- WEBSERVER_AUTHENTICATION
Whether to use HTTP's Basic Access Authentication
- WEBSERVER_USERNAME
The username of the webserver access authentication
- WEBSERVER_PASSWORD
The password of the webserver access authentication
## Known issue
### Unable to see the OSD while playing a movie
See the issue [here](https://github.com/Joshua-Riek/ubuntu-rockchip/issues/89) and dirty fix [here](https://forum.armbian.com/topic/25957-guide-kodi-on-orange-pi-5-with-gpu-hardware-acceleration-and-hdmi-audio/page/6/#comment-172924)
You can also do the fix manually with the following steps.
- install `device-tree-compiler`
```bash
apt-get update
apt-get install device-tree-compiler
```
- find the dtb file of your machine
It usually located at `/boot/dtbs/{your kernel version}/rockchip/rk3588{s}-{your machine model}.dtb`, for example it is `/boot/dtbs/6.1.75-vendor-rk35xx/rockchip/rk3588s-rock-5c.dtb` for my Rock 5C. Then backup the original dtb file.
```bash
cd /boot/dtbs/6.1.75-vendor-rk35xx/rockchip/
cp -v rk3588s-rock-5c.dtb rk3588s-rock-5c.dtb.bak
```
- extract dtc source file from dtb file
```bash
dtc -I dtb -O dts -o rk3588s-rock-5c.dtc rk3588s-rock-5c.dtb
```
- edit your dtc file and comment out `plane-mask` and `primary-plane`
```txt
...
// rockchip,plane-mask = <0x05>;
// rockchip,primary-plane = <0x02>;
...
```
- compile dts source file to dtb file
```bash
dtc -I dts -O dtb -o rk3588s-rock-5c.dtb rk3588s-rock-5c.dts
```
- reboot the system
```bash
reboot
```
## Contributing
Contributions are welcome! Please open an issue or submit a pull request.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Acknowledgements
- [ffmpeg-rockchip](https://github.com/nyanmisaka/ffmpeg-rockchip) - FFmpeg with async and zero-copy Rockchip MPP & RGA support.