🔍 CzkawkaWin - Duplicate File Finder

A high-performance Windows desktop application for visualizing and managing duplicate files found by Czkawka. Built with WPF and .NET 10, featuring video preview with FFmpeg integration.

✨ Features

• 📂 JSON Report Viewer: Load and parse Czkawka duplicate file scan results
• 🖼️ Image Preview: View image files directly in the application
• 🎬 Video Preview: Play video files with built-in media player controls
• 🎥 FFmpeg Integration: Generate thumbnails and extract metadata for videos
• ⚡ High Performance: Virtualized lists for handling large datasets
• 📊 Smart Grouping: Organize duplicates by file size with file counts
• 🔎 Detailed Information: View file size, date, video resolution, codec, and frame rate
• 📁 Quick Access: Double-click any file to open its location in Windows Explorer
• 🎨 Modern Dark UI: Clean, professional interface with empty states and status feedback

📸 Screenshots

Empty State

Clean interface when no data is loaded, with helpful instructions for getting started.

Groups and Files View

Browse duplicate groups sorted by file size, with thumbnails for images and videos.

Video Preview

Watch videos directly in the app with playback controls and metadata display.

🚀 Getting Started

Prerequisites

• Windows 10/11 (64-bit)
• .NET 10 Runtime or SDK
• FFmpeg binaries (included in releases)

Installation

Option 1: Download Release

1. Download the latest release from the Releases page
2. Extract the ZIP file
3. Run CzkawkaWin.exe

Option 2: Build from Source

# Clone the repository
git clone https://github.com/SauloVictorS/CzkawkaWin.git
cd CzkawkaWin

# Restore dependencies
dotnet restore

# Build the project
dotnet build --configuration Release

# Run the application
dotnet run --project CzkawkaWin

FFmpeg Setup

The application requires FFmpeg for video thumbnail generation and metadata extraction:

1. Download FFmpeg binaries from ffmpeg.org
2. Extract and place ffmpeg.exe and ffprobe.exe in the ffmpeg/ folder next to the executable:

   CzkawkaWin/
   ├── CzkawkaWin.exe
   └── ffmpeg/
       ├── ffmpeg.exe
       └── ffprobe.exe
   

Note: Release builds include FFmpeg binaries automatically.

📖 Usage

1. Generate Duplicate Report

   • Use Czkawka to scan for duplicates
   • Export results as JSON

2. Load in CzkawkaWin

   • Click "📂 Load JSON Report"
   • Select your Czkawka JSON file
   • Browse duplicate groups in the left panel

3. Review Files

   • Click a group to see all duplicate files
   • Select a file to preview (images/videos)
   • Double-click to open the file location

4. Video Controls

   • Play/Pause/Stop controls for video files
   • Seek bar for navigation
   • Displays video metadata (resolution, codec, fps)

🛠️ Built With

• .NET 10 - Modern cross-platform framework
• WPF - Windows Presentation Foundation
• FFMpegCore - FFmpeg wrapper for .NET
• System.Text.Json - High-performance JSON parsing

📁 Project Structure

CzkawkaWin/
├── CzkawkaWin/
│   ├── MainWindow.xaml          # Main UI layout
│   ├── MainWindow.xaml.cs       # UI logic and event handlers
│   ├── FileItem.cs              # File model with metadata
│   ├── DuplicateGroup.cs        # Group model for duplicates
│   ├── App.xaml                 # Application resources
│   └── CzkawkaWin.csproj        # Project configuration
├── ffmpeg/                      # FFmpeg binaries (runtime)
└── README.md                    # This file

🎯 Roadmap

• Full integration with Czkawka scanning
• File deletion with safety confirmations
• Compare files side-by-side
• Settings panel

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

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

🙏 Acknowledgments

• Czkawka - The powerful duplicate file finder this app complements
• FFmpeg - Multimedia framework for video processing
• FFMpegCore - Excellent .NET wrapper for FFmpeg

---

Note: CzkawkaWin is a viewer/manager for Czkawka results. You still need Czkawka to scan for duplicates.