ImageAndVideoBrowser

一个基于 Python 和 PyQt6 开发的高效本地媒体浏览桌面应用。

🌟 主要功能

• 左侧资源管理器：采用树形目录结构，支持 Windows 全盘符切换、文件夹导航及文件自动过滤。
• 全格式媒体预览：
  • 图片浏览：支持常用静态图片格式（JPG, PNG, BMP 等），具备自适应缩放功能。
  • GIF 动图：原生支持 GIF 播放，并支持随窗口尺寸实时调整展示比例。
  • 视频播放：支持常见格式（MP4, AVI, MKV, MOV），具备进度条控制、播放/暂停切换功能。
• 实时信息展示：预览区域上方实时显示当前文件的名称与完整路径。
• 左侧快捷指南：界面左下角集成“软件说明与快捷键”面板，方便新手快速上手。
• 深度递归扫描：选中文件夹时自动异步扫描所有子目录下的媒体文件，确保处理海量数据时界面依然流畅（无假死）。
• 极致交互体验：
  • 快捷切换：支持键盘方向键（←/→）或鼠标滚轮快速查看“上一张/下一张”。
  • 全屏沉浸：支持 F11 一键开启全屏预览，ESC 键快速退出。
  • 播放控制：视频预览状态下，通过空格键即可轻松切换“播放/暂停”。

🚀 如何使用

1. 运行源码（开发模式）

首先确保您的环境中已安装 Python 3.x，然后通过项目提供的 requirements.txt 安装所有依赖库：

pip install -r requirements.txt

运行程序：

2. 运行打包好的程序

进入项目根目录下的 dist 文件夹，双击运行 ImageVideoBrowser.exe 即可直接使用。

🛠️ 编译与打包

本项目使用 PyInstaller 进行单文件打包，方便分发。由于打包工具已包含在 requirements.txt 中，您可以直接执行以下命令：

1. 执行打包命令：

   python -m PyInstaller --onefile --noconsole --icon=app_icon.ico --name ImageVideoBrowser main.py

   • --onefile: 将所有依赖合并为一个 EXE 文件。
   • --noconsole: 运行时不显示命令行窗口。
   • --icon=app_icon.ico: 指定可执行文件的图标（需提前准备图标文件）。
   • 打包完成后，生成的文件将存放在 dist 目录中。

👤 作者信息

• 作者：[fanyuping]
• 版本：v1.0.0
• 项目定位：轻量级、响应迅速的本地多媒体资源管理与预览工具

感谢使用 ImageAndVideoBrowser！如有任何改进建议，欢迎随时反馈。