{"id":2287,"url":"https://github.com/IdleHandsApps/StatusBarOverlay","last_synced_at":"2025-08-02T23:32:57.955Z","repository":{"id":62456018,"uuid":"106355723","full_name":"IdleHandsApps/StatusBarOverlay","owner":"IdleHandsApps","description":"StatusBarOverlay will automatically show a \"No Internet Connection\" bar when your app loses connection, and hide it again. It supports apps which hide the status bar and The Notch","archived":false,"fork":false,"pushed_at":"2020-07-20T03:59:50.000Z","size":2270,"stargazers_count":163,"open_issues_count":3,"forks_count":26,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-29T19:21:09.950Z","etag":null,"topics":[],"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/IdleHandsApps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-10T01:53:20.000Z","updated_at":"2024-04-26T02:17:14.000Z","dependencies_parsed_at":"2022-11-01T23:03:50.235Z","dependency_job_id":null,"html_url":"https://github.com/IdleHandsApps/StatusBarOverlay","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IdleHandsApps%2FStatusBarOverlay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IdleHandsApps%2FStatusBarOverlay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IdleHandsApps%2FStatusBarOverlay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IdleHandsApps%2FStatusBarOverlay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IdleHandsApps","download_url":"https://codeload.github.com/IdleHandsApps/StatusBarOverlay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228503176,"owners_count":17930527,"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":[],"created_at":"2024-01-05T20:16:09.889Z","updated_at":"2024-12-06T17:30:59.262Z","avatar_url":"https://github.com/IdleHandsApps.png","language":"Swift","funding_links":[],"categories":["UI"],"sub_categories":["Activity Indicator","Other free courses"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"StatusBarOverlay\" src=\"https://github.com/IdleHandsApps/StatusBarOverlay/blob/master/StatusBarOverlay/StatusBarOverlay/StatusBarOverlay/Assets.xcassets/AppIcon.appiconset/Logo-76.png\" /\u003e\n\u003c/p\u003e\n\nStatusBarOverlay [![Language: Swift 4.0](https://img.shields.io/badge/Swift-4.0-orange.svg)](https://swift.org)\n------------------------------\n\n![alt demo](https://github.com/IdleHandsApps/StatusBarOverlay/blob/files/StatusBarOverlayDemo.gif)\n\nStatusBarOverlay will automatically show a \"No Internet Connection\" bar when your app loses connection, and hide it again. It supports apps which hide the status bar and The Notch\n\n## Features\n\n* Just a few lines of code and StatusBarOverlay will automatically show \u0026 hide when internet connection is lost \u0026 regained\n* Support for apps that hide the status bar permanently\n* Support for the iPhone X Notch\n* Optionally you can choose to show the status bar anytime with custom text, eg for Debug or Demo modes\n* Optionally you can show a drop down message, below the status bar, with a click handle, great for nonintrusive alerts\n* Fully customisable colors \u0026 text\n\n## How to install\n\nAdd this to your CocoaPods Podfile\n```\npod 'StatusBarOverlay'\n```\n\n## How to use\n\nIn your ```Info.plist``` file set ```UIViewControllerBasedStatusBarAppearance = true```\n\nIn your ```AppDelegate.didFinishLaunchingWithOptions()``` method set ```StatusBarOverlay.host``` to your server domain. StatusBarOverlay will use this to check connectivity\n```swift\nfunc application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -\u003e Bool {\n\n  StatusBarOverlay.host = \"example.com\"\n        \n  return true\n}\n```\n\nIf you use a common UIViewController subclass, add the following to it. All of view controllers show override these methods, so its best to use a common UIViewController subclass\n```swift\nimport StatusBarOverlay // if StatusBarOverlay is in CocoaPod\n\nextension CommonViewController {\n\n  override var preferredStatusBarStyle: UIStatusBarStyle {\n    return StatusBarOverlay.preferredStatusBarStyle\n  }\n\n  override var prefersStatusBarHidden: Bool {\n    return StatusBarOverlay.prefersStatusBarHidden\n  }\n\n  override var preferredStatusBarUpdateAnimation: UIStatusBarAnimation {\n    return StatusBarOverlay.preferredStatusBarUpdateAnimation\n  }\n}\n```\n\nThats it. Run your app, try turning on and off airplane mode and the No Internet Connection bar will show and hide.\nOn the simulator sometimes the hiding event isnt fired. All devices work normally\n\n## Dependencies\n\n* Reachability is required for the connectivity events\n\n## Get these while stocks last :)\n\nA Codable extension to decode arrays and to catch \u0026 log all decoding failures\nhttps://github.com/IdleHandsApps/SafeDecoder\n\nAn elegant solution for keeping views visible when the keyboard is being shown\nhttps://github.com/IdleHandsApps/IHKeyboardAvoiding\n\nButton styles that are centralied and reusable, and hooked up to InterfaceBuilder\nhttps://github.com/IdleHandsApps/DesignableButton\n\n## Author\n\n* Fraser Scott-Morrison (fraserscottmorrison@me.com)\n\nIt'd be great to hear about any cool apps that are using StatusBarOverlay\n\n## License\n\nDistributed under the MIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FIdleHandsApps%2FStatusBarOverlay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FIdleHandsApps%2FStatusBarOverlay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FIdleHandsApps%2FStatusBarOverlay/lists"}