FolderLens

A modern file and folder navigation, management, and search tool built with PySide6 (Qt for Python).

Features

• File Browser: Tree-based file browser with detailed information (name, type, modified date, size).
• Async Size Calculation: Folder sizes are calculated asynchronously in the background to keep the UI responsive.
• Search & Filter: Real-time search and filtering by file/folder name.
• Multi-language Support: Built-in support for English and Chinese.
• Context Menu: Right-click context menu for file operations (open, delete, copy path, etc.).
• Cross-platform: Works on Windows, macOS, and Linux.

Installation

From PyPI (Recommended)

You can install FolderLens directly from PyPI:

pip install folderlens

From Source (Git)

To install the latest version from the source code:

1. Clone the repository:

   git clone https://github.com/EasyCam/FolderLens.git
   cd FolderLens
   

2. Install the package in editable mode:

   pip install -e .
   

   For development, you can install with development dependencies:

   pip install -e ".[dev]"
   

Usage

Command Line

After installation, you can run FolderLens from the command line:

folderlens

Python Module

You can also run it as a Python module:

python -m folderlens

Or import it in your Python script:

from folderlens.app import main
main()

Screenshots

Open Folder

Change Language

Search

Clear View

Requirements

• Python 3.8+
• PySide6 >= 6.4.0

License

GPLv3 License