Sora2 Watermark Cleaner (GUI Edition)

Sora2 Watermark Cleaner (GUI) is a graphical application for removing your own technical or test watermarks from images and videos during development or internal workflows.

⚠️ Do not use this tool to remove copyright or ownership watermarks from media you do not own.

---

TABLE OF CONTENTS

1. Features
2. Requirements
3. Installation
4. Launching the GUI
5. GUI Overview
6. Advanced Settings
7. Batch Processing
8. GPU Acceleration
9. Project Structure
10. Development & Testing
11. Troubleshooting
12. Contributing
13. License
14. Example main.py (GUI launcher)

---

FEATURES

• Fully graphical interface (PyQt / Tkinter depending on build)
• Drag & drop images or videos
• Batch folder support
• Real-time preview (before/after)
• Adjustable cleaning strength
• Fast/Standard/Deep modes
• GPU acceleration option
• Progress bar, logs and error reporting
• Saves settings between sessions

---

REQUIREMENTS

Python 3.9+ Recommended: GPU with CUDA (optional)

---

INSTALLATION

git clone https://github.com/ossessd/SoraWatermarkCleaner.git cd SoraWatermarkCleaner pip install -r requirements.txt

---

LAUNCHING THE GUI

python main.py

or if using a packaged build:

./Sora2WatermarkCleaner (Linux) Sora2WatermarkCleaner.exe (Windows) Sora2WatermarkCleaner.app (macOS)

---

GUI OVERVIEW

Main window contains:

1. Input section

   • Drag & drop area
   • “Browse File” and “Browse Folder”
   • Input preview

2. Output section

   • Output path selector
   • Auto-naming mode

3. Processing settings

   • Strength (slider 0–100%)
   • Mode: Fast • Standard • Deep
   • GPU enable switch
   • Preserve folder structure (batch)

4. Real-time preview

   • Before / After toggle
   • Auto-refresh

5. Action buttons

   • “Clean file”
   • “Clean folder”
   • “Stop”

6. Status & logs

   • Progress bar
   • Realtime logs panel
   • Error console

---

ADVANCED SETTINGS

In Settings → Advanced:

• Parallel workers count
• Temporary cache directory
• Preview resolution limit
• Auto-save results
• Auto-open output folder
• Detailed logging

Configuration is stored in:

Windows: %APPDATA%/Sora2WC/config.json
Linux: ~/.config/Sora2WC/config.json
macOS: ~/Library/Application Support/Sora2WC/config.json

---

BATCH PROCESSING

Open the folder in the GUI:

1. Click “Select Folder”
2. Choose processing mode
3. Enable options: • Recursive
   • Preserve file structure
   • Skip unreadable files
4. Click “Start Batch”

The progress bar shows:

• current file
• overall progress
• success/skipped/error count

---

GPU ACCELERATION

Enable by switching “GPU Mode” in the GUI (if supported).

Deep mode is significantly faster with GPU.

If GPU is not detected:

• Check CUDA installation
• Update GPU drivers
• Restart the application

---

DEVELOPMENT & TESTING

pip install -r requirements-dev.txt pytest -q

Linters: black src gui tests flake8 src gui tests

---

TROUBLESHOOTING

Problem: Preview is slow
Fix: Lower preview resolution in Settings

Problem: GPU not detected
Fix: Reinstall CUDA, enable GPU in settings

Problem: Output is distorted
Fix: Reduce strength or switch to Standard mode

Problem: Video fails to export
Fix: Install ffmpeg

---

CONTRIBUTING

1. Fork the repository
2. Create feature branch
3. Add tests
4. Submit PR

---

LICENSE

MIT (or your chosen license)

---