hfbackup/README.md

Klasör Yedekleme Aracı / Folder Backup Tool

Türkçe Açıklama

Bu araç, klasörler için Windows sağ tık menüsüne "Yedekle ve Sıkıştır" seçeneği ekler.

Özellikler

• Klasörler ve boş alan için "Yedekle ve Sıkıştır" seçeneğini sağ tık menüsüne ekler
• Zaman damgalı ve numaralandırılmış yedeklemeleri otomatik olarak oluşturur
• WinRAR, 7-Zip veya PowerShell'in yerleşik sıkıştırma özelliğini destekler
• Türkçe karakterleri doğru şekilde işler
• Aynı gün içinde yapılan çoklu yedeklemeler için otomatik numaralandırma
• Geliştirme klasörlerini (node_modules, vendor, vs.) yedeklemeden önce kullanıcıya sorar
• Gelişmiş seçenekler: "Tümünü Dahil Et", "Dev Klasörleri Atla", "İptal"

Kurulum

1. Install.bat dosyasını Yönetici olarak çalıştırın (veya Install.ps1 dosyasını PowerShell ile)
2. Sağ tık menüsü seçeneği hemen kullanılabilir olacak

Kullanım

1. Windows Explorer'da herhangi bir klasörün veya boş alanın üzerine sağ tıklayın
2. "Yedekle ve Sıkıştır" seçeneğini seçin
3. Eğer klasörde geliştirme klasörleri (node_modules, vendor, build, dist, .git, vs.) varsa, üç seçenek sunulur:
   • "Tümünü Dahil Et": Tüm klasörleri yedekler (önceki davranış)
   • "Dev Klasörleri Atla": Geliştirme klasörlerini hariç tutar (yer ve zaman tasarrufu sağlar)
   • "İptal": Yedekleme işlemini iptal eder
4. Yedekleme, aşağıdaki formatta aynı dizinde oluşturulacak: <KlasörAdı>_<YYYYMMDD>_<Numara>.rar (veya WinRAR mevcut değilse .zip)

Kaldırma

1. Uninstall.bat dosyasını Yönetici olarak çalıştırın (veya Uninstall.ps1 dosyasını PowerShell ile)
2. Sağ tık menüsü seçeneği kaldırılacak

Gereksinimler

• Windows 10 veya 11
• PowerShell 5.1 veya sonrası
• İsteğe bağlı: Daha iyi sıkıştırma ve dışlama seçenekleri için WinRAR veya 7-Zip

English Description

Folder Backup Tool

This tool adds a "Yedekle ve Sıkıştır" (Backup and Compress) option to the Windows context menu for folders.

Features

• Adds "Yedekle ve Sıkıştır" option to right-click menu for folders and empty space
• Automatically creates compressed backups with timestamp and numbering
• Supports WinRAR, 7-Zip, or PowerShell's built-in compression
• Handles Turkish characters correctly with ANSI encoding
• Automatic numbering for multiple backups in the same day
• All messages and interface elements are available in both Turkish and English
• Asks user before backing up development folders (node_modules, vendor, etc.)
• Advanced options: "Include All", "Skip Dev Folders", "Cancel"

Installation

1. Run Install.bat as Administrator (or Install.ps1 with PowerShell)
2. The context menu option will be available immediately

Usage

1. Right-click on any folder or in empty space in Windows Explorer
2. Select "Yedekle ve Sıkıştır"
3. If the folder contains development folders (node_modules, vendor, build, dist, .git, etc.), three options are presented:
   • "Tümünü Dahil Et" (Include All): Backs up all folders (previous behavior)
   • "Dev Klasörleri Atla" (Skip Dev Folders): Excludes development folders (saves space and time)
   • "İptal" (Cancel): Cancels the backup operation
4. The backup will be created in the same directory with the format: <FolderName>_<YYYYMMDD>_<Number>.rar (or .zip if WinRAR is not available)

Uninstallation

1. Run Uninstall.bat as Administrator (or Uninstall.ps1 with PowerShell)
2. The context menu option will be removed

Requirements

• Windows 10 or 11
• PowerShell 5.1 or later
• Optional: WinRAR or 7-Zip for better compression and exclusion options

How It Works

The installer adds registry entries that integrate with Windows Explorer context menus. When selected, it runs the PowerShell script that:

1. Determines the next backup number by scanning existing backups
2. Checks for development folders and prompts user for inclusion
3. Uses WinRAR, 7-Zip, or PowerShell's Compress-Archive (in order of preference)
4. Applies exclusion patterns when "Skip Dev Folders" is selected
5. Creates the backup with the proper naming convention
6. Shows success or error messages in Turkish or English

Recent Improvements

• Fixed Turkish character display issues in context menu by using ANSI encoding
• Updated all messages and interface elements to support both Turkish and English
• Improved file naming consistency with proper variable expansion
• Enhanced path handling to compress only selected folder content without full directory paths
• Added admin rights checking for installation and uninstallation scripts
• Added development folder detection and user confirmation before backup
• Added advanced options dialog with "Include All", "Skip Dev Folders", and "Cancel" choices
• Implemented exclusion patterns for WinRAR and 7-Zip (PowerShell limitation noted)