佛系程序员_ 实践：Windows系统上运行的AVIF转JPG工具

学习笔记

网站开发

发布日期: 2025-11-27 17:21:55

喜欢量: 6 个

阅读次数: 57

AVIF转JPG工具

## 需求1
创建一个可以在Windows系统上运行的AVIF转JPG工具，用户只需双击运行即可使用。这个工具包含图形界面，允许用户选择目录并批量转换文件。

文中有下载此工具链接。

此工具下载地址：（此工具需win10/11系统）
https://cdn-media.yyii.info/mp4/2025/1127.rar

在线转换的两个网站：
https://www.freeconvert.com/zh/avif-to-jpg/download
https://gitcobra.github.io/avif2jpeg/dist/zh/

批量下载网页图片的工具：
```
1.76 b@a.Ag 02/06 vsr:/ Edge浏览器ImageAssistant的安装和使用的安装 Microsoft Edge的神级插件，网页批量图片下载工具。  https://v.douyin.com/NkG02XEPcpY/ 复制此链接，打开Dou音搜索，直接观看视频！
```

### 实现方案
我们将使用Python结合tkinter（GUI）和Pillow库（图像处理）来实现这个工具，然后打包成可执行文件。

### 步骤1：创建Python脚本（avif_to_jpg_converter.py）
```python
import os
import sys
import tkinter as tk
from tkinter import filedialog, messagebox, ttk
from PIL import Image
import threading

class AVIFtoJPGConverter:
    def __init__(self, root):
        self.root = root
        self.root.title("AVIF转JPG转换器")
        self.root.geometry("500x300")
        self.root.resizable(False, False)
        
        # 设置界面
        self.setup_ui()
        
        # 初始化变量
        self.selected_dir = ""
        self.conversion_count = 0
        
    def setup_ui(self):
        # 选择目录区域
        dir_frame = ttk.Frame(self.root, padding="20")
        dir_frame.pack(fill=tk.X)
        
        ttk.Label(dir_frame, text="选择目录:").grid(row=0, column=0, sticky=tk.W)
        
        self.dir_path_var = tk.StringVar()
        self.dir_path_entry = ttk.Entry(dir_frame, textvariable=self.dir_path_var, width=40)
        self.dir_path_entry.grid(row=0, column=1, padx=10)
        
        ttk.Button(dir_frame, text="浏览", command=self.select_directory).grid(row=0, column=2)
        
        # 转换按钮
        button_frame = ttk.Frame(self.root, padding="20")
        button_frame.pack(fill=tk.X)
        
        self.convert_btn = ttk.Button(button_frame, text="开始转换", command=self.start_conversion, state=tk.DISABLED)
        self.convert_btn.pack()
        
        # 进度条
        progress_frame = ttk.Frame(self.root, padding="0 20")
        progress_frame.pack(fill=tk.X, padx=20)
        
        self.progress_var = tk.DoubleVar()
        self.progress_bar = ttk.Progressbar(progress_frame, variable=self.progress_var, maximum=100)
        self.progress_bar.pack(fill=tk.X)
        
        # 状态标签
        self.status_var = tk.StringVar(value="请选择包含AVIF文件的目录")
        ttk.Label(self.root, textvariable=self.status_var).pack(pady=10)
        
    def select_directory(self):
        directory = filedialog.askdirectory()
        if directory:
            self.selected_dir = directory
            self.dir_path_var.set(directory)
            self.convert_btn.config(state=tk.NORMAL)
            self.status_var.set("已选择目录，点击开始转换")
            
    def convert_avif_to_jpg(self, input_path, output_path):
        """转换单个AVIF文件为JPG"""
        try:
            with Image.open(input_path) as img:
                # 如果有透明度通道，转换为RGB
                if img.mode in ('RGBA', 'LA') or (img.mode == 'P' and 'transparency' in img.info):
                    background = Image.new('RGB', img.size, (255, 255, 255))
                    background.paste(img, mask=img.split()[-1] if img.mode == 'RGBA' else img)
                    background.save(output_path, 'JPEG', quality=95)
                else:
                    img.convert('RGB').save(output_path, 'JPEG', quality=95)
            return True
        except Exception as e:
            print(f"转换失败 {input_path}: {e}")
            return False
            
    def conversion_worker(self):
        """后台转换线程"""
        try:
            # 获取所有AVIF文件
            avif_files = [f for f in os.listdir(self.selected_dir) 
                         if f.lower().endswith('.avif')]
            
            if not avif_files:
                self.status_var.set("未找到AVIF文件")
                return
                
            total_files = len(avif_files)
            self.conversion_count = 0
            
            for i, filename in enumerate(avif_files):
                input_path = os.path.join(self.selected_dir, filename)
                output_filename = os.path.splitext(filename)[0] + '.jpg'
                output_path = os.path.join(self.selected_dir, output_filename)
                
                if self.convert_avif_to_jpg(input_path, output_path):
                    self.conversion_count += 1
                
                # 更新进度
                progress = (i + 1) / total_files * 100
                self.progress_var.set(progress)
                self.status_var.set(f"正在转换: {i+1}/{total_files}")
                self.root.update_idletasks()
                
            self.status_var.set(f"转换完成！成功: {self.conversion_count}/{total_files}")
            messagebox.showinfo("完成", f"成功转换 {self.conversion_count} 个文件")
            
        except Exception as e:
            self.status_var.set(f"转换过程中出错: {str(e)}")
            messagebox.showerror("错误", f"转换失败: {str(e)}")
        finally:
            self.progress_var.set(0)
            self.convert_btn.config(state=tk.NORMAL)
            
    def start_conversion(self):
        """启动转换过程"""
        if not self.selected_dir:
            messagebox.showwarning("警告", "请先选择目录")
            return
            
        self.convert_btn.config(state=tk.DISABLED)
        self.status_var.set("开始转换...")
        
        # 在后台线程中执行转换
        conversion_thread = threading.Thread(target=self.conversion_worker)
        conversion_thread.daemon = True
        conversion_thread.start()

def resource_path(relative_path):
    """获取资源路径（用于PyInstaller打包）"""
    try:
        base_path = sys._MEIPASS
    except Exception:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

def main():
    root = tk.Tk()
    app = AVIFtoJPGConverter(root)
    root.mainloop()

if __name__ == "__main__":
    main()
```

