theoneandonlyone / 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 version 3.11)
• pip
• FFmpeg

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.

Privacy Policy

BeReel was developed as an open-source app and gathers information from an unofficial BeReal API from chemokita13. BeReel has no association and responsibility with the API's development and how it accesses user information. See this link for more information about this API Project. 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 and all related images to develop the timelapse can be found in local folders labelled /primary /secondary /combined /static. All videos and images produced from this app is to be considered personal use and should only use accounts owned by the user.

License

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

Buy Me A Coffee!

You like the work here? Feel free to buy me a coffee by following this link

(back to top)

bereel's Issues

Trying to generate classic recap, getting error

Python 3.8
ValueError: Could not find a format to read the specified file in single-image mode

Missing BeReals

Hi, it doesn't seem to download reshared or second and third BeReals from the same day.

Missing requirements

First of all, thank you for this amazing tool. It works like a charm, and I was able to create my 2023 recap (however, I am a Python dev, so it was a bit easier for me).

Missing requirements:

• The script (on macOS) requires ffmpeg to be installed locally. I personally installed it via brew, but for non-developers that would also require to install Brew which might be an additional barrier.

brew install ffmpeg

• The script also requires cv2, that can be easily added to the requirements.txt file and installed via pip.

pip install opencv-python

Finally, for some reason, if the auth-code is inserted automagically via macOS' latest "Autofill from email" feature, the script crashes. The authentication code needs to be input by hand.

I am happy to contribute to the project via PRs and or by writing documentation if you'd like me to, just let me know what's the preferred way of contribution and I'll see what I can do.

Happy New Year!

ImageSequenceClip requires all images to be the same size

Hi, I don't know why this problem came up

Not working for 3-digit country codes

Program failing if an image is broken

Personal Idea: Make the program skip the day in the final video so it doesn't shit itself

Does not work for UK phone numbers

Attempting to login with a UK phone number in the format +44xxxxxxxxxx does not work, and instead returns the error below:

Works perfectly for a random US number.

EOFError on Legacy Rendering

It's because I didn't load a song? If so, this should be pointed before processing.

Anyway, 2023 Classic Rendering worked.

Make this an executable with PyInstaller

We could make this a full-fledged executable easily with pyinstaller. Then more people who don't have a technical background can use it. I only have access to MacOS, so someone else would need to compile it for Windows.