[软件]Lightweight, stylish FTP file manager (PyQt5) | Dual‑view switching, Dark theme, and flawless Chinese encoding support

**Project Introduction**
This is a modern FTP file manager developed with Python 3 + PyQt5. Many routers, NAS devices, or legacy FTP servers tend to throw 550 errors or display garbled characters when handling Chinese paths, and traditional FTP clients often have outdated interfaces. This project aims to provide a lightweight FTP desktop management tool with an attractive appearance, smooth interactions, and perfect compatibility with Chinese encodings. Internally, it adopts a frameless, fluid rounded‑corner UI architecture, built‑in multithreaded asynchronous transfers, intelligent encoding fallback, and a rich set of quick operations.

—

### I. Core Highlights & Special Features

**Modern UI with Dual Theme Support**
– **Light / Dark minimalist themes**: Seamless one‑click switching, with a design that meets modern desktop aesthetics.
– **Fully frameless, immersive rounded‑corner design**: Custom smooth title bar (supports dragging, minimising, maximising, and closing), with fixes for the common black borders/white edges seen in right‑click menus and dialog boxes on Windows.

**Dual Display View Modes**
– **Detailed list mode**: Provides precise sorting and display of name, file size, modification time, and file type.
– **Large‑icon tiled mode**: Similar to Windows Explorer’s tile view with large thumbnails; you can freely switch by clicking the “View” icon in the toolbar at any time.

**Intelligent Encoding Conversion (Completely Eliminates Chinese Garbled Text / Errors)**
– The underlying FTP client supports automatic fallback between UTF‑8 and GBK encodings. When encountering older FTP servers, it automatically tries alternative encodings, thoroughly resolving issues such as `550 Permission Denied` or `UnicodeDecodeError` caused by Chinese filenames or special characters.

**Unified, Elegant Custom Dialog System**
– Replaces the native crude dialog boxes with consistently styled, frameless rounded‑corner dialogs for new folder creation, renaming, deletion confirmations, and error prompts.
– **Smart rename selection**: When renaming, the input field automatically gains focus and intelligently highlights the main part of the filename (automatically avoiding extensions like `.txt`, `.zip`, etc.).

**Multithreaded Asynchronous Transfer Queue**
– Uploads / downloads run asynchronously in background `QThread` threads, ensuring the interface remains smooth and responsive at all times.
– The sidebar displays real‑time transfer progress bars, current filenames, and live transfer speeds (KB/s, MB/s), with support for one‑click cancellation at any time.
– **Recursive folder transfers**: Supports full‑directory recursive downloads/uploads, preserving the remote and local directory structures.

**Utility Tools & Status Monitoring**
– **Disk capacity monitoring**: Automatically retrieves available / total server capacity (supports `SITE DF` command parsing).
– **Credential saving**: Login credentials are automatically encrypted and saved in a configuration file (`~/.ftp_manager.json`), allowing one‑click reconnection on the next launch.
– **Deep search**: Supports filtering within the current directory as well as asynchronous deep‑scanning across the entire disk.

—

### II. Interface Preview (Partial Feature Showcase)

– **Main interface**: Includes a connection status card, disk capacity bar, quick toolbar, and sidebar with developer information.
– **Quick right‑click menu**: In‑place context menu with rounded corners and semi‑transparent shadows for actions such as Open, Download, Rename, Delete, etc.
– **File view**: Automatically assigns dedicated ICO icons for documents, archives, and folders based on file type.

—

### III. Usage Instructions

1. **Establish a connection**: After launching the software, a login dialog appears. Enter the FTP IP address, port (default 21), username, and password. Check “Remember login credentials” and click Connect.
2. **Switch views**: Click the “View” icon on the left side of the address bar to toggle between **Detailed List View** and **Large‑Icon Tile Mode** at any time.
3. **Rename files**: Right‑click any file/folder and select “Rename”. A uniformly styled dialog appears; after making changes, press Enter to complete the remote rename.
4. **Upload / Download**:
– Use the quick toolbar on the left to click **Upload File** / **Upload Folder**.
– Alternatively, right‑click a single item or hold `Ctrl` to select multiple files, then click **Download File** or **Batch Download Selected**.

—

### Tool Download

**FTP File Manager**
Download link: https://pan.baidu.com/s/1gK3ZDJO2jJwd63KfJlS4Ig?pwd=z46m
Extraction code: z46m
Download link: https://wwaob.lanzouw.com/i1DFo40p9vni

**Note**: This tool is built with Python PyQt5 and runs directly on Windows. It is primarily designed for NAS, routers, and legacy FTP server scenarios, specifically addressing Chinese filename garbled text and 550 errors.