Minimum Disk Space Requirements

TL;DR

Tuple needs at least 32 GB of free disk space in order to operate correctly. Without this much space available, screen sharing sessions may terminate unexpectedly. If you've encountered an error where screen sharing terminated due to low space, you might also have to restart your computer to get Tuple to continue to work properly.

Why?

On macOS, Tuple uses ScreenCaptureKit to capture your screen. ScreenCaptureKit is an API provided by Apple which handles screen capturing in a separate process. For this to work efficiently, it needs to be able to share memory with Tuple.

Tuple does not record your screen or write any intermediate files to disk, but it appears that there are cache files used internally by macOS in order to provide Tuple with image data when we queue data for encoding on the CPU. If replayd , the daemon on macOS responsible for doing this, runs out of disk space when writing its cache, the process will terminate its connection to Tuple prematurely.

This causes other strange side effects, too: macOS may still think screen recording is active even after Tuple is terminated (the side effects of this appear to be worse on macOS 14). If Tuple catches this error while you're sharing your screen, it will attempt to restart replayd - however, in the event that it's unable to do this, you'll also see an error message telling you to restart your machine. Doing so should get replayd back into a good state.

Unfortunately, we do not have control over this behavior on macOS -- the best thing we can do is side step the issue by recommending that you have at least 32 GB of free disk space.

If you've followed our suggestions and still experience issues, please reach out to us with your computer's specs. We could use your help fine tuning our heuristics!