🚀 File-Transfer

A powerful and intuitive file management tool for organizing your files effortlessly

✨ Features

Feature	Description
🔍 Smart Scanning	Recursively scans all subfolders for complete file discovery
📁 Dual Operations	Choose between Move or Copy operations
🔄 Smart Renaming	Automatically handles duplicate files with intelligent naming
📊 Real-time Progress	Live progress tracking with detailed operation summary
🛡️ Safe & Secure	User confirmation before any destructive operations
💾 Zero Dependencies	Built entirely with Python standard library

🎯 Quick Start

Prerequisites

• Python 3.6 or higher
• No additional packages required

Installation

# Clone the repository
git clone https://github.com/xsoltanx/file-transfer.git

# Navigate to project directory
cd file-transfer

Usage

python main.py

Sample Session

Enter source folder path: C:/Users/MyDocuments/Photos
Enter destination folder path: D:/Backup/OrganizedPhotos

Choose operation type:
1. Move (files will be moved from source)
2. Copy (files will be copied, original files remain)

Enter your choice (1 or 2): 2

⚠️  OPERATION CONFIRMATION ⚠️
All files from 'C:/Users/MyDocuments/Photos'
will be COPIED to 'D:/Backup/OrganizedPhotos'!
Operation type: COPY

Are you sure? (y/n): y

🔍 Searching for files...
📊 Number of files found: 147

📁 Copying files...
✅ SUCCESS: 'vacation_photo1.jpg' copied
✅ SUCCESS: 'document.pdf' copied
✅ SUCCESS: 'image.png' copied (with new name: 'image_1.png')
✅ SUCCESS: 'music.mp3' copied

══════════════════════════════════════════════════
📋 OPERATION SUMMARY
══════════════════════════════════════════════════
Operation type: Copy
Total files: 147
Files processed: 147
Files failed: 0
🎉 Operation completed successfully!

Perfect For:

• Organizing downloads folder

• Backing up important documents

• Moving media files to external drives

• Consolidating files from multiple subfolders

• Creating clean project structures

🛠️ Technical Details

Core Functions

• Recursive directory traversal using os.walk()

• Safe file operations with proper exception handling

• Duplicate resolution with incremental numbering

• Progress tracking with real-time feedback

Error Handling

• ✅ File permission errors

• ✅ Disk space issues

• ✅ Invalid path detection

• ✅ Operation cancellation support

Smart Duplicate Handling

# Original: document.pdf
# If exists: document_1.pdf, document_2.pdf, etc.

Operation	Speed	Reliability
File Discovery	⚡ Fast	🛡️ High
Copy Operations	🐢 Moderate	🛡️ High
Move Operations	⚡ Fast	🛡️ High
Error Handling	🛡️ Robust	🛡️ High

🐛 Troubleshooting

Common Issues & Solutions

Issue: "Permission denied" error Solution: Run as administrator or check file permissions

Issue: Path not found Solution: Verify path exists and use correct slashe /

Issue: Operation takes too long Solution: The tool shows real-time progress - be patient for large transfers

⭐ If this project helped you, give it a star! ⭐

Happy file organizing! 🎉