ultimate-watermark-remover-gui - GitLite

KO | EN

gitlite — search

#c #machine-learning #sql #redis #framework #open-source #rag #computer-vision #android #macos

ultimate-watermark-remover-gui

(★ 39)

©️✔️ GUI for a Watermark Remover for video or image using multiple opensource models🌟 Star if you like it! 🌟

File Explorer

ZIP Download

- FUNDING.yml
- banner.svg
- logo-full.png
- logo.png
- newlogo_mask.png
- notebookllm_mask.png
- __init__.py
- main.py
- utils.py
- worker.py
- clip-pre.mp4
- sample_video.mp4
.gitignore
.python-version
__version__.py
CONTRIBUTING.md
install_packages.bat
LICENSE
README.md
remwm_lama_florence2.py
requirements.txt
setup.bat
setup.ps1
test_gui.py
UltimateWatermarkRemover.spec

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`pyenv`

View Details ▼

Switch between multiple versions of Python easily.
See also: `asdf`.

pyenv commands

List all available commands:

pyenv versions

List all Python versions under the `${PYENV_ROOT}/versions` directory:

pyenv install --list

List all Python versions that can be installed from upstream:

🔍

`python`

View Details ▼

Python language interpreter.

python

Start a REPL (interactive shell):

python {{path/to/file.py}}

Execute a specific Python file:

python -i {{path/to/file.py}}

Execute a specific Python file and start a REPL:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="assets/banner.svg" alt="Ultimate Watermark Remover Banner" width="100%">
</p>

<p align="center">
  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
  <a href="https://www.python.org/downloads/release/python-3114/"><img alt="Python Version" src="https://img.shields.io/badge/Python-3.11.4-blue.svg" /></a>
  <a href="https://doc.qt.io/qtforpython/PySide6/index.html"><img alt="Built with PySide6" src="https://img.shields.io/badge/Built_with-PySide6-green.svg" /></a>
  <a href="https://opencv.org/"><img alt="Powered by OpenCV" src="https://img.shields.io/badge/Powered_by-OpenCV-orange.svg" /></a>
  <a href="https://ffmpeg.org/"><img alt="Uses FFmpeg" src="https://img.shields.io/badge/Uses-FFmpeg-red.svg" /></a>
  <a href="https://github.com/ishandutta2007/ultimate-watermark-remover-gui/stargazers"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/ishandutta2007/ultimate-watermark-remover-gui?style=social" /></a>
  <a href="https://github.com/ishandutta2007/ultimate-watermark-remover-gui/network/members"><img alt="GitHub Forks" src="https://img.shields.io/github/forks/ishandutta2007/ultimate-watermark-remover-gui?style=social" /></a>
  <a href="https://github.com/ishandutta2007"><img alt="GitHub followers" src="https://img.shields.io/github/followers/ishandutta2007?label=Follow" /></a>
</p>

---

## 🚀 Project Overview

Tired of intrusive watermarks degrading your precious photos and videos? The **Ultimate Watermark Remover GUI** is your go-to, powerful, and absolutely **free open-source desktop application**! 🚀 Designed with simplicity and efficiency in mind, it seamlessly erases unwanted watermarks from both images and videos.

Built with Python and PySide6, this intuitive tool provides a robust solution for content creators, photographers, and anyone looking to enhance their media. Whether it's a pesky logo, distracting text, or any overlay, our advanced processing engine, powered by the mighty 🧠 **OpenCV** and versatile 🎬 **FFmpeg**, delivers pristine, watermark-free results.

---

## ✨ Key Features

-   **Intelligent Watermark Removal** 🎨: Leveraging cutting-edge OpenCV inpainting algorithms, our tool expertly identifies and reconstructs areas covered by watermarks, ensuring natural-looking results.
-   **Broad Image Support** 🖼️: Process popular image formats including `.png`, `.jpg`, `.jpeg`, `.bmp`, and `.gif` with ease.
-   **Seamless Video Cleaning** 🎥: Remove watermarks from your favorite video formats suchs as `.mp4`, `.avi`, `.mov`, and `.mkv` through efficient frame-by-frame processing.
-   **Automatic Audio Preservation** 🎧: For video processing, the original audio track is intelligently extracted and perfectly re-merged with your watermark-free video, keeping your content's integrity intact.
-   **Modern & Intuitive GUI** 🖥️: Enjoy a sleek, dark-themed interface crafted with PySide6, offering a straightforward and pleasant user experience for all your media cleaning tasks.
-   **Cross-Platform Power** 🌐: Written in Python, this application runs smoothly across Windows, macOS, and Linux environments.
-   **100% Open-Source & Free** 💖: Empower yourself with a high-quality tool at no cost. Modify, distribute, and contribute freely!
-   **Granular Progress Tracking** 📈: Stay informed with real-time updates showcasing distinct processing stages:
    *   **Extracting frames** 🎞️
    *   **Unmasking each frame** ✨
    *   **Extracting audio** 🎤
    *   **Consolidating video and audio** 🔗

---

## 🎯 Goals

Our core mission with the **Ultimate Watermark Remover GUI** is to offer an accessible, reliable, and highly efficient solution for watermark removal. We're dedicated to helping users restore the original beauty of their visual content.

