aboutsummaryrefslogtreecommitdiff
path: root/docs/README.Ubuntu.md
diff options
context:
space:
mode:
authorJay Linski <jaylinski@users.noreply.github.com>2020-03-11 16:52:21 +0100
committerJakob Linskeseder <jakob.linskeseder@gmail.com>2020-03-21 16:07:37 +0100
commit60e457c2ed38fb843f10078063d86e08355aa34d (patch)
tree53453348f6317f41778858f67def423756d71868 /docs/README.Ubuntu.md
parent04fb376913d0a4f7d8b7fb5c371706f5a03beeaa (diff)
Add section on Meson and nasm build dependency in Ubuntu
In order to build dav1d (used as AV1 decoder in ffmpeg), an up-to-date Meson and nasm package is required. dav1d currently requires at least meson >= 0.47.0 and nasm >= 2.14: https://code.videolan.org/videolan/dav1d/-/blob/0.6.0/meson.build#L31 Since Ubuntu 18.04 ships with meson 0.45.1 and nasm 2.13.02, Meson and nasm have to be updated manually. Support for AV1 was added in #16933. Relates to https://github.com/xbmc/xbmc/pull/16933#issuecomment-597366773.
Diffstat (limited to 'docs/README.Ubuntu.md')
-rw-r--r--docs/README.Ubuntu.md25
1 files changed, 24 insertions, 1 deletions
diff --git a/docs/README.Ubuntu.md b/docs/README.Ubuntu.md
index 4411b27c81..6055c9ebf4 100644
--- a/docs/README.Ubuntu.md
+++ b/docs/README.Ubuntu.md
@@ -10,7 +10,8 @@ Several other distributions have **[specific build guides](README.md)** and a ge
2. **[Get the source code](#2-get-the-source-code)**
3. **[Install the required packages](#3-install-the-required-packages)**
3.1. **[Get build dependencies automagically](#31-get-build-dependencies-automagically)**
- 3.2. **[Get build dependencies manually](#32-get-build-dependencies-manually)**
+ 3.2. **[Get build dependencies manually](#32-get-build-dependencies-manually)**
+ 3.3. **[Ubuntu <= 18.04](#33-ubuntu--1804)**
4. **[Build Kodi](#4-build-kodi)**
## 1. Document conventions
@@ -147,6 +148,28 @@ sudo apt install doxygen libcap-dev libsndio-dev libmariadbd-dev
**[back to top](#table-of-contents)**
+### 3.3 Ubuntu <= 18.04
+Ubuntu 18.04 and lower ship an outdated [Meson](https://mesonbuild.com/) and [nasm](https://nasm.us/) package.
+In order to compile Kodi with AV1 support, you have to manually update both Meson and nasm.
+
+> This is a requirement by the [dav1d](https://code.videolan.org/videolan/dav1d) AV1 decoder used in ffmpeg.
+
+#### Meson
+```
+pip3 install --user meson
+```
+
+Make sure `~/.local/bin` is in your PATH.
+
+Verify your Meson version by running `meson -v`. The version displayed should be >= 0.47.0.
+
+#### nasm (x86_64 / amd64)
+```
+wget https://mirrors.edge.kernel.org/ubuntu/pool/universe/n/nasm/nasm_2.14-1_amd64.deb && sudo apt install ./nasm_2.14-1_amd64.deb
+```
+
+Verify your nasm version by running `nasm -v`. The version displayed should be >= 2.14.
+
## 4. Build Kodi
See the general **[Linux build guide](README.Linux.md)** for reference.