karatekhd/bereel

Generate a custom timelapse of all your memories from BeReal

BeReel:

Miss the Timelapse Recap feature from ReReal? Introducing BeReel. A Flask-based webtool that gives you a customized timelapse of your favourite BeReal memories.

• Implements a BeReal API to fetch user memories in a usable format
• Fetch Memories at a specified date range
• Renders using many open source libraries and fully customizable (with many features to come
• Create a timelapsed that syncs with the .WAV audio

Getting Started

Follow these instructions to get your project up and running.

Prerequisites

Make sure you have the following installed on your machine:

• Python (Only compatible with versions <3.12)
• pip

Installing Dependencies

Run all required libraries and run the app:

pip install -r requirements.txt --user
python main.py

The Flask app will be available on http://localhost:5000/. Multiple folders will be created to pull all image data from your memories

Project Structure

• main.py: Main flask app and drives webpage and API requests
• combineImages.py: processes photos to be used for the slideshow
• generateSlideshow.py: rendering timelapse video and audio

Current Developments

• Add 'no sound' option
• Display RealMoji
• Toggle Date Label setting
• Show render progress from terminal->webpage

Remarks

This project wouldn't be here without the amazing work by chemokita13. Please give him a star.

This app is to be run locally as to comply with user security laws and privacy. Under no cases does this app store metadata elsewhere. The app utilizes this third-party API which may not be following terms set by BeReal, all videos and images produced from this app is to be considered personal use and should only use accounts owned by the user: If the company has particular issues, please submit a request via links in my profile.

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)