py2exe-gui 0.3.1

GUI for PyInstaller, based on PySide6

Easy-to-use Python GUI packaging tool

English | 简体中文

Introduction

Py2exe-GUI is an assist tool based on PySide6, designed to provide a complete yet easy-to-use GUI for PyInstaller.

It has the following features:

• Fully graphical interface, easy to use.
• All options of PyInstaller will be supported.
• You can invoke any local Python interpreter with its corresponding environment, eliminating the need to reinstall it in each interpreter environment to be packaged.
• Cross-platform, supports Windows, Linux and macOS.

How to install

Note: Py2exe-GUI is still in the early stages of development, and the distributions provided are beta versions. Installation methods may change frequently, so be sure to check these instructions often.

Option A: Install with pip

First, install PyInstaller in the Python interpreter environment which to be packaged:

pip install pyinstaller  # Must be installed in your project environment

Then install Py2exe-GUI with pip:

pip install py2exe-gui  # Can be installed into any environment

Run:

py2exe-gui

You can run py2exe-gui as a package if running it as a script doesn't work:

python -m py2exe_gui  # `_`, not `-`

Option B: Run through source code

For those who like to try it out or are in desperate need of the latest bug fixes, you can run it through the repository source code:

1. Download the latest main branching source code.

2. Unzip it and go to the directory. Launch a terminal to create and activate the virtual environment:

   python -m venv venv  # create a virtual environment (Windows)
   .\venv\Scripts\activate.ps1  # and activate it (Windows, PowerShell)
   

   python3 -m venv venv  # create a virtual environment (Linux/macOS)
   source venv/bin/activate  # and activate it (Linux/macOS)
   

3. Install dependencies and run the program.

   pip install -r requirements.txt
   python ./src/Py2exe-GUI.py
   

Contributing

Py2exe-GUI is a free and open source software and anyone is welcome to contribute to its development.

If you encounter any problems while using it (including bugs, typos, etc.), or if you have suggestions for new features, you can open an issue.

If you are able to contribute code, feel free to submit a pull-request. Please follow the original code style as much as possible, and make sure that the new code passes all the checks.

License

Py2exe-GUI is licensed under the GPLv3 open source license, see the LICENSE file for details.

There is one exception: if your project uses Py2exe-GUI only as a packaging tool, and your final distribution does not contain Py2exe-GUI's source code or binaries, then your project is not restricted by the GPLv3 restrictions and can still be distributed as closed-source commercial software.

Py2exe-GUI
Copyright (C) 2022-2024  muzing

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

强大易用的 Python 图形界面打包工具

English | 简体中文

简介

Py2exe-GUI 是一个基于 PySide6 开发的辅助工具，旨在为 PyInstaller 提供完整易用的图形化界面，方便用户进行 Python 项目的打包。

有如下特性：

• 完全图形化界面，易用。
• 将会支持 PyInstaller 的全部选项。
• 可以调用本地任一 Python 解释器与对应环境，无需在每个待打包的解释器环境中重复安装。
• 跨平台，支持 Windows、Linux、MacOS。

如何安装

注意：Py2exe-GUI 尚处早期开发阶段，提供的分发版本均为beta-测试版。安装方式也可能频繁变化，注意经常查阅此使用说明。

方式1：通过 pip 安装

首先在待打包的 Python 解释器环境中安装 PyInstaller:

pip install pyinstaller  # 必须在你的项目环境中安装

然后通过 pip 安装 Py2exe-GUI：

pip install py2exe-gui  # 可以安装至任何环境

运行

py2exe-gui

如果以脚本形式运行失败，还可以尝试作为 Python 包运行：

python -m py2exe_gui  # 注意连字符为_

方式2：通过仓库源码运行

对于喜欢尝鲜或急需最新 bug 修复的用户，可以通过仓库源码运行：

1. 下载最新 main 分支源码

2. 解压后进入目录，启动命令行/终端，创建并激活虚拟环境：

   python -m venv venv  # 创建虚拟环境（Windows）
   .\venv\Scripts\activate.ps1  # 激活虚拟环境（Windows PowerShell）
   

   python3 -m venv venv  # 创建虚拟环境（Linux/macOS）
   source venv/bin/activate  # 激活虚拟环境（Linux/macOS）
   

3. 安装依赖、运行程序：

   pip install -r requirements.txt  # 安装依赖项
   python ./src/Py2exe-GUI.py  # 运行
   

贡献

Py2exe-GUI 是一个自由的开源软件，欢迎任何人为其开发贡献力量。

如果你在使用时遇到任何问题（包括 bug、界面错别字等），或者提议新增实用功能，可以提交一个 issue。

如果你有能力有想法贡献代码，欢迎提交 pull request。请尽可能遵守原有的代码风格，并确保新增代码能通过静态检查。

开源许可

Py2exe-GUI 采用 GPLv3 开源许可证，详情请参见 LICENSE 文件。

但有一个例外：如果你的项目仅使用 Py2exe-GUI 作为打包工具，而最终发布的软件中并不包含 Py2exe-GUI 的源码或二进制文件，那么你的项目不会受到 GPLv3 的限制，仍可作为闭源商业软件发布。

Py2exe-GUI
Copyright (C) 2022-2024  Muzing

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.