Enhanced File Explorer

Table of Contents

• Overview
• Features
• Installation
  • Prerequisites
  • Installation Methods
• Usage
  • Basic Steps
  • Detailed Interface Guide
• How It Works
• Troubleshooting
• Advanced Options
• Contributing
• License

Overview

Enhanced File Explorer is a comprehensive GUI application that provides advanced file management capabilities. It allows you to scan, preview, organize, and manage files across your system with powerful features for handling various file types.

Features

• 🔍 Advanced file scanning with progress tracking and time estimation
• 👁️ Multi-format preview (images, text, PDFs, Word, Excel, PowerPoint)
• 📂 File operations: rename, move, delete, save copies
• 🖼️ Image preview with automatic scaling
• 📄 Document preview for various file types (text, Word, PDF)
• 📊 Data preview for Excel and CSV files
• 🎨 PowerPoint preview with slide content display
• 🔄 Change tracking for renamed and moved files
• ⚡ Quick search and filtering by file type
• 🛡️ Safety features with confirmation dialogs

Installation

Prerequisites

• Node.js (for npm/npx)
• Python 3.6 or later
• Required Python packages (installed automatically)

Installation Methods

Method 1: Global installation (Recommended)

npm install -g enhanced-file-explorer
enhanced-file-explorer

Method 2: Using npx (no installation needed)

npx enhanced-file-explorer

Usage

Basic Steps

1. Launch the application using one of the methods above
2. Select a directory to explore by clicking "Browse" or entering the path manually
3. Click "Scan Files" to start scanning
4. Browse and manage files using the interface
5. Use the preview panel to examine files before taking action

Detailed Interface Guide

1. Directory Selection

• Root Directory: Choose the folder you want to explore
• Search: Quickly find files by name or path
• File Type Filter: Filter by specific file types (Images, Documents, etc.)

2. File Operations

• Select (☐/✔): Toggle file selection for batch actions
• Preview (👁️): Preview the file in the right panel
• Edit (✏️): Rename the file
• Open (📂): Open the file location in system file explorer
• Delete (❌): Delete the file (with confirmation)

3. Batch Actions

• Select All / Deselect All: Quickly manage selections
• Move Selected: Move selected files to another location
• Delete Selected: Permanently delete selected files (confirmation required)
• Save Selected As: Copy selected files to a new location

4. File Preview Tabs

• Info: File metadata and details
• Image: Image preview with zoom (JPEG, PNG, etc.)
• Text: Text/code/Word preview
• Data: Table view for CSV and Excel
• PDF: Page-by-page preview
• Excel: Spreadsheet tab rendering
• PowerPoint: Slide content viewer

How It Works

Scanning Process

• Recursively scans files in selected directory
• Tracks progress and estimates time remaining
• Skips system/hidden files by default
• Gathers detailed metadata for each file

Preview System

• Dynamically loads preview based on file type
• Uses Python libraries for rendering
• Generates temporary HTML for complex files
• Cleans up temporary files automatically

File Management

• Tracks original and modified file paths
• Displays visual indicators for changes
• Handles errors gracefully

Troubleshooting

Common Issues

1. Application won't start:

• Ensure Python 3.6+ is installed and in PATH
• Confirm required Python packages are installed
• On Windows, try running as administrator

2. Preview issues:

• Office files may require Microsoft Office or LibreOffice
• Certain image formats may need additional PIL plugins
• PDFs need system libraries (e.g., Poppler)

3. Performance with large directories:

• May take time depending on file count
• Use filters to reduce scope
• Consider scanning smaller subdirectories

4. Permission errors:

• Ensure proper read/write permissions
• On Linux/macOS, use sudo if needed
• On Windows, check file access rights

Advanced Options

You can adjust the following Python constants at the top of the script:

sys.setrecursionlimit(10000)  # For deeply nested directories
MAX_PREVIEW_SIZE = 10000      # Max preview size for text files

Contributing

Contributions are welcome! Please fork the repository, submit issues, or create pull requests with improvements.

License

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

⚠️ Note: Always exercise caution when performing file operations. The developers are not responsible for data loss.