{"id":19935621,"url":"https://github.com/efremidze/visualeffectview","last_synced_at":"2025-12-29T04:27:21.795Z","repository":{"id":45623695,"uuid":"59773356","full_name":"efremidze/VisualEffectView","owner":"efremidze","description":"Dynamic blur background view with tint color (UIVisualEffectView subclass) 📱","archived":false,"fork":false,"pushed_at":"2025-05-02T05:57:22.000Z","size":7231,"stargazers_count":1244,"open_issues_count":9,"forks_count":90,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-05-02T06:31:12.614Z","etag":null,"topics":["apple","blur","effects","ios","swift","tint","uiblureffect","uivisualeffectview"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/efremidze.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["efremidze"]}},"created_at":"2016-05-26T18:24:29.000Z","updated_at":"2025-05-02T05:57:26.000Z","dependencies_parsed_at":"2024-04-27T23:31:18.233Z","dependency_job_id":"a762a48b-571e-46b1-a66d-8ed09831df89","html_url":"https://github.com/efremidze/VisualEffectView","commit_stats":{"total_commits":122,"total_committers":8,"mean_commits":15.25,"dds":0.06557377049180324,"last_synced_commit":"657e7f1660cd95c6e09a0b08937a9503cc37a3fd"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efremidze%2FVisualEffectView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efremidze%2FVisualEffectView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efremidze%2FVisualEffectView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/efremidze%2FVisualEffectView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/efremidze","download_url":"https://codeload.github.com/efremidze/VisualEffectView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254364270,"owners_count":22058878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","blur","effects","ios","swift","tint","uiblureffect","uivisualeffectview"],"created_at":"2024-11-12T23:20:59.941Z","updated_at":"2025-12-29T04:27:21.789Z","avatar_url":"https://github.com/efremidze.png","language":"Swift","funding_links":["https://github.com/sponsors/efremidze"],"categories":[],"sub_categories":[],"readme":"# VisualEffectView\n\n[![CI](https://github.com/efremidze/VisualEffectView/actions/workflows/ci.yml/badge.svg)](https://github.com/efremidze/VisualEffectView/actions/workflows/ci.yml)\n[![CocoaPods](https://img.shields.io/cocoapods/v/VisualEffectView.svg)](https://cocoapods.org/pods/VisualEffectView)\n[![Carthage](https://img.shields.io/badge/Carthage-compatible-brightgreen.svg)](https://github.com/Carthage/Carthage)\n[![SPM](https://img.shields.io/badge/SPM-compatible-brightgreen.svg)](https://swift.org/package-manager/)\n[![Swift](https://img.shields.io/badge/Swift-5.9+-orange.svg)](https://swift.org)\n[![License](https://img.shields.io/github/license/efremidze/VisualEffectView.svg)](https://github.com/efremidze/VisualEffectView/blob/master/LICENSE)\n\n**VisualEffectView** is a dynamic blur effect library with tint color support and iOS 26+ glass effects. This library uses [UIVisualEffectView](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIVisualEffectView/) to generate the blur.\n\n\u003cimg src=\"/Images/demo.gif\" width=\"250\" /\u003e\n\n```\n$ pod try VisualEffectView\n```\n\n## Requirements\n\n- iOS 14.0+\n- Swift 5 (VisualEffectView 4.x), Swift 4 (VisualEffectView 3.x), Swift 3 (VisualEffectView 2.x), Swift 2 (VisualEffectView 1.x)\n- Supports SwiftUI\n\n## Usage\n\n### UIKit\n\n```swift\nimport VisualEffectView\n\nlet visualEffectView = VisualEffectView(frame: CGRect(x: 0, y: 0, width: 320, height: 480))\n\n// Customize the blur\nvisualEffectView.colorTint = .red\nvisualEffectView.colorTintAlpha = 0.2\nvisualEffectView.blurRadius = 10\nvisualEffectView.scale = 1\n\naddSubview(visualEffectView)\n```\n\nYou can also use different styles:\n\n```swift\n// System blur\nvisualEffectView.style = .systemBlur(.dark)\n\n// Glass effect (iOS 26+)\nvisualEffectView.style = .glass(.regular)\n\n// Custom blur (default)\nvisualEffectView.style = .customBlur\n```\n\n### SwiftUI\n\n```swift\nimport VisualEffectView\n\nstruct ContentView: View {\n    var body: some View {\n        VisualEffect(colorTint: .white, colorTintAlpha: 0.5, blurRadius: 18, scale: 1)\n    }\n}\n```\n\nOr use the style-based API:\n\n```swift\nVisualEffect(style: .glass(.regular))\nVisualEffect(style: .systemBlur(.dark))\n```\n\n### Customization\n\n```swift\nvar colorTint: UIColor // tint color. default is nil\nvar colorTintAlpha: CGFloat // tint color alpha. default is 0\nvar blurRadius: CGFloat // blur radius. default is 0\nvar scale: CGFloat // scale factor. default is 1\nvar saturation: CGFloat // saturation factor. default is 1\n```\n\n**Note:** Custom blur properties only work when `style` is `.customBlur`.\n\nIf you want `colorTintAlpha` to be different from `0`, make sure you always set it right after setting the `colorTint` or it may not be applied as expected. Don't set `colorTintAlpha` if `colorTint` is `nil`.\n\n### Content View\n\nAdd subviews to the `contentView` property, not directly to the visual effect view:\n\n```swift\nvisualEffectView.contentView.addSubview(label)\n```\n\nRefer to the [UIVisualEffectView](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIVisualEffectView/) documentation for more info.\n\n### Storyboard Support\n\nWorks great with storyboards and xibs.\n\n## Installation\n\n### CocoaPods\nTo install with [CocoaPods](http://cocoapods.org/), simply add this in your `Podfile`:\n```ruby\nuse_frameworks!\npod \"VisualEffectView\"\n```\n\n### Carthage\nTo install with [Carthage](https://github.com/Carthage/Carthage), simply add this in your `Cartfile`:\n```ruby\ngithub \"efremidze/VisualEffectView\"\n```\n\n### Swift Package Manager\nAdd VisualEffectView as a dependency in your `Package.swift` file:\n```swift\ndependencies: [\n    .package(url: \"https://github.com/efremidze/VisualEffectView.git\", from: \"6.0.0\")\n]\n```\n\n### Manually\n1. Download and drop the source files in your project.  \n2. Congratulations!\n\n## Communication\n\n- If you **found a bug**, open an issue.\n- If you **have a feature request**, open an issue.\n- If you **want to contribute**, submit a pull request.\n\n## Disclaimer\n\nVisualEffectView utilizes a private UIKit API to do its magic. Use caution, submitting this code to the App Store adds the risk of being rejected!\n\nThe `.systemBlur()` and `.glass()` styles use only public APIs and are safe for App Store submission.\n\n## Credits\n\nhttps://github.com/collinhundley/APCustomBlurView\n\n## License\n\nVisualEffectView is available under the MIT license. See the LICENSE file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fefremidze%2Fvisualeffectview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fefremidze%2Fvisualeffectview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fefremidze%2Fvisualeffectview/lists"}