An incremental Qt-free rewrite now lives in modern/. It provides a standalone C++17/FFmpeg 8+ playback core with an asynchronous Player API, decoded frame callbacks, and application-owned render scheduling. It is maintained for Windows, Android, and OHOS targets only. The former QtAVCore macOS/iOS implementation is preserved under archived_apple/ and is no longer maintained, built, tested, packaged, or installed. On a supported target, build the modern core independently with cmake -S modern -B build/modern; it does not link Qt or require a Qt event loop. Platform claims later in this file describe the legacy root QtAV implementation, not QtAVCore.

QtAVCore builds must use FFmpeg and its dependency closure produced by this repository's ffmpeg/ vcpkg subproject, rather than a system/Homebrew or unrelated prebuilt target FFmpeg. Project builds and examples must resolve the package in this order:

1. use the matching local target prefix when it and the sibling vcpkg status database already exist;
2. otherwise build and verify the package locally with the matching platform entry script.

GitHub Actions artifacts are not a supported dependency fallback. CI may still publish them for diagnostics or archival purposes, but local builds and examples must not download or consume them.

Independently of that consumption order, a change that modifies anything under ffmpeg/** must rerun the affected platform build script locally and pass its installed-package verifier before the change is considered validated.

The supported target prefixes are:

Build a missing prefix locally from the repository root:

./ffmpeg/scripts/build-android.ps1
./ffmpeg/scripts/build-ohos.ps1
./ffmpeg/scripts/build-windows.ps1

The Android PowerShell entry point discovers the SDK, an already installed NDK, and CMake from Android Studio; it never installs or replaces them. On macOS, use ffmpeg/scripts/build-android.sh or ffmpeg/scripts/build-ohos.sh. Run the corresponding native script unconditionally when the current change modifies ffmpeg/**.

I'm not developing QtAV, patches are still welcome. You can try my new sdk which is actively developed

QtAV is a multimedia playback library based on Qt and FFmpeg. It can help you to write a player with less effort than ever before.

QtAV has been added to FFmpeg projects page http://ffmpeg.org/projects.html

QtAV is free software licensed under the term of LGPL v2.1. The player example is licensed under GPL v3. If you use QtAV or its constituent libraries, you must adhere to the terms of the license in question.

QtAV can meet your most demands

• Hardware decoding suppprt: DXVA2, VAAPI, VDA/VideoToolbox, CedarX, CUDA(the 1st player support CUDA on linux?)
• OpenGL and ES2 support for almost all formats including Hi10P videos (The 1st player/library support 10bit in ES2? VLC, XBMC, mplayer does not support now)
• Real time preview
• Video capture in rgb and yuv format
• OSD and custom filters
• Filters in libavfilter, for example stero3d, blur
• Subtitle track select. Dynamic change FFmpeg and libass engine
• Play frame by frame
• Playback speed control
• Variant streams: locale file, http, rtsp etc. and your custom streams
• Audio channel, tracks and external audio tracks
• Dynamically change render engine when playing.
• Dynamically change video decoder
• Multiple video outputs for 1 player
• Video eq(software and OpenGL): brightness, contrast, saturation, hue
• QML support. Most playback APIs are compatible with QtMultimedia module
• Compatibility: QtAV can be built with both Qt4 and Qt5, FFmpeg(>=1.0) and Libav (>=9.0). Latest FFmpeg release is recommended.

Some components in QtAV are designed to be extensible. For example, you can write your decoder, audio output for particular platform. Here is a very good example to add cedar hardware accelerated decoder for A13-OLinuXino

The required development files to build QtAV can be found in sourceforge page: depends

See the wiki Build QtAV and QtAV Build Configurations

Write a media player using QtAV is quite easy.

GLWidgetRenderer2 renderer;
renderer.show();
AVPlayer player;
player.setRenderer(&renderer);
player.play("test.avi");

For more detail to using QtAV, see the wiki Use QtAV In Your Project or examples.

QtAV can also be used in Qml

import QtQuick 2.0
import QtAV 1.6
Item {
    Video {
        id: video
        source: "test.mp4"
    }
    MouseArea {
        anchors.fill: parent
        onClicked: video.play()
    }
}

• Fork QtAV project on github and make a branch. Commit in that branch, and push, then create a pull request to be reviewed and merged.
• Create an issue if you have any problem when using QtAV or you find a bug, etc.
• What you can do: translation, write document, wiki, find or fix bugs, give your idea for this project etc.

• Wang Bin(Lucas Wang): creator, maintainer
• Gianluigi Tiesi(sherpya): avdevice input support
• Stefan Ladage: QIODevice support. Wiki about build QtAV for iOS. Let OpenAL work on OSX and iOS
• Miroslav Bendik: Cedarv support. Better qmlvideofx appearance
• theoribeiro: initial QML support
• Vito Covito: interrupt callback
• Alexander, Marius Wachtler, Petar Koretić, Sandro Cavazzoni(skaman), Dimitri E. Prado, karlox ...

Run player -h

• Double click: fullscreen switch
• Ctrl+O: open a file
• Space: pause/continue
• F: fullscreen on/off
• T: stays on top on/off
• N/B: show the next/previous frame. Continue the playing by pressing "Space"
• O: OSD
• P: replay
• Q/ESC: quit
• S: stop
• A: switch aspect ratio
• R: rotate 90
• M: mute on/off
• Up / Down: volume + / -
• Ctrl+Up/Down: speed + / -
• -> / <-: seek forward / backward
• Crtl+Wheel: zoom in/out
• Drag and drop a media file to player

Use QtAV in QML with OpenGL shaders(example is from qtmultimedia. But qtmultimedia is replaced by QtAV)

Copyright © Wang Bin wbsecg1@gmail.com

2013-01-21