### 步骤2：打包
#### 1. 安装必要的依赖
```bash
pip install pillow cx-freeze
```
（tkinter不需要安装，Python自带）

#### 2. 使用PyInstaller打包（推荐）
如果使用PyInstaller，命令更简单：

```bash
# 安装PyInstaller
pip install pyinstaller

# 打包命令（单文件，无控制台窗口）
pyinstaller --onefile --windowed --name "AVIF转JPG转换器" avif_to_jpg_converter.py

# 如果想要更小的体积，可以添加优化选项
pyinstaller --onefile --windowed --name "AVIF转JPG转换器" --optimize=2 avif_to_jpg_converter.py
```

#### 3. 如果坚持使用cx_Freeze
```bash
# 先创建setup.py文件（内容不变）
# 然后执行打包命令
python setup.py build
```

### 打包命令说明

**PyInstaller常用参数：**
- `--onefile`：打包成单个EXE文件
- `--windowed`：不显示控制台窗口（GUI程序）
- `--name`：指定生成的文件名
- `--clean`：清理打包缓存
- `--icon=your_icon.ico`：添加图标（可选）

**完整的PyInstaller命令示例：**
```bash
pyinstaller --onefile --windowed --name "AVIF转JPG转换器" --clean avif_to_jpg_converter.py
```

### 注意事项
1. 打包完成后，EXE文件会生成在`dist`目录下
2. 首次运行可能会有点慢，因为需要解压临时文件
3. 如果遇到PIL相关错误，可以尝试：
```bash
pyinstaller --onefile --windowed --name "AVIF转JPG转换器" --hidden-import=PIL --hidden-import=PIL.Image avif_to_jpg_converter.py
```

### Conda环境下的特别说明
如果你在conda环境中遇到PIL相关问题，可以先安装：
```bash
conda install -c conda-forge pillow
```

然后再进行打包。

### 使用说明

#### 对于开发者：
打包方法如上。

