BeReal Studio 📸 🎬

Unified, Local-First Desktop Suite for BeReal GDPR Data Exports

Explore your memories in a feed, calendar, and map; restore and export photos; and create music-synchronized recap videos on your own computer.

📥 Downloads & Installation

Download the official standalone release for your platform from the Latest Release Page:

Platform	Format / Architecture	Direct Download Link
Windows	`.exe` (64-bit NSIS Setup)	⬇️ Download for Windows (Installer)
Windows	`.exe` (64-bit Standalone)	⬇️ Download for Windows (Portable)
macOS	`.dmg` (Apple Silicon M1/M2/M3/M4)	⬇️ Download for macOS (Apple Silicon .dmg)
macOS	`.app.tar.gz` (Apple Silicon .app Bundle)	⬇️ Download for macOS (.app Bundle)
Linux	`.AppImage` (x86_64 Universal)	⬇️ Download for Linux (.AppImage)
Linux	`.deb` (Debian / Ubuntu x86_64)	⬇️ Download for Linux (.deb)

💡 Looking for earlier releases, source archives, or release notes? Explore all GitHub Releases.

Read the plain-language changelog or the full v2.6.0 release notes.

⚡ Prerequisites & External Tools

BeReal Studio is engineered with native Rust algorithms to minimize dependencies. Depending on the features you use:

Tool	Status	Purpose	Installation
FFmpeg	Required for Videos	Rendering recap videos (`.mp4`), audio sync, and video PIP compositing.	• Windows: `winget install Gyan.FFmpeg` • macOS: `brew install ffmpeg` • Linux: `sudo apt install ffmpeg`
ExifTool	Optional / Recommended	Extended photo and video metadata. Apple Live Photo pairing metadata does not require ExifTool; FFmpeg is required to create its paired `.mov`.	• Windows: `winget install OliverBetz.ExifTool` • macOS: `brew install exiftool` • Linux: `sudo apt install libimage-exiftool-perl`

🔍 You can check and verify your system's FFmpeg and ExifTool status anytime inside BeReal Studio under Settings ⚙️ → System & Dependencies.

🖼️ Application Showcase

🏠 Home	📱 Memories

📅 Memories calendar	🗺️ Map overview

📍 Photo pins on the map	🖼️ Gallery for a busy place

📸 Photo processing	🎬 Recap videos

✨ Key Features

📱 Memories Explorer

Browse your archive as photo cards, a monthly calendar, or a continuous feed.
Swap the two cameras, move the selfie inset, and play behind-the-scenes clips.
Search by caption, date, or place; filter by media type and location.
Save one memory as a combined photo or video, an individual camera view, or a motion photo.

🗺️ Map Viewer

See memories with saved locations as photo pins, nearby groups, and a density view. Open a place to browse its photos.
Start from a location label on a memory to jump to its spot on the map.
The world map works offline. Detailed street tiles are optional with your own MapTiler key; MapTiler receives the viewed area and your IP address, while your photos stay on your device.

📸 Photo Processing Suite

Restore capture dates, locations, and captions; keep late posts with their correct BeReal day.
Export both cameras in picture-in-picture or side-by-side layouts, with the main or selfie camera as the background.
Make Samsung or Google motion photos, or Apple Live Photo packages for Mac Photos. Live Photo export needs a behind-the-scenes clip and FFmpeg; see the Mac import guide.
Choose a date range and process a batch of photos together.

🎬 Recap Video Generator

Turn selected memories into a video paced to your music, with adjustable timing and a waveform preview.
Add dates and locations to slides and preview the sequence before rendering.
Keep photo batches and video renders running in the background.

📋 How to Download Your Archive from BeReal

Open the BeReal mobile app and tap your Profile icon (bottom-right).
Tap the Settings icon (top-right).
Tap Help → Select Contact Us.
Select Ask a Question → Tap Troubleshooting → Tap Other.
Tap Contact Us at the bottom → Select the Topic dropdown.
Select "I'd like to request a copy of my data".
Type a message with at least 10 characters (e.g., "Please provide a copy of my account data") and submit.
BeReal will deliver a secure download link via email containing your official archive ZIP (including posts.json and all media).
Once downloaded, select the ZIP or unzipped folder directly in BeReal Studio.

