Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 3 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
- Created: 2023-03-06T23:32:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-28T17:58:06.000Z (7 months ago)
- Last Synced: 2024-07-08T03:33:56.693Z (4 months ago)
- Topics: avfoundation, macos, swiftui
- Language: Swift
- Homepage: https://apps.apple.com/us/app/timelapze/id6473860445
- Size: 7.35 MB
- Stars: 740
- Watchers: 8
- Forks: 21
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE/LICENSE
Awesome Lists containing this project
README
TimeLapze
A open-source menu bar application for creating screen and camera timelapses without excessive file sizes.
Introduction ·
Features ·
Installation ·
Local Development ·
Tech Stack ·
Contributing
## Introduction
TimeLapze is a open-source, minimalist, menu bar application for creating color accurate screen and camera timelapses without enormous file sizes.
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 web recorder in your menu bar
- **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
The recommended way to install **TimeLapze** is through [Homebrew](https://brew.sh/) cask.
```bash
brew install timelapze
```
## Direct Download
If you wish, you can go directly to the [releases page](https://github.com/wkaisertexas/ScreenTimeLapse/releases) and download `TimeLapze.zip`. Both Chrome and Safari give a warning about downloading suspicious files. Ignore then, extract the archive and you should get a `ScreenTimeLapse.app` file. Move that file into your `Applications` directory.
## 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 signining.
## 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
We love our contributors! Here's how you can contribute:
- [Open an issue](https://github.com/wkaisertexas/ScreenTimeLapse/issues) if you believe you've encountered a bug.
- Make a [pull request](https://github.com/wkaisertexas/ScreenTimeLapse/pull) to add new features/make quality-of-life improvements/fix bugs.
## Repo Activity
## License
TimeLapze is open-source under the [MIT License](LICENSE/LICENSE).
> If you liked this project, consider giving the repository a star ⭐️!
[^1]: [Apple's screen recorder convert's 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**. The error is typically subtle, but makes the tool unsuitable for color sensitive work. Color is difficult and even [HDR video have persistent issues with overexposure in screenshots](https://github.com/iina/iina/issues/3866).