GitHub - akhilsahuji/backdrop-off: A minimal tool to quickly remove or replace backgrounds from images using AI. Fast, local, privacy-focused, and easy to use.

Backdrop-Off - Bulk Background Remover

A simple and powerful desktop application for removing backgrounds from images with custom background color options.

Features

🖼️ Batch Processing: Process multiple images at once
🎨 Custom Background Colors: Choose any background color using color picker or hex codes
📊 Progress Tracking: Real-time progress bar and image counter
📁 Flexible Input: Browse folders or manually enter paths
🚀 Cross-Platform: Works on Windows, macOS, and Linux
📂 Quick Access: Open output folder directly after processing
🎯 User-Friendly: Clean and intuitive interface

Screenshots

Demo

backdrop-off.mp4

Installation

Prerequisites

Python 3.7 or higher
pip (Python package installer)

Method 1: Install from Source

Clone the repository:

git clone https://github.com/akhilsahuji/backdrop-off.git
cd backdrop-off

Install dependencies:
```
pip install -r requirements.txt
```
Run the application:

Method 2: Download Executable

Pre-built executables for Windows, macOS, and Linux will be available in the Releases section.

Usage

Select Input Folder: Choose the folder containing your images or type the path manually
Select Output Folder: Choose where to save processed images or type the path manually
Choose Background Color:
- Use the color picker button, or
- Enter a hex color code (e.g., #FF0000 for red)
Start Processing: Click "Start Processing" and watch the progress
View Results: Click "Open Output Folder" when processing is complete

Supported Image Formats

JPEG (.jpg, .jpeg)
PNG (.png)

Popular Background Colors

White: #FFFFFF
Black: #000000
Red: #FF0000
Green: #00FF00
Blue: #0000FF
Transparent backgrounds are converted to your chosen solid color

Development

Setting up Development Environment

Clone the repository:

git clone https://github.com/akhilsahuji/backdrop-off.git
cd backdrop-off

Create virtual environment (recommended):

python -m venv venv

# On Windows:
venv\Scripts\activate

# On macOS/Linux:
source venv/bin/activate

Install dependencies:
```
pip install -r requirements.txt
```

Building Executables

To create standalone executables for distribution:

# Install PyInstaller
pip install pyinstaller

# Build executable
pyinstaller --onefile --windowed bg_remover_ui.py

The executable will be created in the dist/ folder.

Dependencies

customtkinter: Modern UI framework
rembg: AI-powered background removal
Pillow (PIL): Image processing
onnxruntime: AI model runtime

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Roadmap

Drag & drop support
Batch rename options
Custom output formats (PNG with transparency)
Image quality settings

Troubleshooting

Common Issues

"No module named 'customtkinter'"

pip install customtkinter

"No module named 'rembg'"

Performance Issues

Processing time depends on image size and quantity
Ensure sufficient RAM (4GB+ recommended)
Close other heavy applications during processing

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

rembg - For the amazing background removal AI
CustomTkinter - For the modern UI framework

Support

If you encounter any issues or have questions:

Check the Issues page
Create a new issue with detailed description
Include your OS, Python version, and error messages

⭐ If you find this project helpful, please give it a star! ⭐