Merge pull request #7 from LinJHS/dev

Author: LinJHS

README.md

@@ -3,7 +3,7 @@
 <div align="center">
 
 [![PyPI version](https://img.shields.io/pypi/v/win-folder-manager.svg?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/win-folder-manager/)
-[![Docker Pulls](https://img.shields.io/docker/pulls/linjhs/manager.svg?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/linjhs/manager)
+[![Docker Pulls](https://img.shields.io/docker/pulls/linjhs/win-folder-manager.svg?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/linjhs/win-folder-manager)
 [![Build Status](https://github.com/LinJHS/win-folder-manager/actions/workflows/publish.yml/badge.svg)](https://github.com/LinJHS/win-folder-manager/actions)
 [![Python Versions](https://img.shields.io/pypi/pyversions/win-folder-manager.svg?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/win-folder-manager/)
 [![License](https://img.shields.io/github/license/LinJHS/win-folder-manager.svg?style=flat-square)](https://github.com/LinJHS/win-folder-manager/blob/main/LICENSE)
@@ -28,6 +28,14 @@
 - 🚀 **Web 界面**：基于 Flask 的简单 UI，通过浏览器即可访问。
 - 💾 **持久化配置**：配置文件自动保存到 `%APPDATA%`，更新不丢失。
 
+## 📸 界面预览
+
+| 管理主页 | 属性编辑 |
+| :---: | :---: |
+| <img src="imgs/02-dashboard.png" width="100%"> | <img src="imgs/03-edit-attributes.png" width="100%"> |
+| **配置页面** | **资源管理器效果** |
+| <img src="imgs/01-configuration.png" width="100%"> | <img src="imgs/04-explorer-preview.png" width="100%"> |
+
 ## 📦 安装
 
 ### 通过 PyPI 安装 (推荐)
@@ -99,7 +107,11 @@ win-folder-manager --no-browser
 您可以使用 Docker 运行 Win Folder Manager。
 
 ```bash
-docker run -d -p 6800:6800 -v /path/to/your/folders:/data linjhs/manager
+docker run -d \
+  -p 6800:6800 \
+  -v /path/to/your/folders:/data \
+  -v win-folder-manager-config:/root/.config/win-folder-manager \
+  linjhs/win-folder-manager
 ```
 
 > **注意**：本应用依赖 Windows 特有的命令 (`attrib`) 来设置文件夹属性（系统/隐藏/只读），这是 `desktop.ini` 自定义生效的必要条件。在 Linux 容器中运行可能会限制部分功能，除非用于特定环境或仅作查看用途。
@@ -121,4 +133,4 @@ docker run -d -p 6800:6800 -v /path/to/your/folders:/data linjhs/manager
 
 ## 📄 许可证
 
-本项目采用 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件。
+本项目采用 GNU General Public License v3.0 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件。

README_EN.md

@@ -3,7 +3,7 @@
 <div align="center">
 
 [![PyPI version](https://img.shields.io/pypi/v/win-folder-manager.svg?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/win-folder-manager/)
-[![Docker Pulls](https://img.shields.io/docker/pulls/linjhs/manager.svg?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/linjhs/manager)
+[![Docker Pulls](https://img.shields.io/docker/pulls/linjhs/win-folder-manager.svg?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/linjhs/win-folder-manager)
 [![Build Status](https://github.com/LinJHS/win-folder-manager/actions/workflows/publish.yml/badge.svg)](https://github.com/LinJHS/win-folder-manager/actions)
 [![Python Versions](https://img.shields.io/pypi/pyversions/win-folder-manager.svg?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/win-folder-manager/)
 [![License](https://img.shields.io/github/license/LinJHS/win-folder-manager.svg?style=flat-square)](https://github.com/LinJHS/win-folder-manager/blob/main/LICENSE)
@@ -28,6 +28,14 @@
 - 🚀 **Web Interface**: Simple Flask-based UI accessible from your browser.
 - 💾 **Persistent Config**: Configuration saved automatically in `%APPDATA%`.
 
+## 📸 Screenshots
+
+| Home Dashboard | Edit Attributes |
+| :---: | :---: |
+| <img src="imgs/02-dashboard.png" width="100%"> | <img src="imgs/03-edit-attributes.png" width="100%"> |
+| **Configuration** | **Explorer Preview** |
+| <img src="imgs/01-configuration.png" width="100%"> | <img src="imgs/04-explorer-preview.png" width="100%"> |
+
 ## 📦 Installation
 
 ### via PyPI (Recommended)
@@ -99,7 +107,11 @@ You can configure the root path to scan for folders directly in the Web UI.
 You can run Win Folder Manager using Docker.
 
 ```bash
-docker run -d -p 6800:6800 -v /path/to/your/folders:/data linjhs/manager
+docker run -d \
+  -p 6800:6800 \
+  -v /path/to/your/folders:/data \
+  -v win-folder-manager-config:/root/.config/win-folder-manager \
+  linjhs/win-folder-manager
 ```
 
 > **Note**: This application relies on Windows-specific commands (`attrib`) to set folder attributes (System/Hidden/ReadOnly) which are required for `desktop.ini` customizations to take effect. Running this in a Linux container may limit functionality unless used in a specific environment or for viewing purposes.
@@ -121,4 +133,4 @@ docker run -d -p 6800:6800 -v /path/to/your/folders:/data linjhs/manager
 
 ## 📄 License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.

imgs/01-configuration.png

@@ -6,7 +6,19 @@
 from .logic import FolderManager
 
 # Use APPDATA for persistent config storage
-APPDATA_DIR = os.path.join(os.environ.get('APPDATA', os.path.expanduser('~')), 'win-folder-manager')
+def get_config_dir():
+    if os.name == 'nt':
+        # Windows: %APPDATA%\win-folder-manager
+        return os.path.join(os.environ.get('APPDATA', os.path.expanduser('~')), 'win-folder-manager')
+    else:
+        # Linux/Docker: ~/.config/win-folder-manager
+        # Respect XDG_CONFIG_HOME
+        xdg_config = os.environ.get('XDG_CONFIG_HOME')
+        if xdg_config:
+            return os.path.join(xdg_config, 'win-folder-manager')
+        return os.path.join(os.path.expanduser('~'), '.config', 'win-folder-manager')
+
+APPDATA_DIR = get_config_dir()
 if not os.path.exists(APPDATA_DIR):
     os.makedirs(APPDATA_DIR)
 

imgs/02-dashboard.png

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Folder Master Pro</title>
+    <title>Win Folder Manager</title>
     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
     <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
     <style>

imgs/03-edit-attributes.png

@@ -19,4 +19,10 @@ def read_requirements():
     install_requires=read_requirements(),
     python_requires='>=3.8',
     entry_points={'console_scripts': ['win-folder-manager=manager.app:main']},
+    license='GPLv3',
+    classifiers=[
+        'License :: OSI Approved :: GNU General Public License v3 (GPLv3)',
+        'Programming Language :: Python :: 3',
+        'Operating System :: Microsoft :: Windows',
+    ],
 )