Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Automatic Background Replacement with People Segmentation

Codeship Status for fritzlabs/fritz-sdk-android Twitter

In this app, we create a mask of a person and then replace the background with any picture in the camera gallery.

For the full tutorial, visit our post on Heartbeat.

This example app uses the on-device People Segmentation API for Android.


  • Android Studio 3.2 or above
  • Android device in developer model (USB debugging enabled)

Getting Started

Step 1: Create a Fritz Account

In order to use Fritz, please register for a free account.

Step 2: Clone / Fork the fritz-android-tutorials repository and open the BackgroundReplacementApp app in Android Studio

git clone

In Android Studio, choose "Open an existing Android Studio project" and select BackgroundReplacementApp.

Step 3: Build the Android Studio Project

Select "Build > Make Project" from the top nav. Download any missing libraries if applicable. This should sync the gradle dependencies so give the build a second to complete.

Step 4: Install the app onto your device

With your Android device connected, select Run > Run App from the top nav. When running the app for the first time, you'll have to give permissions to access the camera. After the app is installed and running, take a picture of a person and then after that mask is created, select a photo from your camera gallery to replace the background.

Official Documentation

SDK Documentation

Android API Docs


For any questions or issues, you can:

  • Submit an issue on this repo
  • Go to our Help Center
  • Message us directly in Slack
You can’t perform that action at this time.