#### 对于最终用户：
1. 直接运行打包好的 `AVIF转JPG转换器.exe`
2. 点击"浏览"选择包含AVIF文件的目录
3. 点击"开始转换"按钮
4. 等待转换完成

### 功能特点
- 图形化界面，操作简单
- 批量转换目录中的所有AVIF文件
- 保留原文件名（仅更改扩展名）
- 显示转换进度
- 处理带透明通道的AVIF文件
- 多线程处理，界面无卡顿
- 错误处理和提示

### 注意事项
- 转换后的JPG文件会保存在同一目录下
- 不会删除原AVIF文件
- 支持包含空格的文件名和路径
- 自动处理透明通道（转为白色背景）

用户只需双击运行生成的EXE文件即可使用，无需安装Python或其他依赖。

## 需求2
想做一个可以在windows系统直接双击运行的软件，.exe格式。功能是，输入东东商品详情页URL，选择保存目录，下载该页面全部图片。

此软件需求完善了好几次，
1. 输入东东商品详情页URL，选择保存目录，下载页面上的图片，如果图片是avif格式，则先转为jpg格式再打包下载。
2. 增加输入cookie变量。
3. 由于cookie动态刷新，使用playwright+国内镜像安装 Chromium,GUI + 自动下载 Chromium 内核,完全独立，不依赖本机浏览器.（用户无需关心浏览器版本）
4. 用户使用软件中自带的浏览器，进行登录。之后再进行下载。

最后还是失败了，因为使用软件打开内置浏览器后，虽然可以登录，但是一会儿就自动退回到首页。

不过，当作学习，chatGPT的回答和代码还是值得学习的，如下：

我们可以做一个 **完整可用的 GUI 东东图片下载器**，特点如下：
---
好的，我来帮你写一个 **完整可用的 Playwright GUI 东东图片下载器**，解决以下需求：

* 国内用户无需翻墙
* 自动使用国内镜像下载 Chromium 内核
* GUI 友好（Tkinter）
* 用户第一次登录东东即可抓取图片
* AVIF/WEBP 自动转 JPG
* 自动打包 ZIP
* 下次可以复用 session，无需再次登录

---

# 🔹 脚本示例

保存为 `jd_playwright_gui.py`：

