Metadata-Version: 2.4
Name: folderlens
Version: 1.0.0
Summary: A modern file and folder navigation, management and search tool
Author-email: Frederick <wedonotuse@outlook.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/EasyCam/FolderLens
Project-URL: Repository, https://github.com/EasyCam/FolderLens.git
Project-URL: Issues, https://github.com/EasyCam/FolderLens/issues
Keywords: file,folder,browser,search,gui,qt,pyside
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment :: File Managers
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6>=6.4.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# FolderLens

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

一个基于 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 / 文件夹大小在后台异步计算
- **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) / 右键菜单进行文件操作（打开、删除）
- **Cross-platform 跨平台**: Works on Windows, macOS, and Linux / 支持 Windows、macOS 和 Linux

## Installation 安装

### From PyPI (Recommended 推荐)

```bash
pip install folderlens
```

### From Source 从源码安装

```bash
git clone https://github.com/EasyCam/FolderLens.git
cd FolderLens
pip install -e .
```

### For Development 开发模式安装

```bash
pip install -e ".[dev]"
```

## Usage 使用方法

### Command Line 命令行

```bash
folderlens
```

### As a Python Module 作为 Python 模块

```python
from folderlens import main
main()
```

Or run directly:

```bash
python -m folderlens
```

## Requirements 依赖

- Python 3.8+
- PySide6 >= 6.4.0

## Development 开发

### Build Package 构建包

```bash
python -m build
```

### Upload to PyPI 上传到 PyPI

```bash
twine upload dist/*
```

## License 许可证

MIT License

## Author 作者

Frederick
