https://github.com/wkaisertexas/ScreenTimeLapse
Take color-accurate timelapses of your screens and cameras on MacOS
https://github.com/wkaisertexas/ScreenTimeLapse
avfoundation macos swiftui
Last synced: 11 months ago
JSON representation
Take color-accurate timelapses of your screens and cameras on MacOS
- Host: GitHub
- URL: https://github.com/wkaisertexas/ScreenTimeLapse
- Owner: wkaisertexas
- License: mit
- Created: 2023-03-06T23:32:59.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-10T23:19:42.000Z (over 1 year ago)
- Last Synced: 2024-11-15T06:42:39.863Z (over 1 year ago)
- Topics: avfoundation, macos, swiftui
- Language: Swift
- Homepage: https://apps.apple.com/us/app/timelapze/id6473860445
- Size: 7.32 MB
- Stars: 777
- Watchers: 8
- Forks: 25
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
TimeLapze
A menu bar application for creating screen and camera timelapses while keeping file sizes manageable
Introduction ·
Features ·
Installation ·
Local Development ·
Tech Stack ·
Contributing
## Introduction
TimeLapze is a minimalist, menu bar application for creating color accurate screen and camera timelapses while keeping file sizes manageable
Color accuracy is an important feature which prevents you from recording washed-out, photocopied-looking time lapses
## Features
- **Color-Accurate**: What you see is what you get. Never screen record faded videos again[^1]
- **Minimalist Design**: a fully featured menu bar recorder
- **Hardware Accelerated**: fully utilized hardware accelerated encoding for a lightweight recording experience
- **Space Saving**: Avoid the excessive file sizes of high quality video (can be as high as 7 GB / hour)
- **Camera Recording**: Record your webcam or phone with the same frame rate and camera speed
- **Secure**: Use the fully features of `ScreenCaptureKit` to only record certain windows, applications and more. Never leak your bank information in recordings again!
- **Customizability**: Change everything from the frame rate, quality and speed multiple
## Installation
### App Store (Recommended)
Get **Timelapse** on the App Store:
[Download on the App Store](https://apps.apple.com/us/app/timelapze/id6473860445)
### Homebrew
Install **TimeLapze** via [Homebrew](https://brew.sh/):
```bash
brew install timelapze
```
### Direct Download
Download the latest version from the [Releases page](https://github.com/wkaisertexas/ScreenTimeLapse/releases).
1. Download `TimeLapze.zip`
2. If Chrome or Safari warns about the file, ignore it
3. Extract the archive to get `TimeLapze.app`
4. Move it to your `Applications` folder
## Local Development
To develop TimeLapze locally, you will need to clone and open this repository in XCode.
Once that's done, you can use the following commands to run the app locally:
```console
git clone https://github.com/wkaisertexas/ScreenTimeLapse
cd ScreenTimeLapse
open TimeLapze.xcodeproj
```
Following this, you need to allow the app to be built for local signing.
## Tech Stack
- [SwiftUI](https://developer.apple.com/documentation/swiftui/)
- [ScreenCaptureKit](https://developer.apple.com/documentation/screencapturekit/)
- [AVFoundation](https://developer.apple.com/av-foundation/)
- [CoreMedia](https://developer.apple.com/documentation/coremedia)
## Contributing
Contributions are welcome! Here's how you can contribute:
- [Open an issue](https://github.com/wkaisertexas/ScreenTimeLapse/issues) if you believe you've encountered a bug
- Submit a [pull request](https://github.com/wkaisertexas/ScreenTimeLapse/pull) to add features, improve usability, or fix bugs
## Repo Activity
## License
TimeLapze is released under the [MIT License](LICENSE), ensuring open-source availability
> [!IMPORTANT]
> If you liked this project, consider giving the repository a star ⭐️!
[^1]: [Apple's screen recorder converts the display's color space](https://community.adobe.com/t5/premiere-pro-discussions/inaccurate-colors-from-desktop-recording/m-p/12168181) from **DCI_P3** to **sRGB**. This subtle error makes it unsuitable for color-sensitive work. Even [HDR video struggles with persistent overexposure issues in screenshots](https://github.com/iina/iina/issues/3866).