```python
import os
import re
import threading
import zipfile
from io import BytesIO
from tkinter import *
from tkinter import filedialog, messagebox, scrolledtext

from PIL import Image
import requests
from playwright.sync_api import sync_playwright

# ---------------- GUI ----------------
root = Tk()
root.title("东东图片下载器 (Playwright)")
root.geometry("650x500")

Label(root, text="商品页面 URL:", font=("Arial", 12)).pack(anchor="w", padx=10, pady=5)
entry_url = Entry(root, width=80)
entry_url.pack(padx=10)

Label(root, text="保存目录:", font=("Arial", 12)).pack(anchor="w", padx=10, pady=5)
save_dir_var = StringVar()
Entry(root, textvariable=save_dir_var, width=55).pack(side=LEFT, padx=(10,0))
def select_dir():
    path = filedialog.askdirectory()
    if path:
        save_dir_var.set(path)
Button(root, text="选择目录", command=select_dir).pack(side=LEFT, padx=5)

log_box = scrolledtext.ScrolledText(root, width=80, height=20)
log_box.pack(padx=10, pady=10)

status_label = Label(root, text="", font=("Arial", 10), fg="blue")
status_label.pack(pady=5)

# ---------------- 日志函数 ----------------
def log(msg):
    log_box.insert(END, msg + "\n")
    log_box.see(END)
    root.update()

# ---------------- 下载函数 ----------------
def download_images_thread():
    url = entry_url.get().strip()
    save_dir = save_dir_var.get().strip()

if not url or not save_dir:
        messagebox.showwarning("提示", "请填写 URL 和保存目录！")
        return

if not url.startswith(("http://", "https://")):
        url = "https://" + url

status_label.config(text="启动浏览器...", fg="green")
    root.update()

try:
        # Playwright 使用国内镜像下载 Chromium 内核
        os.environ["PLAYWRIGHT_BROWSERS_PATH"] = "0"
        os.environ["PLAYWRIGHT_DOWNLOAD_HOST"] = "https://npmmirror.com/mirrors/playwright/"

with sync_playwright() as p:
            # 启动 Chromium
            browser = p.chromium.launch(headless=False)  # False 显示浏览器
            # 尝试加载已有 session，下次无需登录
            session_file = os.path.join(save_dir, "jd_session.json")
            context = browser.new_context(storage_state=session_file if os.path.exists(session_file) else None)
            page = context.new_page()
            page.goto(url)
            page.wait_for_timeout(5000)  # 等待页面加载
            html = page.content()

# 匹配商品图片
            patterns = [
                r'https://img\d+\.360buyimg\.com/[^\s"]+\.jpg',
                r'https://img\d+\.360buyimg\.com/[^\s"]+\.png',
                r'https://img\d+\.360buyimg\.com/[^\s"]+\.webp',
                r'https://img\d+\.360buyimg\.com/[^\s"]+\.avif',
            ]

image_urls = []
            for ptn in patterns:
                image_urls.extend(re.findall(ptn, html))

if not image_urls:
                messagebox.showerror("错误", "未找到任何图片！请确认商品页面已登录")
                browser.close()
                return

log(f"共找到 {len(image_urls)} 张图片，开始下载...")

zip_path = os.path.join(save_dir, "jd_images.zip")
            zf = zipfile.ZipFile(zip_path, "w")

for idx, img_url in enumerate(image_urls, 1):
                try:
                    r = requests.get(img_url, timeout=10)
                    img = Image.open(BytesIO(r.content)).convert("RGB")
                    img_buffer = BytesIO()
                    img.save(img_buffer, format="JPEG")
                    zf.writestr(f"image_{idx}.jpg", img_buffer.getvalue())
                    log(f"[√] 下载 {idx}/{len(image_urls)}")
                except Exception as e:
                    log(f"[×] 下载失败 {img_url} 错误: {e}")

zf.close()
            log("下载完成！ZIP 文件已生成。")
            # 保存登录状态，下次可以复用
            context.storage_state(path=session_file)
            browser.close()

messagebox.showinfo("完成", f"下载完成，共 {len(image_urls)} 张图片\n已打包为: {zip_path}")
            status_label.config(text="下载完成", fg="green")

except Exception as e:
        messagebox.showerror("错误", f"浏览器运行失败：{e}")
        status_label.config(text="下载失败", fg="red")
        return

def start_thread():
    t = threading.Thread(target=download_images_thread)
    t.start()

Button(root, text="开始下载", width=20, height=2, command=start_thread).pack(pady=5)

root.mainloop()
```

---

# 🔹 使用方法

1. 安装依赖（国内镜像）：

```bash
pip install playwright pillow requests
```

2. 设置国内镜像并安装 Chromium：

```bash
setx PLAYWRIGHT_DOWNLOAD_HOST "https://npmmirror.com/mirrors/playwright/"
setx PLAYWRIGHT_BROWSERS_PATH "0"
# 打开新命令行窗口
python -m playwright install chromium
```

3. 运行脚本：

```bash
python jd_playwright_gui.py
```

4. GUI 会弹出：

* 输入商品 URL
   * 选择保存目录
   * 第一次运行会打开浏览器，用户登录东东
   * 自动抓取图片 → 转 JPG → 打包 ZIP
   * 下次运行可复用 session，无需再登录

---

# 🔹 打包 EXE

```bash
pip install pyinstaller
pyinstaller --onefile --windowed jd_playwright_gui.py
```

* 用户双击即可使用
* **无需本机 Chrome/Edge**
* **无需翻墙**
* **自动处理 AVIF/WEBP → JPG**
* **动态 Cookie 问题已解决**

---

如果你希望，我可以帮你进一步 **升级 GUI**：

* 增加 **下载进度条**
* **多线程加速下载**
* **商品标题命名图片**

这样体验更像专业桌面工具。

你希望我加这些功能吗？

小Tip: 
测试内置的浏览器是否成功
python -m playwright codegen https://www.baidu.com
如果 Chromium 能启动并打开页面，说明环境正常

yyii

http://www.amtb.info/show/MjYw

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !