Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: 2 days ago
JSON representation

Take color-accurate timelapses of your screens and cameras on MacOS

Awesome Lists containing this project

README

        

TimeLapze

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


Application demonstration photo in menu bar


TimeLapze is a open-source, minimalist, menu bar application for creating color accurate screen and camera timelapses without enormous file sizes.


color accurate comparision
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 this warning, 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

![Screen Time Lapse Repo Activity](https://repobeats.axiom.co/api/embed/3c10f8fa2ca2324639b9986cb38043750550c993.svg "Repobeats analytics image")

## License

TimeLapze is open-source under the [MIT License](LICENSE/LICENSE).

> [!IMPORTANT]
> 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).