---

## 💻 Installation

For detailed setup instructions, including Python environment configuration, FFmpeg installation, and building from source, please refer to our [CONTRIBUTING.md](CONTRIBUTING.md) guide.

---

## ▶️ Usage

### 🛠️ Setup

Before running the application, ensure you have Python 3.11.4 installed and the required libraries:

1.  **Install Python 3.11.4 via pyenv**:
    ```bash
    pyenv install 3.11.4
    pyenv local 3.11.4
    ```
2.  **Install Dependencies**:
    ```bash
    python -m pip install -r requirements.txt
    ```

### 🚀 Running the Application

Choose the mode that best fits your needs:

#### 1. Graphical User Interface (GUI)
Recommended for most users. This launches the intuitive desktop application for manual selection and processing.
```bash
python src/main.py
```

#### 2. Advanced CLI Processing (Automated)
Recommended for power users or those wanting to leverage automated watermark detection (Florence-2) and advanced inpainting (LaMa).
```bash
python remwm_lama_florence2.py .\videos\clip-pre.mp4
```

### 🖼️ See it in action!
*(**TODO**: Insert a GIF demonstrating the application's usage here.
A short GIF showing:
1.  Opening the app.
2.  Selecting a media file (image or video).
3.  Selecting a watermark mask.
4.  Clicking "Start Processing".
5.  Showing the progress bar and stage updates.
6.  Briefly showing the output.
This will greatly enhance user understanding and engagement!)*

Once the GUI appears, follow these simple steps:
1.  **Select Watermark Template** 🏷️: Provide an image file that serves as a mask for the watermark you wish to remove. This guides the application in identifying the target.
2.  **Select Media to be Edited** 📁: Choose your target image or video file (e.g., `.png`, `.jpg`, `.mp4`, etc.).
3.  **Start Processing** ▶️: Click the dedicated "Start Processing" button.

Observe the real-time logs and dynamic progress updates. Upon completion, your watermark-free file will be conveniently saved in the same directory as your original media, clearly identified with an `_unmasked` suffix.

---

## 🚀 Getting Started

### Non-Technical Users (Pre-built Executables) 🎁

If you're not comfortable with command-line tools or Python environments, pre-built, ready-to-use executable files (like `UltimateWatermarkRemover_v2.0.0.exe`) for Windows are available directly from the project's [GitHub Releases page](https://github.com/ishandutta2007/ultimate-watermark-remover-gui/releases). Simply download the latest version, extract it, and double-click the executable to launch the application!

### Developers & Contributors

For setup, installation from source, and building instructions, please see [CONTRIBUTING.md](CONTRIBUTING.md).

---

## ⚙️ How It Works

The **Ultimate Watermark Remover GUI** orchestrates a sophisticated, multi-stage process to achieve impeccable watermark removal:

1.  **Input & Precise Masking** 🎯: You provide both the media file and a crucial watermark template (mask). This mask is instrumental for OpenCV's inpainting algorithm, ensuring accurate identification and removal of unwanted elements.
2.  **Intelligent Video Frame Extraction** (for Videos) 🎞️: When a video file is supplied, it's meticulously broken down into its constituent frames. Each frame is then treated as an individual image for processing.
3.  **Advanced Watermark Inpainting** ✨: For every frame (or the standalone image), OpenCV's powerful inpainting algorithm is applied using the provided mask. This intelligently reconstructs the masked area based on surrounding pixel data, effectively "erasing" the watermark seamlessly.
4.  **Flawless Audio Extraction & Re-integration** (for Videos) 🎤🔗: Simultaneously, if a video is being processed, FFmpeg efficiently extracts its original audio track. Once all video frames are unmasked and reassembled into a new silent video, FFmpeg then precisely merges this pristine video stream with the preserved original audio track, ensuring perfect synchronization.
5.  **Clean Output** ✅: The final, watermark-free image or video (complete with audio, if applicable) is then saved, ready for immediate use.

---

## 🤝 Contributing

Your contributions make this project even better! We warmly welcome ideas, bug reports, and code contributions. Here's how you can help:
*   **Report Issues** 🐞: Open an issue on our [GitHub repository](https://github.com/ishandutta2007/ultimate-watermark-remover-gui/issues) for any bugs, suggestions, or feature requests.
*   **Submit Pull Requests** 💡: Share your improvements by submitting a Pull Request. Please ensure your code aligns with our project's coding standards.

---

## 📄 License
This project is proudly released under the generous [MIT License](LICENSE). Feel free to explore, modify, and innovate!

---

## ❓ Support

Got questions? Encountered a snag? Need assistance?
Please visit our [GitHub Issues page](https://github.com/ishandutta2007/ultimate-watermark-remover-gui/issues) for help and discussions. We're here to support you!

---

### ✨ Star History

[![Star History Chart](https://api.star-history.com/svg?repos=ishandutta2007/ultimate-watermark-remover-gui&type=date&legend=top-left)](https://www.star-history.com/#ishandutta2007/ultimate-watermark-remover-gui&type=date&legend=top-left)