How do I change the blur color in BlurryModalSegue?

Set the backingImageTintColor property in prepareForSegue or via UIAppearance. For example, use bms.backingImageTintColor = [UIColor greenColor] to add a green tint, as shown in the customization section of the README.

BlurryModalSegue or custom UIViewControllerTransitioningDelegate: which is better?

BlurryModalSegue is simpler for storyboard-based apps needing basic blur effects, while a custom transitioning delegate offers more control over animations and code-based setups. Choose based on your project's complexity and presentation needs.

Why isn't the blur effect showing in my modal?

This is often due to nested view controllers with solid background colors. Ensure all presented views have clearColor backgrounds, as explained in the troubleshooting section of the README.

Does BlurryModalSegue work with Swift projects?

Yes, it can be used in Swift via bridging header since it's written in Objective-C. Install via CocoaPods and import the module to access the segue class, though Swift-specific documentation is limited.

How to install BlurryModalSegue without CocoaPods?

The README only mentions CocoaPods installation. For manual setup, you'd need to download the source files and add them to your project, but this isn't documented and may require additional configuration.

Is BlurryModalSegue compatible with iOS 13's modal presentation style?

It should work with standard modal presentations, but may not fully integrate with iOS 13's sheet-style modals or newer APIs. Testing is advised for compatibility with evolving UIKit features.

Open-Awesome

BlurryModalSegue

MITObjective-C

A custom iOS modal segue subclass that provides a blurred overlay effect for storyboard segues.

GitHub

913 stars70 forks0 contributors

What is BlurryModalSegue?

BlurryModalSegue is a custom UIStoryboardSegue subclass for iOS that adds a blurred background effect to modal presentations created in storyboards. It solves the problem of creating visually engaging modal overlays without deviating from Apple's built-in modal presentation system, providing a seamless way to enhance app aesthetics.

Target Audience

iOS developers using storyboards and UIKit who want to implement blurred modal overlays with minimal code changes, particularly those targeting iOS 7 and above.

Value Proposition

Developers choose BlurryModalSegue because it integrates directly with Interface Builder, requires no custom transition delegates, and offers easy customization via UIAppearance, making it a lightweight drop-in replacement for standard modal segues.

Overview

A custom modal segue providing a blurred overlay effect.

Use Cases

Best For

Adding blurred backgrounds to modal view controllers in storyboard-based iOS apps
Enhancing UI aesthetics with minimal code changes in UIKit projects
Creating transparent modal overlays that maintain native iOS behavior
Customizing blur effects per segue or globally via UIAppearance
Quickly prototyping visually appealing modal transitions in Interface Builder
Integrating blur effects in apps targeting iOS 7+ without complex animation code

Not Ideal For

Apps targeting iOS 6 or earlier, as it requires iOS 7+ for UIViewControllerTransitionCoordinator
Projects using SwiftUI or programmatic view controller presentation without storyboards
Situations where modal dismissal must have perfectly synchronized blur effects
Applications requiring the modal view to rotate after presentation

Pros & Cons

Pros

Storyboard Simplicity

Enables drag-and-drop replacement of standard modal segues in Interface Builder, eliminating the need for custom transition code, as shown in the usage section.

Flexible Blur Customization

Allows adjustment of blur radius, saturation, and tint color via UIAppearance or per-instance in prepareForSegue, detailed in the README's customization examples.

Native Animation Integration

Uses UIViewControllerTransitionCoordinator for smooth presentations on iOS 7+, ensuring compatibility with Apple's modal system without breaking existing workflows.

Helpful Troubleshooting

Provides clear guidance on common issues like solid background colors hiding the blur, helping developers quickly resolve implementation problems.

Cons

Dismissal Effect Limitations

The README admits the blur effect is better during presentation than dismissal due to UIViewControllerTransitionCoordinator constraints, resulting in imperfect visual sync.

No Post-Presentation Rotation

Rotation after modal presentation is unsupported because the backing image is fixed to the original orientation, limiting usability in landscape-heavy apps.

Partial Curl Incompatibility

Does not support UIModalTransitionStylePartialCurl, restricting the range of available modal transitions and requiring workarounds for specific designs.

Frequently Asked Questions

Related Projects

Hero

Elegant transition library for iOS & tvOS

Stars22,454

Forks1,735

Last commit1 year ago

BubbleTransition

A custom modal transition that presents and dismiss a controller with an expanding bubble effect.

Stars3,309

Forks248

Last commit5 years ago

SPStorkController

Now playing controller from Apple Music, Mail & Podcasts Apple's apps.

Stars2,739

Forks203

Last commit3 years ago

Transition

Easy interactive interruptible custom ViewController transitions

Stars2,631

Forks127