mirror of
https://github.com/SoPat712/BeReal-Export-Manager.git
synced 2025-08-21 18:28:46 -04:00
79 lines
2.5 KiB
Markdown
79 lines
2.5 KiB
Markdown
# 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](https://www.reddit.com/r/bereal_app/comments/19dl0yk/experiencetutorial_for_exporting_all_bereal/?utm_source=share&utm_medium=web3x&utm_name=web3xcss&utm_term=1&utm_content=share_button) 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.
|
|
|
|
## Installation
|
|
|
|
1. Clone the repository:
|
|
```sh
|
|
git clone https://github.com/Lukullul/bereal-exporter.git
|
|
cd bereal-exporter
|
|
```
|
|
|
|
2. Install the required Python packages:
|
|
```sh
|
|
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](https://exiftool.org/).
|
|
|
|
## Usage
|
|
|
|
To export your images run the script within the BeReal export folder:
|
|
```sh
|
|
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.
|
|
|
|
## Examples
|
|
|
|
1. Export data for the year 2022:
|
|
```sh
|
|
python bereal_exporter.py --year 2022
|
|
```
|
|
|
|
2. Export data for a specific timespan:
|
|
```sh
|
|
python bereal_exporter.py --timespan '04.01.2022-31.12.2022'
|
|
```
|
|
|
|
3. Export data to a custom output path:
|
|
```sh
|
|
python bereal_exporter.py --path /path/to/output
|
|
```
|
|
|
|
4. Specify the BeReal export folder:
|
|
```sh
|
|
python bereal_exporter.py --bereal-path /path/to/export
|
|
```
|
|
|
|
4. Use portable installed exiftool application:
|
|
```sh
|
|
python bereal_exporter.py --exiftool-path /path/to/exiftool.exe
|
|
```
|
|
|
|
5. Export memories only:
|
|
```sh
|
|
python bereal_exporter.py --no-realmojis
|
|
```
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
|