ZFPlayer
A flexible iOS player framework supporting any player SDK and fully customizable control layer.
What is ZFPlayer?
ZFPlayer is an iOS video player framework that provides a flexible architecture for integrating various player SDKs like AVPlayer and ijkplayer while allowing complete customization of the control layer. It solves the problem of being locked into a specific player implementation or having to modify source code to support different playback engines. Developers can build video players that match their app's design requirements without being constrained by the underlying player technology.
iOS developers building apps with video playback features who need flexibility in choosing player SDKs or designing custom player interfaces. This includes teams working on social media apps, streaming platforms, or any application requiring embedded video with tailored controls.
Developers choose ZFPlayer because it decouples player engine selection from UI design, allowing them to swap player SDKs without rewriting control logic. Its protocol-based architecture makes it highly extensible, and built-in support for list views simplifies integration in feed-based applications.
Overview
Support customization of any player SDK and control layer(支持定制任何播放器SDK和控制层)
Use Cases
Best For
- Integrating multiple player SDKs (AVPlayer, ijkplayer, VLC) in a single iOS app
- Building custom video player interfaces with unique control designs
- Adding video playback to UITableView or UICollectionView feeds
- Creating apps that require screen rotation support for video
- Developing video-heavy applications where player flexibility is critical
- Teams needing to maintain consistent UI across different player backends
Not Ideal For
- Apps requiring out-of-the-box, pre-styled player controls with minimal setup
- SwiftUI-only projects due to its UIKit-centric architecture
- Simple use cases where only AVPlayer is needed without multi-SDK flexibility
- Teams unfamiliar with protocol-oriented programming in iOS
Pros & Cons
Pros
Supports AVPlayer, ijkplayer, VLC, and others via the ZFPlayerMediaPlayback protocol, allowing developers to swap playback engines without rewriting control logic.
Enables full customization of player interfaces by conforming to the ZFPlayerMediaControl protocol, decoupling the control layer from the player engine for design freedom.
Provides built-in support for UITableView and UICollectionView, simplifying video playback implementation in feed-based apps like social media.
Manages screen orientation changes with built-in configuration options, reducing the need for manual rotation code in video playback scenarios.
Cons
Requires conformance to protocols for custom players and controls, which can be complex and time-consuming for developers new to this architecture.
Primarily designed for UIKit, with no native SwiftUI components, forcing extra work to integrate into modern iOS apps using SwiftUI.
Using player SDKs like ijkplayer involves additional pod installations and potential compatibility issues, increasing setup complexity.
Frequently Asked Questions
Related Projects
MobilePlayer:iphone: :movie_camera: A powerful and completely customizable media player for iOS
XCDYouTubeKitYouTube video player for iOS, tvOS and macOS
Player▶️ Play and stream media in Swift
BMPlayerA video player for iOS, based on AVPlayer, support the horizontal, vertical screen. support adjust volume, brightness and seek by slide, support subtitles.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.