# renzifeng/ZFPlayer

Support customization of any player SDK and control layer(支持定制任何播放器SDK和控制层)

Repository: https://github.com/renzifeng/ZFPlayer
Canonical: https://ross.abutalabs.com/products/zfplayer
Language: Objective-C
License: MIT
License Family: permissive
Topics: custom, player, controlview
Last push: 2024-05-24T02:29:56+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3835, "days_push": 832, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7128, forks 1767 (observed 2026-08-28T04:09:56.101920+00:00)

## What it is
ZFPlayer is an iOS media player template library that decouples the player SDK from the control layer via the ZFPlayerMediaPlayback and ZFPlayerMediaControl protocols, letting developers plug in any player (AVPlayer, ijkplayer) and fully customize the UI. It supports both normal single-player and list-style (tableView/collectionView) playback scenarios.

## Use cases
- build a custom video player UI on iOS
- swap between AVPlayer and ijkplayer without rewriting playback code
- play videos in a scrolling list of cells
- customize player control layer (progress bar, gestures, fullscreen)
- support rotation and fullscreen video in an iOS app

## When to choose
- you need a customizable iOS video player with pluggable playback backends
- you want list/cell-based video playback with floating window support
- you're building an Objective-C or Swift iOS app needing video controls

## When to avoid
- you need video playback on Android or cross-platform
- you want a ready-made player without custom UI work
- your project targets platforms other than iOS

## Facets
- artifact type: library
- maturity: stable
- function: video-processing, ui-components, plugin-system
- domain: media, mobile-development
- platform: cpp
- tags: video-player, objective-c, cocoapods, avplayer, ijkplayer, custom-control-layer, media-playback, ios, mobile, swift

## Member repositories
- renzifeng/ZFPlayer (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:56.101920+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:40:03.973578+00:00, confidence not recorded.
  - readme: https://github.com/renzifeng/ZFPlayer (fetched 2026-08-28T04:09:56.101920+00:00, sha 928811eca7a5)
- Data as of 2026-08-30T08:39:29.467469+00:00.