PyExe Builder Professional

---

📖 Overview

PyExe Builder Professional is a powerful, user-friendly GUI application designed to simplify the process of converting Python scripts into standalone executable files (.exe) using PyInstaller. Built with PyQt6, this tool offers a sleek, modern interface with multilingual support, customizable themes, and advanced build options, making it ideal for developers of all skill levels. Whether you're packaging a simple script or a complex application with dependencies, PyExe Builder Professional streamlines the process with an intuitive workflow.

---

✨ Features

• Graphical User Interface: A clean, tabbed interface for easy navigation.
• Multilingual Support: Available in English, Japanese, Korean, and Filipino.
• Custom Themes: Six professionally designed dark themes for a personalized experience.
• Advanced Build Options: Support for one-file builds, console/no-console modes, admin access, and more.
• Dependency Management: Automatically install dependencies from requirements.txt.
• Metadata Customization: Add company details, version info, and legal metadata to your executables.
• Real-Time Build Console: Monitor the build process with color-coded logs.
• System Tray Integration: Minimize to tray for convenience.
• Cross-Platform: Compatible with Windows, Linux, and macOS (with minor adjustments).

---

🚀 Installation

Prerequisites

• Python 3.8+: Ensure Python is installed on your system.
• Pip: Python package manager (usually included with Python).
• Dependencies: Automatically installed via start.py.

Steps

1. Clone the Repository:

   git clone https://github.com/VoxDroid/PyExe-Builder.git
   cd PyExe-Builder
   

2. Run the Application:

   python start.py
   

   • This creates a virtual environment (.builder_env) and installs required packages (PyQt6, psutil, pyinstaller, qtawesome).

3. Launch the GUI: The app will start automatically after setup.

Alternative: Build the Executable

To create a standalone .exe:

1. Open the GUI by running start.py.
2. In the Main Tab, select start.py as the "Python Script".
3. In the Dependencies Tab, add:

   app.py;.
   Poppins-Regular.ttf;.
   

4. Check "One File" and "Clean Build" options.
5. Click "Build Executable" and specify an output directory.

---

📋 Usage

Main Interface

Building an Executable

1. Main Tab:

   • Choose your Python script.
   • Set application name and output directory.
   • Optionally select an icon.

2. Dependencies Tab (if needed):

   • Add external files or imports.

3. Build:

   • Click "Build Executable" and monitor progress in the console.

---

🎨 Customization

Themes

Choose from six dark themes:

• Dark Soft
• Midnight Blue
• Slate Gray
• Deep Forest
• Velvet Night
• Charcoal Glow

Adjust in the Settings Tab under "Theme".

Languages

Supported languages:

• English
• Japanese (日本語)
• Korean (한국어)
• Filipino (Tagalog)

Set in the Settings Tab under "Language".

---

🛠️ Technical Details

Dependencies

File Structure

PyExe-Builder/
├── start.py              # Entry point and environment setup
├── app.py                # Main GUI application
├── Poppins-Regular.ttf   # Font file
├── .builder_env/         # Virtual environment (auto-generated)
├── build/                # Build artifacts (auto-generated)
└── dist/                 # Output executables (auto-generated)

---

🌟 Contributing

We welcome contributions! Please read our Contributing Guide for details on how to contribute, and review our Code of Conduct to ensure a positive and inclusive community.

To get started:

1. Fork the Repository: Click "Fork" on GitHub.
2. Clone Your Fork:

   git clone https://github.com/VoxDroid/PyExe-Builder.git
   

3. Create a Branch:

   git checkout -b feature/your-feature
   

4. Make Changes: Implement your feature or fix.
5. Commit and Push:

   git add .
   git commit -m "Add your feature description"
   git push origin feature/your-feature
   

6. Submit a Pull Request: Open a PR on GitHub.

Guidelines

• Follow PEP 8 for Python code.
• Test changes locally before submitting.
• Update documentation if applicable.

---

🐛 Issues and Support

For support, please refer to our Support Guide. If you encounter security issues, please review our Security Policy.

Found a bug? Have a question?

• Open an Issue: Use the Issues tab.
• Contact: Reach out via GitHub Discussions or email (if provided).

---

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

🙌 Acknowledgments

• PyQt6 Team: For an excellent GUI framework.
• PyInstaller Contributors: For making Python packaging possible.
• qtawesome: For beautiful icons.
• Poppins Font: For a sleek typography experience.

---

📈 Roadmap

• Add support for additional languages.
• Implement drag-and-drop for file inputs.
• Enhance theme customization with light mode options.
• Add pre-build validation checks.
• Support for macOS-specific optimizations.

---

📊 Stats

---

💡 Tips and Tricks

• Speed Up Builds: Enable "Clean Build" to avoid caching issues.
• Debugging: Use the "Debug Mode" option to troubleshoot build errors.
• Portable Builds: Use "One File" for easy distribution.

---

📸 Screenshots

Main Tab

Metadata Tab

Dependencies Tab

Advanced Tab

Settings Tab

---

🔗 Links

• Repository: github.com/VoxDroid/PyExe-Builder
• Issues: github.com/VoxDroid/PyExe-Builder/issues
• Author: VoxDroid

---

🎉 Final Words

Thank you for checking out PyExe Builder Professional! We hope it simplifies your Python packaging needs. Star the repo if you find it useful, and happy coding! 🚀

---