VideoTrimmerControl

A VideoTrimmer Control for iOS that supports trimming & scrubbing

This VideoTrimmer Control for iOS allows the user to define how a video should be trimmed by dragging the side handles. When the user is trimming, pausing for a brief moment zooms in on the timeline to allow for greater precision. The timeline shows thumbnails of the video frames, based on AVAsset. Besides trimming, the control also optionallu allows the user to scrub through the video by tapping on the timeline.

Screenshots

The control when not interacting:

The control when the user trimmed the leading and trailing parts:

The control when the user is trimming the leading part:

The control when the user has zoomed in on the timeline:

Animated GIF of the Control in Action

Configuration

asset: the asset to use for thumbnails. Setting this automatically updates the range and selectedRange properties
videoComposition: the AVVideoComposition to use (see AVFoundation)
minimumDuration: the minimal duration that a video can be. The user can't trim a clip shorter than this
range: the range of the asset to use
selectedRange: the range that is selected by the user. If nothing is trimmed, is equal to range.
progressIndicatorMode: defines how the progress indicator is shown hiddenOnlyWhenTrimming, alwaysShown or alwaysHidden
progress: the progress of the movie (e.g. current position when playing)
horizontalInset: the inset from the sides where the timeline and thumbs start. Defaults to 16. (Allows for overshooting when zooming)
trackBackgroundColor: background color for the timeline track
thumbRestColor: background color for the timeline parts where there is no video, but the thumbs rest when not trimmed

State Properties:

trimmingState: none if the user is not trimming, leading if they're trimming from the front, trailing if they're trimming from the end
isZoomedIn: true is the user zoomed in the timeline while trimming
isScrubbing: true if the user is scrubbing
visibleRange: the range that's currently displayed. Could be different from range when zoomed in
selectedTime: the time that's currently selected when trimming

Gesture Recognizers

You can configure the following gesture recognizers to require failure of, for example, a UITableView's panGestureRecognizer:

leadingGestureRecognizer
trailingGestureRecognizer
progressGestureRecognizer
thumbnailInteractionGestureRecognizer

Events:

VideoTrimmer.didBeginTrimming: fired when the user started trimming
VideoTrimmer.didEndTrimming: fired when the user stopped trimming
VideoTrimmer.selectedRangeChanged: fired when the selectedRange property changed because of the user trimming
didBeginScrubbing: fired when the user started scrubbing through the video
didEndScrubbing: fired whe nthe user ended scrubbing
progressChanged: fired when the progress property changed because of the user scrubbing

ziiip / VideoTrimmerControl