🛠️ Prerequisites (For Building from Source)

Rust Toolchain:
- Install via rustup.rs (Rust 1.78+ recommended).
Package Manager & JavaScript Runtime:
- Bun (Recommended for ultra-fast startup): Install via bun.sh (powershell -c "irm bun.sh/install.ps1 | iex").
- NPM / PNPM / Yarn (Fully Supported): Standard Node.js v18+ environment works out-of-the-box.
FFmpeg (For Recap Video & Apple Live Photos):
- Required for video slideshow encoding, dual-video PIP overlays, and Apple Live Photo MOV creation.
- Windows: winget install Gyan.FFmpeg or download from ffmpeg.org.
- macOS: brew install ffmpeg
- Linux: sudo apt install ffmpeg

🚀 Running Locally

You can use Bun (recommended) or NPM / PNPM / Yarn:

Option A: Using Bun (Fastest)

# Install dependencies
bun install

# Start local desktop development server
bun run tauri dev

Option B: Using NPM

# Install dependencies
npm install

# Start local desktop development server
npm run tauri dev

📦 Building & Packaging

To compile a self-contained release executable and installer for your operating system:

# With Bun
bun run tauri build

# With NPM
npm run tauri build

Build Artifact Locations:

Windows: src-tauri/target/release/bundle/nsis/BeReal Studio_2.6.0_x64-setup.exe or src-tauri/target/release/bereal-studio.exe
macOS: src-tauri/target/release/bundle/dmg/BeReal Studio_2.6.0_aarch64.dmg or src-tauri/target/release/bundle/macos/BeReal Studio.app
Linux: src-tauri/target/release/bundle/deb/BeReal Studio_2.6.0_amd64.deb or appimage/BeReal Studio_2.6.0_amd64.AppImage

🧪 Testing & Verification

# Run Svelte & TypeScript diagnostics
bun run check
# or: npm run check

# Run Rust unit tests and benchmark suite
cargo test --manifest-path src-tauri/Cargo.toml

🏗️ Architecture & Directory Structure

