Files
hfbackup/README.md
2025-12-15 03:00:11 +03:00

107 lines
4.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)