BeReal Exporter

This python script doesn't export photos and realmojis from the social media platform BeReal directly for that, you have to make a request to the BeReal see this Reddit post for more information.

It simple processes the data from the BeReal export and exports the images(as well BTS-videos) with added metadata, such as the original date and location.

I'm gonna be upfront and say it's BeReal's fault the dates are wonky on the output files, idk why they chose to save the time like this:

    "takenTime": "2024-12-24T01:27:16.726Z",
    "berealMoment": "2024-12-23T22:39:05.327Z",

instead of the way everyone else always does it with UNIX Epoch time, but it makes it pretty hard to find out what time the picture was taken, and to properly tag the photos with the correct time. Scroll down to arguments and see default-timezone for a little more info.

Installation

1. Clone the repository:

   git clone https://github.com/Lukullul/bereal-exporter.git
   cd bereal-exporter

2. Install the required Python packages:

   pip install -r requirements.txt

3. Ensure you have exiftool installed on your system and set it up as a PATH variable. You can download it here.

Usage

To export your images run the script within the BeReal export folder:

python bereal_exporter.py [OPTIONS]

Options

• -v, --verbose: Explain what is being done.
• -t, --timespan: Exports the given timespan.
  • Valid format: DD.MM.YYYY-DD.MM.YYYY.
  • Wildcards can be used: DD.MM.YYYY-*.
• --exiftool-path: Set the path to the ExifTool executable (needed if it isn't on the $PATH)
• -y, --year: Exports the given year.
• -p, --out-path: Set a custom output path (default is ./out).
• --bereal-path: Set a custom BeReal path (default ./)
• --no-memories: Don't export the memories.
• --no-realmojis: Don't export the realmojis.
• --no-composites: Don't create composites with the front image overlayed on the back.
• --default-timezone "America/New_York": Set fallback timezone, since memories.json has UTC times. This doesn't work the greatest but I do recommend running it with whatever timezone you're in. It goes Lat/Long time finding -> Default Timezone -> UTC or whatever BeReal is providing.

Examples

1. Export data for the year 2022:

   python bereal_exporter.py --year 2022

2. Export data for a specific timespan:

   python bereal_exporter.py --timespan '04.01.2022-31.12.2022'

3. Export data to a custom output path:

   python bereal_exporter.py --path /path/to/output

4. Specify the BeReal export folder:

   python bereal_exporter.py --bereal-path /path/to/export

5. Use portable installed exiftool application:

   python bereal_exporter.py --exiftool-path /path/to/exiftool.exe

6. Export memories only:

   python bereal_exporter.py --no-realmojis

License

This project is licensed under the MIT License. See the LICENSE file for more details.