BeRealStudio/
├── src/                                    # Frontend (SvelteKit SPA + TypeScript)
│   ├── app.html                            # Root HTML & Inter font imports
│   ├── styles/global.css                   # Custom dark design system tokens & font-faces
│   ├── lib/
│   │   ├── types.ts                        # TypeScript models & IPC interfaces
│   │   ├── tauri.ts                        # Tauri IPC bridge & typed event listeners
│   │   ├── stores.ts                       # Svelte reactive state stores
│   │   ├── memoriesStore.ts                # Memories explorer state & live compound filtering
│   │   └── fonts.ts                        # Curated built-in font definitions
│   ├── components/                         # Reusable UI Component Suite
│   │   ├── NavBar.svelte                   # Top navigation bar (Home, Photos, Recap, Settings, About)
│   │   ├── Toggle.svelte                   # Animated on/off switch
│   │   ├── Slider.svelte                   # Value range slider with value pill
│   │   ├── FilePicker.svelte               # Native folder & file dialog wrapper
│   │   ├── DateRangePicker.svelte          # Dual date pickers with monthly density histogram
│   │   ├── ProgressBar.svelte              # Streaming progress indicator
│   │   ├── LogConsole.svelte               # Color-coded live terminal log
│   │   ├── ErrorModal.svelte               # Categorized error overlay
│   │   ├── FontPicker.svelte               # Curated 7-font dropdown selector
│   │   ├── RuleEditor.svelte               # Reverse geocoding rules editor
│   │   └── memories/                       # Memories & Explorer Component Suite
│   │       ├── MemoriesGrid.svelte         # Responsive memory card grid & full-height scrubber
│   │       ├── CalendarGrid.svelte         # Interactive monthly calendar with sticky navigation
│   │       ├── DualCameraFrame.svelte      # Dual-camera frame with click-to-swap & movable PIP
│   │       ├── MemoryFeedModal.svelte      # Fullscreen continuous vertical scroll feed
│   │       ├── MemoryFilterBar.svelte      # Live compound search & dimension filters
│   │       ├── MemoryActionMenu.svelte     # Memory 3-dot dropdown menu
│   │       ├── MemoryContextMenu.svelte    # Right-click context menu
│   │       └── ExportMemoryModal.svelte    # Single-memory export dialog (Apple Live Photo & Motion Photo)
│   ├── views/                              # Application Primary Views
│   │   ├── Home.svelte                     # Main dashboard with hero & feature cards
│   │   ├── MemoriesView.svelte             # Native Memories & Calendar Explorer View
│   │   ├── ToolkitConfig.svelte            # Photo processing configuration view
│   │   ├── RecapperConfig.svelte           # Recap video configuration view with live preview
│   │   ├── Activity.svelte                 # Parallel active operations & generation history
│   │   ├── Processing.svelte               # Real-time progress & live streaming log view
│   │   ├── Complete.svelte                 # Summary metrics, output opener & log exporter
│   │   ├── Settings.svelte                 # Global defaults, FFmpeg detection & inspector tools
│   │   └── About.svelte                    # Privacy manifesto, authoring & open source credits
│   └── routes/+page.svelte                 # SPA root page router
│
├── src-tauri/                              # Rust Backend (Tauri v2)
│   ├── Cargo.toml                          # Native dependencies (image, img-parts, symphonia, rayon, etc.)
│   ├── tauri.conf.json                     # Desktop window & plugin configuration
│   ├── capabilities/default.json           # Tauri v2 security capabilities
│   ├── tests/
│   │   └── benchmark_suite.rs              # End-to-end performance benchmarking harness
│   └── src/
│       ├── main.rs & lib.rs                # Tauri entry & command registration
│       ├── state.rs                        # Global state, ProgressEmitter & log buffer
│       ├── commands/                       # IPC Command Handlers
│       │   ├── archive.rs                  # scan_archive, extract_zip (streaming)
│       │   ├── toolkit.rs                  # start_toolkit, cancel_toolkit (Rayon multi-core)
│       │   ├── recapper.rs                 # start_recapper, cancel_recapper
│       │   ├── explorer.rs                 # load_memories, export_single_memory (Live Photo & Motion Photo)
│       │   ├── settings.rs                 # load_settings, save_settings, reset_settings
│       │   ├── system.rs                   # show_in_folder, check_ffmpeg, offline geodb, analyze_audio
│       │   └── debug.rs                    # export_debug_log, get_debug_logs
│       ├── pipeline/                       # Photo Processing Logic
│       │   ├── parser.rs                   # Authoritative dataset fusion & moment registry
│       │   ├── image_ops.rs                # Format conversion, PIP & Side-by-Side compositing
│       │   ├── exif_writer.rs              # Lossless EXIF & IPTC JPEG segment injection
│       │   ├── live_photo.rs               # Apple Photos Live Photo pair (.jpg + .mov) generator
│       │   ├── motion_photo.rs             # Samsung SEFH/SEFT binary muxer & GCamera XMP
│       │   ├── video_ops.rs                # FFmpeg dual-video PIP overlay
│       │   ├── date_filter.rs              # Range filtering & density distribution
│       │   └── cleanup.rs                  # Intermediate artifact cleanup
│       └── recapper/                       # Recap Video Engine
│           ├── audio.rs                    # Symphonia audio decoding & waveform analysis
│           ├── timing.rs                   # Quadratic ramp / even timing curves
│           ├── geocoder.rs                 # Nominatim reverse geocoding & offline GeoDB
│           ├── location_rules.rs           # Country-specific location formatting engine
│           ├── font_resolver.rs            # Built-in font resolver & disk loader
│           ├── frame_renderer.rs           # Image resize & text overlay with shadows
│           └── video_encoder.rs            # Zero-copy raw RGB frame piping to FFmpeg stdin
├── package.json                            # App manifest & dependencies (v2.6.0)
└── README.md                               # User documentation & GDPR guide

