🚀 Py to EXE Converter

🎯 What is this thing?

This tool simplifies the process of converting Python scripts into executable files (.exe on Windows, etc.) using PyInstaller. Instead of typing long command-line arguments, you interact with a user-friendly prompt system that guides you through all available options.

🔍 How it works

1. Interactive Prompts: Answer simple yes/no and text questions
2. Smart Defaults: Remembers your last settings for faster subsequent builds
3. Rich Interface: Beautiful, colorful console output with progress indicators
4. Comprehensive Options: Access to all major PyInstaller features
5. Error Handling: Clear feedback and help system built-in

✨ Features

• 🎨 Beautiful Interface: Rich-powered console with panels, tables, and live progress
• 📁 Flexible Output: Choose between single file or directory bundles
• 🖼️ Custom Icons: Add custom icons to your executables
• 🔒 Windowed Apps: Create GUI applications without console windows
• 📦 Hidden Imports: Automatically include hard-to-find dependencies
• 🚫 Module Exclusion: Exclude unnecessary modules to reduce size
• 📄 Data Inclusion: Bundle additional files and data
• 🗜️ Compression: UPX compression support for smaller executables
• 🔐 Encryption: Bytecode encryption for added security
• 📋 Version Info: Add detailed version information to executables
• 🛠️ Developer Mode: Advanced options for power users
• 💾 Persistent Settings: Remembers your preferences between runs

What to have

• Python 3.7 or higher
• pip (Python package installer)

Installation

1. **Download main.py from this repository **

   Install the latest release or packages 
   

2. Install dependencies

   cd Downloads
   pip install -r requirements.txt

3. Run the converter

   python main.py

That's it!

📖 Usage

Basic Workflow

1. Launch: Run python main.py
2. Select Script: Enter the path to your Python file
3. Configure: Answer the prompts for your desired options
4. Build: Let PyInstaller do its magic
5. Done: Find your executable in the output directory

Configuration Options

The tool supports all major PyInstaller options through an intuitive interface:

Option	Description	ℹ️
Output Mode	Single file vs. directory bundle	?
Windowed	Hide console window for GUI apps	?
Icon	Custom icon for the executable	?
Name	Custom executable name	?
Hidden Imports	Additional modules to include	?
Exclude Modules	Modules to exclude from bundle	?
Add Data	Include additional files	?
UPX Compression	Compress executable size	?
Version Info	Add version metadata	?
Encryption	Encrypt Python bytecode	?

Advanced Options

• Runtime Hooks: Custom initialization code
• Manifest Files: Windows manifest customization
• Code Signing: macOS code signing support
• Bootloader Options: Advanced PyInstaller settings

🎮 Interactive Help

Type help at any prompt to see:

• Current configuration values
• Developer options status
• Quick reference guide

📋 Examples

Basic GUI Application

Path to Python file: my_app.py
Executable name: MyApp
Output directory: dist
Build as single file? Yes
Windowed (no console)? Yes
Icon path: icon.png
... (other options as needed)

Command-Line Tool with Dependencies

Path to Python file: cli_tool.py
Executable name: MyTool
Output directory: build
Build as single file? Yes
Windowed (no console)? No
Hidden imports: requests,beautifulsoup4
... (other options as needed)

🛠️ Developer Mode

Enable developer mode for advanced PyInstaller options:

• Custom spec file paths
• Work directory specification
• Alternative Python executable paths

📁 Project Structure

py-to-exe-converter/
├── main.py # The file to convert
├── build
   ├── idk build stuff  # Build Stuff             
├── dist                # EXE File output folder
    ├── main.exe        # The Exe File 

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🙏 Acknowledgments

• PyInstaller - The underlying packaging technology
• Rich - Beautiful console output library
• EmanuelPlays - Original creator

🆘 Troubleshooting

Common Issues

"Module not found" errors:

• Use "Hidden Imports" to include missing modules
• Check your Python environment has all dependencies

Large executable size:

• Use "Exclude Modules" to remove unnecessary code
• Enable UPX compression
• Consider onefile vs onedir based on your needs

Icon not showing:

• Ensure icon file exists and is in a supported format (.ico recommended)
• Check file path is correct

Build fails:

• Ensure PyInstaller is properly installed
• Check Python version compatibility
• Try running with "Clean build" option

Getting Help

• Check the PyInstaller documentation
• Open an issue on GitHub
• Type help during interactive mode for current configuration

Made with ❤️ by EmanuelPlays