{"id":28386903,"url":"https://github.com/futuretap/ftlinearactivityindicator","last_synced_at":"2025-06-26T19:32:12.215Z","repository":{"id":56910829,"uuid":"116163286","full_name":"futuretap/FTLinearActivityIndicator","owner":"futuretap","description":"Add the missing network activity indicator on notched iPhones","archived":false,"fork":false,"pushed_at":"2024-09-26T15:09:19.000Z","size":2093,"stargazers_count":699,"open_issues_count":0,"forks_count":44,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-05-30T19:47:44.007Z","etag":null,"topics":["activity-indicator","ios","iphone","uikit","uikit-components"],"latest_commit_sha":null,"homepage":"https://www.futuretap.com/blog/fix-for-the-missing-network-activity-indicator-on-iphone-x","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/futuretap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"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},"funding":{"github":"futuretap"}},"created_at":"2018-01-03T17:21:59.000Z","updated_at":"2025-05-29T15:34:55.000Z","dependencies_parsed_at":"2024-06-18T16:45:37.379Z","dependency_job_id":"3d36c98d-6e9e-492c-8c03-7746a9632057","html_url":"https://github.com/futuretap/FTLinearActivityIndicator","commit_stats":{"total_commits":78,"total_committers":9,"mean_commits":8.666666666666666,"dds":"0.46153846153846156","last_synced_commit":"4d2da50e8f46e521ac3f36f44e768628eced441f"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/futuretap/FTLinearActivityIndicator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretap%2FFTLinearActivityIndicator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretap%2FFTLinearActivityIndicator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretap%2FFTLinearActivityIndicator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretap%2FFTLinearActivityIndicator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/futuretap","download_url":"https://codeload.github.com/futuretap/FTLinearActivityIndicator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futuretap%2FFTLinearActivityIndicator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262132525,"owners_count":23264011,"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":["activity-indicator","ios","iphone","uikit","uikit-components"],"created_at":"2025-05-30T15:39:05.425Z","updated_at":"2025-06-26T19:32:12.203Z","avatar_url":"https://github.com/futuretap.png","language":"Swift","funding_links":["https://github.com/sponsors/futuretap","https://github.com/sponsors/futuretap)!"],"categories":[],"sub_categories":[],"readme":"# FTLinearActivityIndicator\n\n[![Version](https://img.shields.io/cocoapods/v/FTLinearActivityIndicator.svg?style=flat)](http://cocoapods.org/pods/FTLinearActivityIndicator)\n[![Swift Package Manager compatible](https://img.shields.io/badge/SPM-compatible-brightgreen.svg)](https://swiftpackageindex.com/futuretap/FTLinearActivityIndicator)\n[![License](https://img.shields.io/cocoapods/l/FTLinearActivityIndicator.svg?style=flat)](https://creativecommons.org/licenses/by-sa/4.0/)\n[![Platform](https://img.shields.io/cocoapods/p/FTLinearActivityIndicator.svg?style=flat)](http://cocoapods.org/pods/FTLinearActivityIndicator)\n[![Sponsor](https://img.shields.io/badge/Sponsor-ff40a0)](https://github.com/sponsors/futuretap)\n[![Mastodon](https://img.shields.io/mastodon/follow/000010558?domain=https%3A%2F%2Fmastodon.cloud)](https://mastodon.cloud/@ortwingentz)\n\nSince iOS 18, network activity indicator is no longer displayed. iPhones with a notch or Dynamic Island \n[never displayed it](http://www.futuretap.com/blog/fix-for-the-missing-network-activity-indicator-on-iphone-x).\nThis framework brings it back by placing an activity indicator in the upper right of the screen on top of the\nregular status bar items (on top of the clock on iPhone SE running iOS 18+).\n\nSince a circular indicator wouldn't fit, a rectangular [KITT scanner](https://giphy.com/gifs/80s-nbc-knight-rider-Bo2WsocASVBm0)-like indicator with a gradient is shown. The indicator UI can be used standalone or as a \"fix\" for the iOS network activity indicator (using the existing API).\n\n\u003cimg src=\"https://github.com/futuretap/FTLinearActivityIndicator/blob/master/screenshot.gif?raw=true\"\u003e\n\n## Integration\n### As a fix for the system network activity indicator\n\nIn your app delegate's `didFinishLaunching` method, **after** initializing the window, just call\n\n    UIApplication.configureLinearNetworkActivityIndicatorIfNeeded()\n\nThen, use the standard network activity indicator as usual.\n\n### As a standalone view\n\nInclude a `FTLinearActivityIndicator` view in your storyboard or instantiate it from code. The class supports the following methods and properties, using a similar API as the iOS `UIActivityIndicatorView`:\n\n- `startAnimating()`\n- `stopAnimating()`\n- `isAnimating: Bool`\n- `hidesWhenStopped: Bool`\n\n`tintColor` is supported to colorize the indicator gradient.\n\n## Requirements\n\n- iOS 12 or higher (iOS 11 is supported until version 1.6)\n- compiles for Mac Catalyst or visionOS (without network activity indicator)\n\n## Installation\n\nFTLinearActivityIndicator is available through [Swift Package Manager](https://swiftpackageindex.com/futuretap/FTLinearActivityIndicator) or [CocoaPods](http://cocoapods.org). \n\n### Swift Package Manager\nTo install FTLinearActivityIndicator using [Swift Package Manager](https://github.com/apple/swift-package-manager) you can follow the [tutorial published by Apple](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app) using the URL for the FTLinearActivityIndicator repo with the current version:\n\n1. In Xcode, select “File” → “Add Packages…”\n1. Enter `https://github.com/futuretap/FTLinearActivityIndicator.git`\n\n### CocoaPods\nTo install FTLinearActivityIndicator via CocoaPods, add the following line to your Podfile:\n\n```ruby\npod 'FTLinearActivityIndicator'\n```\n\nThen run `pod install`.\n\nTo open an example project, just call `pod try FTLinearActivityIndicator` on the command line.\n\n## Author\nDeveloped by [Ortwin Gentz](https://www.futuretap.com/about/ortwin-gentz) ([Mastodon](https://mastodon.cloud/@ortwingentz)) and used in [FutureTap](https://www.futuretap.com)’s [Where To?](https://wheretoapp.com) and [Streets](https://streets.app) apps – we eat our own dog food!\n\n## License\nFTLinearActivityIndicator is available under the [CC-BY-SA 4.0 license](http://creativecommons.org/licenses/by-sa/4.0/). You may copy and redistribute, adapt and build upon the framework for any purpose, even commercially, as long as you give credit to me in the About menu or a similar place in the app.\nIf you need a different license without attribution requirement, please contact me and we can work something out.\n\n## Sponsors wanted\nIf you would like to support my Open Source work, consider joining me as a [sponsor](https://github.com/sponsors/futuretap)! 💪️ Your sponsorship enables me to spend more time on this and other community projects. Thank you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturetap%2Fftlinearactivityindicator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuturetap%2Fftlinearactivityindicator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturetap%2Fftlinearactivityindicator/lists"}