🗺️ Future Roadmap & Upcoming Features

📅 Native BeReal-Style Memories & Calendar Viewer (Completed in v2.0.0 & v2.3.0):
- Monthly Memories Calendar Matrix with day thumbnails, late badges, and retake counters.
- Interactive Feed & Lightbox with front/back camera click-to-swap and movable PIP.
- Multi-dimensional search, hierarchical location drawers, and single-memory exports.
- Smooth 1:1 pointer drag panning and zoom controls for high-res photo and video exploration.
- Full Video BeReal support with synchronized dual-video playback and Side-by-Side MP4 combining.
🍏 Apple Photos Live Photos Compatibility:
- Export paired still image (.jpg) and video (.mov) files with matching Apple Content Identifier UUID (MakerApple:17 and com.apple.quicktime.content.identifier). A packaged export imported as one Live Photo on macOS 26.
🎬 Recap Video Library & Gallery Viewer:
- In-app gallery indexing all rendered recap MP4s with playback preview, waveform scrubber, and quick actions ("Open in Player", "Show in Explorer").

💖 Credits & Open Source Lineage

BeReal Studio is authored and maintained by NotToxel (GitHub Repository).

It unifies, rewrites, and modernizes the core capabilities of three pioneer open-source projects into a single, high-performance desktop application:

BeReel (by @theOneAndOnlyOne) — Creator of the music-synchronized BeReal recap video generator.
BeReal-GDPR-Photo-Toolkit (by @hatobi) — Pioneer of BeReal GDPR archive extraction, EXIF metadata restoration, and Picture-in-Picture photo compositing.
makelive (Make Live) (by @RhetTbull) — Reference implementation for pairing still photos and videos using matching Apple content identifiers.

📜 License

BeReal Studio is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). See the full license.

You can use, share, and modify the app under that license.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
docs		docs
scripts		scripts
src-tauri		src-tauri
src		src
static		static
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
app-icon.svg		app-icon.svg
bun.lock		bun.lock
package.json		package.json
svelte.config.js		svelte.config.js
tsconfig.json		tsconfig.json
vite.config.js		vite.config.js

Navigation Menu

Repository files navigation

BeReal Studio 📸 🎬

Unified, Local-First Desktop Suite for BeReal GDPR Data Exports

📥 Downloads & Installation

⚡ Prerequisites & External Tools

🖼️ Application Showcase

✨ Key Features

📱 Memories Explorer

🗺️ Map Viewer

📸 Photo Processing Suite

🎬 Recap Video Generator

📋 How to Download Your Archive from BeReal

🛠️ Prerequisites (For Building from Source)

🚀 Running Locally

Option A: Using Bun (Fastest)

Option B: Using NPM

📦 Building & Packaging

Build Artifact Locations:

🧪 Testing & Verification

🏗️ Architecture & Directory Structure

🗺️ Future Roadmap & Upcoming Features

💖 Credits & Open Source Lineage

📜 License

About

Releases

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

BeReal Studio 📸 🎬

Unified, Local-First Desktop Suite for BeReal GDPR Data Exports

📥 Downloads & Installation

⚡ Prerequisites & External Tools

🖼️ Application Showcase

✨ Key Features

📱 Memories Explorer

🗺️ Map Viewer

📸 Photo Processing Suite

🎬 Recap Video Generator

📋 How to Download Your Archive from BeReal

🛠️ Prerequisites (For Building from Source)

🚀 Running Locally

Option A: Using Bun (Fastest)

Option B: Using NPM

📦 Building & Packaging

Build Artifact Locations:

🧪 Testing & Verification

🏗️ Architecture & Directory Structure

🗺️ Future Roadmap & Upcoming Features

💖 Credits & Open Source Lineage

📜 License

About

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages