repkg 解包转换工具完整上手:一条命令把 Wallpaper Engine 资源变成图片
【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg
同样一个.pkg文件,在你手里是打不开的乱码,在别人手里却变成了一叠整齐的 PNG——差距只有一条命令。repkg 解包转换工具,正是为 Wallpaper Engine 资源包(.pkg)与贴图文件(.tex)设计的命令行提取与转换程序,面向所有想从壁纸包里取出素材、却不想碰编程的普通用户。
没有 repkg 之前 vs 有了 repkg 之后:两张清单看懂价值
先别急着敲命令,用两列清单看看这款工具到底改变了什么。
没有它之前:
- 从创意工坊下载的壁纸,想抠一张贴图只能对着屏幕截图,画质糊成一团
- 手里攒了几十个
.tex文件,PS 和看图软件全都不认,只能躺在硬盘里吃灰 - 想确认包里到底有什么,只能盲目解压试错,费时又费神
- 素材格式不通用,想复用到其他软件,第一步就被卡死
有了它之后:
- 一条命令解包,贴图、模型、脚本全部还原成独立文件,直接可用
- 几十个
.tex一条命令批量转成 PNG,转头就能进设计稿 - 解包前先用
info体检,包内条目、大小、工程标题一目了然 - 解包结果自动按来源文件夹归档,还能保留
project.json重新导入 Wallpaper Engine
repkg 安装教程:动手前先过一遍四步检查清单
开始前,先逐项确认以下条件,缺一不可:
- □ 装有 .NET SDK。repkg 用 C# 编写,目标框架是 .NET Framework 4.7.2,编译前需装好对应 SDK 与运行时
- □ 终端可用(Windows 用 PowerShell 或 CMD,macOS / Linux 用自带终端)
- □ 选好一个工作目录,后续所有文件都放这里,方便管理
- □ 记住两条命令:
git clone负责下载源码,dotnet build负责编译程序
第一步,把源码克隆到本地。这一步会下载整个项目,耐心等它跑完:
git clone https://gitcode.com/gh_mirrors/re/repkg第二步,进入项目目录并编译正式版本:
cd repkg && dotnet build RePKG.sln -c Release-c Release表示生成优化过的正式版本。编译成功后,可执行文件repkg(Windows 上为repkg.exe)出现在RePKG/bin/Release/net472/目录下。把它加入 PATH,或直接使用完整路径调用,下文所有命令都基于它。
repkg 第一次使用:用最小命令 extract 跑通全流程
先用最简单的命令获得一次完整成功。把终端切到壁纸文件所在目录,执行:
repkg extract 你的壁纸.pkg这一步只做一件事:读取指定的.pkg文件,把里面的条目全部解出来,TEX 贴图顺手转成 PNG,结果存到当前目录下的output文件夹。
成功时你会看到:
### Extracting package: /path/to/你的壁纸.pkg * Extracting: materials/textures/背景.png * Extracting: materials/textures/人物.tex * Reading: materials/textures/人物.tex Done结尾出现Done,说明解包完成。打开output文件夹,原始文件与转换后的图片都在里面。
最常见的失败长这样:
Input file not found /你的壁纸.pkg这不是程序坏了,而是路径没写对。把文件直接拖进终端让系统自动补全路径,问题立刻消失。
repkg 功能地图:速查表 + 三个高频使用场景
📦 先把速查表收好,主要能力一栏看全:
| 命令 / 参数 | 作用 | 典型用法 |
|---|---|---|
extract | 解包 PKG,或把 TEX 转成图片 | repkg extract 壁纸.pkg |
info | 查看包内条目与工程信息 | repkg info 壁纸.pkg -e |
-e/--onlyexts | 只提取指定扩展名的文件 | -e "tex,png" |
-i/--ignoreexts | 跳过指定扩展名的文件 | -i "json" |
-r/--recursive | 递归搜索子目录里的所有 PKG | -r -c ./wallpapers |
-c/--copyproject | 顺带复制 project.json 与预览图 | 与-r搭配 |
-n/--usename | 用 project.json 中的标题命名输出文件夹 | 批量归档时 |
-t/--tex | 把目录里的 TEX 全部转图 | -t -s ./tex_files |
-s/--singledir | 结果平铺到一个目录,不保留路径 | 批量转图常用 |
--no-tex-convert | 解包时不转换 TEX,只存原始字节 | 只要原文件时 |
--overwrite | 强制覆盖已存在的文件 | 重复导出时 |
-b/--sortby | info 按 name / size 等排序 | -b size |
-p/--projectinfo | 输出 project.json 中的指定字段 | -p "*" |
记不住参数没关系,随时输入repkg help "extract"就能调出说明。下面挑三个最常用的功能展开讲。
只提取指定类型文件:-e 与 -i 参数怎么用
使用场景:一个壁纸包里有贴图、模型、脚本共二十来个文件,你只想要其中的贴图,其余一概不要。
命令:
repkg extract 壁纸.pkg -e "tex,png" -o ./textures得到的结果:textures文件夹里只有贴图相关文件,路径结构与包内一致,干净利落。反向操作用-i,意思是"除了这些都不要",适合只想甩掉某几类文件的场合。
批量转换 TEX 文件:-t 与 -s 参数怎么用
使用场景:手里只有一堆散落的.tex文件,没有对应的.pkg包,想全部转成 PNG 用于设计。
命令:
repkg extract -t -s ./tex_files -o ./png_output得到的结果:png_output里是一张张可直接使用的 PNG,每张图旁边附带一份.tex-json元数据文件,记录尺寸、格式等参数。-s让所有结果平铺在同一层,省去逐个翻目录的麻烦。若提示文件已存在,补上--overwrite强制覆盖。
解包前先体检:info 命令查看包内结构
使用场景:不确定某个包值不值得解,先看看它有多大、装了什么。
命令:
repkg info 壁纸.pkg -e -s -b size得到的结果:终端按大小列出包内每个文件的完整路径与字节数;追加-p "*"还能读出壁纸标题等工程信息。先体检、再解包,避免白费功夫。
repkg 批量处理进阶:三条命令组成一条流水线
单条命令只是起步,把命令串起来才是效率翻倍的关键。下面这套"递归解包 → 批量转图 → 生成清单"流程,适合一次性处理收藏夹里的几十个壁纸包。
先递归解包所有壁纸,并复制每个项目的配置文件与预览图,让结果可以直接重新导入 Wallpaper Engine:
repkg extract -r -c ./wallpapers -o ./projects再把手头零散的 TEX 目录批量转图,平铺输出:
repkg extract -t -s ./tex_files -o ./pngs最后给所有包生成一份条目清单,存成文件备查:
repkg info ./wallpapers -e -s > inventory.txt⚡ 三行命令跑完,"解包 + 转图 + 清单"一次到位。想更进一步,把它们写进一个 shell 脚本循环执行,就是一条属于你自己的自动化流水线。
repkg 常见问题速答:六个高频坑位一次排清
Q1:提示 "Input file not found",文件明明就在眼前?
- 症状:命令报找不到输入文件。
- 原因:路径写错,或终端当前目录与文件所在目录不一致。
- 解决:先执行
pwd确认当前位置,再把文件拖进终端自动补全路径。
Q2:报错 "Unknown magic",解包失败?
- 症状:读取 TEX 时提示魔数不匹配。
- 原因:文件损坏,或根本不是有效文件(TEX 文件头应以
TEXV0005开头)。 - 解决:确认来源可靠,重新下载后再试。
Q3:转出来的图片颜色发暗或发紫?
- 症状:图片整体偏色,和原壁纸观感不同。
- 原因:贴图带透明通道(Alpha),部分查看器显示异常。
- 解决:换成支持 Alpha 通道的看图软件,或换一种输出格式。
Q4:解包时只想留原始文件,不想被转图?
- 症状:TEX 被自动转换成 PNG,多出不少文件。
- 原因:
extract默认会对 TEX 条目做转换。 - 解决:加上
--no-tex-convert参数,只保存原始字节。
Q5:重复解包时提示文件已存在,无法覆盖?
- 症状:第二次运行跳过已有文件。
- 原因:工具默认不覆盖输出目录里的旧文件。
- 解决:追加
--overwrite参数强制覆盖。
Q6:dotnet build直接报错?
- 症状:编译阶段提示找不到 SDK 或目标框架。
- 原因:本机 .NET 环境不完整,repkg 面向 .NET Framework 4.7.2。
- 解决:安装 .NET SDK 与对应运行时后重试。
现在就动手:让第一条命令跑起来
repkg 的价值一句话就能说清:它把你打不开的资源,变成你随手能用的素材。别等到需要时才想起它——找个壁纸包跑一次repkg extract,十分钟后你就能拥有第一张亲手解出的 PNG。把上文那句git clone https://gitcode.com/gh_mirrors/re/repkg收藏好,新版本与更多用法都会在那里更新。
【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考