# deblinglong-gui

**Repository Path**: ChaoYouAi/deblinglong-gui

## Basic Information

- **Project Name**: deblinglong-gui
- **Description**: 本工具支持将 .deb 、AppImage、snap、flatpak格式的 Linux 软件包转换为玲珑（Linglong）格式（依赖 WSL+ll-killer-go），适配深度（Deepin）和统信（UOS）操作系统生态。实现 Windows/macOS 全平台下操作。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2025-03-20
- **Last Updated**: 2025-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Deb/AppImage 软件包转换工具
本工具支持将 .deb 、AppImage、snap、flatpak格式的 Linux 软件包转换为玲珑（Linglong）格式（依赖 WSL+ll-killer-go），适配深度（Deepin）和统信（UOS）操作系统生态。实现 Windows/Linux/macOS 全平台下操作。

![升级图片3.0.png](https://gitee.com/ChaoYouAi/deblinglong-gui/blob/master/theme/%E5%8D%87%E7%BA%A7%E5%9B%BE%E7%89%873.0.png)

## 📦 项目特性
- 支持 DEB/AppImage/Snap/Flatpak/RPM/PKG 格式互转
- 跨平台图形化界面（Windows/macOS/Linux）
- 容器化转换支持（Docker）
- 实时转换日志追踪
- 输出文件完整性验证

## 🛠️ 依赖环境

### 全平台基础依赖
```bash
Python >= 3.8
PyQt5 == 5.15.9
ttkthemes == 3.2.2
docker-py >= 6.0  # 容器模式需要
```

### Windows 额外依赖
```bash
# WSL2 环境
wsl --install -d Ubuntu-22.04
sudo apt install ll-killer-go dpkg-dev squashfs-tools
```

### macOS 额外依赖
```bash
brew install squashfs
pip install pyobjc  # 文件选择对话框支持
```

## 📥 安装方式

### 源码运行
```bash
git clone https://github.com/yourname/linux-pkg-converter.git
pip install -r requirements.txt
python main.py
```

### 二进制包安装
| 平台 | 下载地址 | 校验值 |
|------|----------|--------|
| Windows | [deb_appimage2linglong.exe](https://gitee.com/ChaoYouAi/deblinglong-gui/releases)| SHA256: a1b2c3... |
| macOS | [deb_appimage2linglong.dmg](release/macos_v1.0.dmg) | SHA256: d4e5f6... |

## 📦 打包指南

### Windows 单文件打包
```bash
pyinstaller --onefile --name "PackageConverter" \
  --icon=assets/icon.ico \
  --add-data "themes/*;themes/" \
  main.py
```

### Windows 多文件分发包
```bash
pyinstaller --name "PackageConverter" \
  --distpath "dist/win64" \
  --workpath "build/win64" \
  --add-data "themes/*;themes/" \
  main.py
```

### macOS 应用程序打包
```bash
pyinstaller --name "PackageConverter" \
  --windowed \
  --osx-bundle-identifier "com.yourcompany.pkgconverter" \
  --icon=assets/icon.icns \
  --add-data "themes/*:themes/" \
  main.py
```

## 🚀 使用说明

1. **选择包类型**  
   ![选择包类型](step1.png)

2. **添加待转换文件**  
   支持多选操作，同时处理最多50个文件

3. **选择输出目录**  
   默认路径：`~/PackageOutput`

4. **启动转换**  
   - 原生模式：直接调用本地工具链
   - 容器模式：通过Docker隔离环境

5. **验证输出**  
   ```bash
   ll-killer-go verify <package.llpkg>
   ```

## 📜 开源协议

本项目采用 **MIT License**，核心条款如下：

✅ 允许：
- 商业用途
- 修改和再分发
- 私有使用

🚫 要求：
- 保留版权声明
- 包含许可证文件

完整协议详见 [LICENSE](LICENSE)

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交修改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## ❓ 常见问题

**Q：转换过程中出现依赖缺失错误？**  
```bash
# 安装基础编译工具链
sudo apt install build-essential devscripts debhelper
```

**Q：macOS 下无法识别 AppImage 文件？**  
```bash
# 授予文件执行权限
chmod +x *.AppImage
```

**Q：如何自定义界面主题？**  
创建 `config.ini`：
```ini
[UI]
theme = arc
font_size = 12
language = zh_CN
```

---

📮 问题反馈：<yourname@domain.com>  
🐛 Bug 提交：[GitHub Issues](https://github.com/yourname/linux-pkg-converter/issues)