2017-10-26 21:20:01 +00:00
|
|
|
|
= OpenH264
|
2023-08-08 09:25:28 +00:00
|
|
|
|
Caleb McKee
|
|
|
|
|
|
:revnumber: unknown
|
|
|
|
|
|
:revdate: 2021-06-04
|
|
|
|
|
|
:category: Applications
|
2023-08-28 20:44:35 +00:00
|
|
|
|
:tags: How-to, Multimedia
|
2023-08-08 09:25:28 +00:00
|
|
|
|
|
|
|
|
|
|
[abstract]
|
|
|
|
|
|
This page contains information on the Cisco
|
|
|
|
|
|
https://www.openh264.org/[OpenH264] codec.
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
|
2023-08-08 09:25:28 +00:00
|
|
|
|
== Background
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cisco provides an OpenH264 codec (as a source and a binary), which is
|
|
|
|
|
|
their of implementation H.264 codec, and they cover all licensing fees
|
|
|
|
|
|
for all parties using their binary. This codec allows you to use H.264
|
|
|
|
|
|
in WebRTC with gstreamer and Firefox. It does *not* enable generic H.264
|
2020-10-10 04:26:01 +00:00
|
|
|
|
playback, only WebRTC (see link:https://bugzilla.mozilla.org/show_bug.cgi?id=1057646[Mozilla bug 1057646]).
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
The code source is available at https://github.com/cisco/openh264 under
|
|
|
|
|
|
a BSD license. The binary is released under this agreement from Cisco:
|
2021-02-02 11:30:52 +00:00
|
|
|
|
https://www.openh264.org/BINARY_LICENSE.txt
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
Upstream Firefox versions download and install the OpenH264 plugin by
|
|
|
|
|
|
default automatically. Due to it's binary nature, Fedora disables this
|
|
|
|
|
|
automatic download.
|
|
|
|
|
|
|
2023-08-08 09:25:28 +00:00
|
|
|
|
== Installation from fedora-cisco-openh264 repository
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
A `fedora-cisco-openh264` repository is distributed since Fedora 24 by
|
|
|
|
|
|
default (if you have at least `fedora-repos-24-0.5` package or newer).
|
|
|
|
|
|
It contains OpenH264 binary link:Non-distributable-rpms[built inside the
|
|
|
|
|
|
Fedora infrastructure], but distributed by Cisco, so that the all
|
|
|
|
|
|
licensing fees are still covered by them. This repository also contains
|
|
|
|
|
|
OpenH264 plugins for gstreamer and Firefox. It is disabled by default.
|
|
|
|
|
|
In order to install OpenH264, you first need to enable it:
|
|
|
|
|
|
|
|
|
|
|
|
....
|
|
|
|
|
|
$ sudo dnf config-manager --set-enabled fedora-cisco-openh264
|
|
|
|
|
|
....
|
|
|
|
|
|
|
|
|
|
|
|
and then install the plugins:
|
|
|
|
|
|
|
|
|
|
|
|
....
|
|
|
|
|
|
$ sudo dnf install gstreamer1-plugin-openh264 mozilla-openh264
|
|
|
|
|
|
....
|
|
|
|
|
|
|
|
|
|
|
|
Afterwards you need open Firefox, go to menu -> Add-ons -> Plugins and
|
|
|
|
|
|
enable OpenH264 plugin.
|
|
|
|
|
|
|
|
|
|
|
|
You can do a simple test whether your H.264 works in RTC on
|
|
|
|
|
|
https://mozilla.github.io/webrtc-landing/pc_test.html[this page] (check
|
|
|
|
|
|
_Require H.264 video_).
|
|
|
|
|
|
|
2023-08-08 09:25:28 +00:00
|
|
|
|
== Manual install of binary
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
2021-02-02 11:30:52 +00:00
|
|
|
|
* View and agree to the https://www.openh264.org/BINARY_LICENSE.txt
|
2017-10-26 21:20:01 +00:00
|
|
|
|
* Download the appropriate binary for your system here:
|
2020-04-18 21:27:08 +00:00
|
|
|
|
https://github.com/cisco/openh264/releases
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
Example installation for version 1.1:
|
|
|
|
|
|
|
2020-10-10 04:26:01 +00:00
|
|
|
|
....
|
2021-02-02 11:30:52 +00:00
|
|
|
|
wget http://ciscobinary.openh264.org/openh264-linux64-v1.1-Firefox33.zip +
|
2020-10-10 04:26:01 +00:00
|
|
|
|
mkdir -p ~/.mozilla/firefox/<yourprofile>/gmp-gmpopenh264/1.1/ +
|
|
|
|
|
|
cd ~/.mozilla/firefox/<yourprofile>/gmp-gmpopenh264/1.1/ +
|
|
|
|
|
|
unzip ~/openh264-linux64-v1.1-Firefox33.zip
|
|
|
|
|
|
....
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
2023-08-08 09:25:28 +00:00
|
|
|
|
== Firefox config changes
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
2023-08-08 09:25:28 +00:00
|
|
|
|
Type about:config into the Firefox address/URL field and accept the warning.
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
* From the Search field type in 264 and a handful of options will
|
2020-04-18 21:27:08 +00:00
|
|
|
|
appear. Give the following Preference Names a value of true by
|
|
|
|
|
|
double-clicking on false:
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
2020-10-10 04:26:01 +00:00
|
|
|
|
....
|
|
|
|
|
|
media.gmp-gmpopenh264.autoupdate
|
|
|
|
|
|
media.gmp-gmpopenh264.enabled
|
|
|
|
|
|
media.gmp-gmpopenh264.provider.enabled
|
|
|
|
|
|
media.peerconnection.video.h264_enabled
|
|
|
|
|
|
....
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
* Restart Firefox
|
|
|
|
|
|
* After restarting, the following string in about:config will change to
|
2020-04-18 21:27:08 +00:00
|
|
|
|
the current version that has been installed from the web:
|
2020-10-10 04:26:01 +00:00
|
|
|
|
|
|
|
|
|
|
....
|
|
|
|
|
|
media.gmp-gmpopenh264.version
|
|
|
|
|
|
....
|
2017-10-26 21:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
See a typo, something missing or out of date, or anything else which can be
|
2017-11-10 15:16:19 +00:00
|
|
|
|
improved? Edit this document at https://pagure.io/fedora-docs/quick-docs.
|
