HeicConverter项目安装与配置指南

HeicConverter项目安装与配置指南

HeicConverter A very simple command line tool to convert heic files to jpg 项目地址: https://gitcode.com/gh_mirrors/he/HeicConverter

1. 项目基础介绍

HeicConverter是一个简单的命令行工具，用于将HEIC格式的图片转换为JPG格式。它支持递归转换文件夹内的所有HEIC文件，并且可以选择是否保留原文件、覆盖已存在的转换文件、以及调整输出图片的质量。这个项目主要使用Python编程语言开发。

2. 关键技术与框架

项目主要使用Python语言，依赖于Pillow库来处理图像转换。Pillow是一个开源的Python图像处理库，可以用来打开、操作和保存多种不同格式的图像文件。

3. 安装与配置

准备工作

在开始安装之前，请确保您的系统中已经安装了Python。如果没有安装Python，您可以从Python的官方网站下载并安装适合您操作系统的版本。

安装步骤

步骤1：克隆项目仓库

打开命令行（在Windows上是CMD或PowerShell，在Linux或Mac上是终端），使用以下命令克隆仓库：

git clone https://github.com/saschiwy/HeicConverter.git

步骤2：安装依赖

进入项目目录，使用pip安装所需的依赖库：

cd HeicConverter
pip install -r requirements.txt

步骤3：运行命令行工具

在项目目录中，可以通过以下命令运行转换工具：

python heicConverter.py path/to/pictures

其中path/to/pictures是包含HEIC文件的目录路径。

步骤4：可选 - 创建图形界面工具

如果需要使用图形界面工具，可以运行以下命令：

python heicConverterGui.py

步骤5：可选 - 创建可执行文件

如果您希望创建一个可执行文件来简化程序的使用，需要安装pyinstaller，然后运行以下命令：

pip install pyinstaller
python -m PyInstaller --onefile --console heicConverter.py

对于图形界面版本：

python -m PyInstaller --onefile --windowed heicConverterGui.py

这将生成一个可执行文件，您可以在不打开命令行的情况下直接运行。

通过以上步骤，您应该能够成功安装并运行HeicConverter项目。如果您在安装过程中遇到任何问题，可以查看项目的README文件或访问项目在GitHub上的页面以获取帮助。

HeicConverter A very simple command line tool to convert heic files to jpg 项目地址: https://gitcode.com/gh_mirrors/he/HeicConverter