by noppefoxwolf

noppefoxwolf / Kitsunebi

Overlay alpha channel video animation player view using Metal.

211 Stars 23 Forks Last release: 25 days ago (0.30.0) MIT License 78 Commits 17 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Overlay alpha channel video animation player view using Metal.


To run the example project, clone the repo, and run pod install from the Example directory first.


At the top of your file, make sure to

import Kitsunebi
import Kitsunebi

Then, instantiate PlayerView in your view controller:

private lazy var playerView: PlayerView = PlayerView(frame: view.bounds)!

override func viewDidLoad() { super.viewDidLoad() view.addSubview(playerView) }

You can play transparency video any framerate. baseVideo is colornize video, alphaVideo is alpha channel monotone video. please see example video files.:

let baseVideoURL = Bundle.main.url(forResource: "base", withExtension: "mp4")!
let alphaVideoURL = Bundle.main.url(forResource: "alpha", withExtension: "mp4")! baseVideoURL, alpha: alphaVideoURL, fps: 30)


Kitsunebi is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Kitsunebi'


Tomoya Hirano, [email protected]


Kitsunebi is available under the MIT license. See the LICENSE file for more info.

Sample video file


Split video using ffmpeg

ffmpeg -i base.mp4  -i alpha.mp4 -filter_complex "nullsrc=size=1500x1334 [base];[0:v] setpts=PTS-STARTPTS, scale=750x1334 [left];[1:v] setpts=PTS-STARTPTS, scale=750x1334 [right];[base][left] overlay=shortest=1 [tmp1];[tmp1][right] overlay=shortest=1:x=750" output.mp4

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.