DISCONTINUATION OF PROJECT

This project will no longer be maintained by Intel.
Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
Intel no longer accepts patches to this project.
If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.

libyami

Yet Another Media Infrastructure.

It is YUMMY to your video experience on Linux like platform.

Yami is core building block for media solution. it parses video stream

and decodes them leverage hardware acceleration.

• Copyright (c) 2010, The WebM Project authors.

• Copyright (C) 2011-2018 Intel Corporation

• Copyright (C) 2015-2016 Alibaba

License

libyami libraries are available under the terms of the

Apache License 2.0

Overview

libyami consists of several libraries:

• codecparsers: it is bit stream parser,
• common: common objects/operation to work with vaapi (hw acceleration interface)
• decoder: video decoder implementation
• encoder: video encoder implementation
• vpp: video post process implementation

Features

• MPEG-2, VC-1, WMV 9 (WMV3), H.264, HEVC (H.265), VP8, VP9, and JPEG ad-hoc decoders
• H.264, HEVC (H.265), VP8, VP9, and JPEG ad-hoc encoders
• Sharpening, Denoise, Deinterlace, Hue, Saturation, Brightness, Contrast, CSC and scaling

Requirements

Hardware requirements

• Intel Sandybridge, Ivybridge, Haswell, Broadwell, Skylake, Kaby Lake (HD Graphics)
• Intel Bay Trail, Braswell, Apollo Lake, Gemini Lake

Sources

Git repository for work-in-progress changes is available at:

https://github.com/01org/libyami

Demos, Examples and Test Applications

The libyami-utils project provides various example, test and demo applications that use libyami. For more details, please refer to

https://github.com/01org/libyami-utils

Simple api demo application

https://github.com/01org/libyami-utils/blob/master/examples/simpleplayer.cpp

FFmpeg integration

You can refer to https://github.com/01org/ffmpeg_libyami for FFmpeg integration.

You can report FFmpeg related issue to https://github.com/01org/ffmpeg_libyami/issues

Build instructions

https://github.com/01org/libyami/wiki/Build

Docs

http://01org.github.io/libyami_doxygen/index.html

Testing

Unit Tests

The gtest framework library https://github.com/google/googletest is required in order to write and compile unit tests in libyami. To make it convenient to use, we add gtest source to subdirectory gtestsrc. The gtest documentation can be found in their source tree under docs (online or in the subdirectory gtestsrc).

To build gtest and enable the unit tests, when configuring libyami you need to specify:

--enable-tests

Contributing

Create pull request at https://github.com/01org/libyami/compare

Code style

https://github.com/01org/libyami/wiki/Coding-Style

Review process

Create pull requests at https://github.com/01org/libyami/compare

We highly recommend that unit tests accompany your contributed patches. See "Testing" section above. However, we do understand that not everything can be tested by a unit test. So use your best judgement to determine if a unit test is appropriate for your contribution. The maintainer(s) reserve the right to refuse submission's without unit tests, when reasonable, or if a submission causes existing unit tests to regress.

Mail list

[email protected]

Reporting Bugs

Bugs can be reported in the github system at:

https://github.com/01org/libyami/issues/new

Reporting a security issue

Please mail to [email protected] directly for security issue

FAQ

https://github.com/01org/libyami/wiki/FAQ