https://github.com/jaydeep-godhani/camerabuttonkit
🎥 CameraButtonKit — A customizable camera record button for iOS with long-press recording, animated progress spinner, and tap gesture support. Ideal for short video apps and camera UIs.
https://github.com/jaydeep-godhani/camerabuttonkit
animation button camera camera-button custom-ui gesture ios ios-component ios-library longpress recording spinner swift uikit video-recorder
Last synced: 8 months ago
JSON representation
🎥 CameraButtonKit — A customizable camera record button for iOS with long-press recording, animated progress spinner, and tap gesture support. Ideal for short video apps and camera UIs.
- Host: GitHub
- URL: https://github.com/jaydeep-godhani/camerabuttonkit
- Owner: jaydeep-godhani
- License: mit
- Created: 2025-06-04T11:12:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-04T11:48:07.000Z (about 1 year ago)
- Last Synced: 2025-07-08T12:42:44.206Z (11 months ago)
- Topics: animation, button, camera, camera-button, custom-ui, gesture, ios, ios-component, ios-library, longpress, recording, spinner, swift, uikit, video-recorder
- Language: Swift
- Homepage:
- Size: 34.2 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CameraButtonKit
A customizable and lightweight camera-style record button for iOS, with support for tap, long-press recording, progress spinner animation, and delegate callbacks.
## Features
- 🎥 Long-press to start recording
- 🟢 Tap to trigger single-shot action
- 🌀 Circular animated spinner around button
- ⏱️ Auto-stop after max duration
- ⚠️ Delegate warning if recording is too short
- 🔁 Customizable sizes, colors, and timings
## Requirements
- iOS 13.0+
- Swift 5
- Xcode 12 or higher
## Installation
This is an Xcode project, so you can directly clone or download the project into your workspace.
### Clone the Repository
```bash
git clone https://github.com/jaydeep-godhani/CameraButtonKit.git
```
Alternatively, you can download the project as a ZIP file from the GitHub repository page.
### Integrating into Your Project
To integrate the `CameraButtonView` into your own Xcode project:
1. Download or clone the repository.
2. Copy the contents of the `Source` folder into your project.
3. Add `CameraButtonView` to your storyboard or use it programmatically in your view controllers.
## Usage
```swift
import CameraButtonKit
class ViewController: UIViewController, CameraButtonDelegate {
override func viewDidLoad() {
super.viewDidLoad()
let cameraButton = CameraButtonView(frame: CGRect(x: 0, y: 0, width: 100, height: 100))
cameraButton.center = view.center
cameraButton.delegate = self
view.addSubview(cameraButton)
}
// MARK: - CameraButtonDelegate Methods
func onStartRecord() {
print("Started recording")
}
func onEndRecord() {
print("Finished recording")
}
func onDurationTooShortError() {
print("Recording too short!")
}
func onSingleTap() {
print("Single tap action")
}
func onCancelled() {
print("Recording cancelled")
}
}
```
## Customization
| Property | Description | Default |
| -------------------- | ------------------------------------ | ------- |
| `lineWidth` | Thickness of the spinner | `10` |
| `spinnerLineSpacing` | Gap between button and spinner | `20` |
| `spinnerPadding` | Additional space outside the spinner | `15` |
| `minRecordDuration` | Minimum valid duration in seconds | `0.3` |
| `maxRecordDuration` | Maximum allowed duration | `60.0` |
You can also change the spinner color by updating `spinnerLayer.strokeColor`.
## Contributions
We welcome contributions! If you find a bug, have an idea for a new extension, or want to improve the documentation, feel free to fork the repo and create a pull request.
## License
This project is licensed under the MIT License - see the `LICENSE` file for details.