{"id":19173874,"url":"https://github.com/navideck/volumedeck-ios","last_synced_at":"2025-06-11T16:08:01.254Z","repository":{"id":185082731,"uuid":"591197154","full_name":"Navideck/Volumedeck-iOS","owner":"Navideck","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-19T18:28:40.000Z","size":34644,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-23T00:39:19.108Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Navideck.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-01-20T06:33:14.000Z","updated_at":"2024-10-19T18:28:45.000Z","dependencies_parsed_at":"2023-07-31T17:16:16.266Z","dependency_job_id":"9bf13210-8892-4573-9d2c-296c6963af8f","html_url":"https://github.com/Navideck/Volumedeck-iOS","commit_stats":null,"previous_names":["navideck/volumedeck-ios"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/Navideck/Volumedeck-iOS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Navideck%2FVolumedeck-iOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Navideck%2FVolumedeck-iOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Navideck%2FVolumedeck-iOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Navideck%2FVolumedeck-iOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Navideck","download_url":"https://codeload.github.com/Navideck/Volumedeck-iOS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Navideck%2FVolumedeck-iOS/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259293405,"owners_count":22835605,"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-11-09T10:15:03.078Z","updated_at":"2025-06-11T16:08:01.237Z","avatar_url":"https://github.com/Navideck.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Volumedeck SDK - iOS\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://navideck.com/sites/navideck.com/files/2023-10/Volumedeck%20SDK%20icon.png\" height=150 /\u003e\n\u003c/p\u003e\n\n## Overview\n\nVolumedeck provides automatic volume adjustment based on GPS speed, improving the media-listening experience for users in vehicles and public transport.\n\n## Key Features\n\n- Speed-Sensitive Volume Adjustment: Automatically adjusts audio volume based on the vehicle's speed for consistent audio levels.\n- Enhanced Safety and Focus: Eliminates the need for manual volume adjustments, enhancing driver safety and passenger convenience.\n- Efficient and Reliable: Real-time speed-based volume control for smooth and uninterrupted listening experiences.\n- Easy Integration: User-friendly API and comprehensive documentation for straightforward implementation.\n- Versatile Applications: Enhances navigation, music streaming, and audio content delivery apps for various vehicles and public transport.\n- Seamless Integration with Hardware Volume Keys: Allows unified volume control alongside Volumedeck adjustments.\n- Does not require internet connectivity\n\n## Getting Started with Volumedeck\n\nTo integrate Volumedeck into your iOS app, you must add the Volumedeck framework to your project. You can easily do that using Swift Package Manager (SPM). Through Xcode, go to `Package Dependencies`, click `+` and simply use the URL of this repo. SPM will fetch and add the framework automatically. \n\nAfter adding the framework, follow the steps below to integrate it with your app.\n\n### Step 1: Import VolumedeckiOS\n\nImport the VolumedeckiOS module into your Swift class:\n\n```swift\nimport VolumedeckiOS\n```\n\n### Step 2: Choose Integration Option\n\nInitialize the SDK in your AppDelegate or SceneDelegate:\n\n#### AppDelegate\n\nIt's recommended to initialize the SDK in the `applicationDidBecomeActive` method or later, as the window might not be initialized in the `didFinishLaunchingWithOptions` lifecycle event. Make sure that you avoid initializing Volumedeck multiple times.\n\n```swift\nimport VolumedeckiOS\n\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n\n  var window: UIWindow?\n  var volumedeck: Volumedeck?\n\n  func applicationDidBecomeActive(_ application: UIApplication) {\n    // Initialize Volumedeck\n    volumedeck = volumedeck ?? Volumedeck()\n\n    // Set the status\n    volumedeck?.isOn = true\n  }\n}\n```\n\n#### SceneDelegate\n\nFor applications that support scenes, use the `sceneDidBecomeActive` method or later. Make sure that you avoid initializing Volumedeck multiple times.\n\n```swift\nimport VolumedeckiOS\n\nclass SceneDelegate: UIResponder, UIWindowSceneDelegate {\n\n  var window: UIWindow?\n  var volumedeck: Volumedeck?\n\n  func sceneDidBecomeActive(_ scene: UIScene) {\n    // Initialize Volumedeck\n    volumedeck = volumedeck ?? Volumedeck()\n\n    // Set the status\n    volumedeck?.isOn = true\n  }\n}\n```\n\n### Step 3: Configure your plist\n Add NSLocationWhenInUseUsageDescription in your plist\n\nTo use Volumedeck, you need to add the `NSLocationWhenInUseUsageDescription` key in your app's `Info.plist` file. Provide an appropriate description, such as \"Volumedeck needs to read your current speed.\"\n\n## Run in background\n\nIf you want Volumedeck to run when your app is in the background, follow these steps:\n\n1. Pass the `runInBackground` property when initializing Volumedeck:\n\n```swift\nVolumedeck(runInBackground: true)\n```\n\n2. In the project settings, navigate to \"Signing \u0026 Capabilities,\" add \"Background Modes,\" and check \"Location Updates.\"\n\n## Objective-C\nVolumedeck is fully compatible with `Objective-C`. When using Objective-C you can initialize Volumedeck using:\n\n```objective-c\n@import VolumedeckiOS;\n```\n\n```objective-c\n@property Volumedeck *volumedeck;\n```\n\nand\n\n```objective-c\nif (self.volumedeck == nil) {\n    self.volumedeck = [[Volumedeck alloc] init];\n}\n```\n\n## Free to Use\nVolumedeck SDK is free to use, providing you with the full functionality of the SDK without any time limitations. You are welcome to integrate it into both personal and commercial projects. When using Volumedeck SDK for free, a watermark will be presented during runtime. It is strictly prohibited  to hide, remove, or alter in any way the watermark from the free version of Volumedeck SDK.\n\n### Activation Key and Watermark Removal\nFor those who wish to remove the watermark from their app, we offer an activation key that allows you to use the SDK without any watermarks. However, please be aware that the watermark-free version is not available for free and requires a purchase.\n\nTo inquire about purchasing an activation key or if you have any other questions related to licensing and usage, please contact us at team@navideck.com. We will be happy to assist you with the process and provide you with the necessary information.\n\n## Contact\n\nFor questions or support, please contact us at team@navideck.com. Thank you for choosing Volumedeck SDK!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnavideck%2Fvolumedeck-ios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnavideck%2Fvolumedeck-ios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnavideck%2Fvolumedeck-ios/lists"}