What is this?
This application displays a simple interface that allows you to convert .py to .exe easily. By just selecting the file, if you want it to convert to onefile and if you want a console, you will only need to press convert and wait for the script to do the rest.
The script is built using Eel and uses PyInstaller to convert the script
Demo
Getting Started
Prerequisites
- Python: 3.6-3.12
To have the interface displayed in the images, you will need Chrome. If Chrome is not installed or --no-chrome
is passed, the default browser will be used.
Installing via PyPI
You can install this project using PyPI:
$ pip install auto-py-to-exe
Then to run it, execute the following in the terminal:
$ auto-py-to-exe
If you have more than one version of Python installed, you can use
python -m auto_py_to_exe
instead ofauto-py-to-exe
.
Installing via GitHub
$ git clone https://github.com/brentvollebregt/auto-py-to-exe.git
$ cd auto-py-to-exe
$ python setup.py install
Then to run it, execute the following in the terminal:
$ auto-py-to-exe
Using the Application
- Select your script location (paste in or use a file explorer)
- The outline will become blue if the file exists
- Select other options and add things like an icon or other files
- Click the big blue button at the bottom to convert
- Find your converted files in /output when completed
Easy.
Examples
The examples/ directory offers some examples of how to write your scripts and package them with auto-py-to-exe.
- Basic (console application)
- No Console (as typically desired for GUI-based applications)
- Images and other non-.py files (static files to be included)
- Persistent data (like databases)
Video
If you need something visual to help you get started, I made a video for the original release of this project; some things may be different but the same concepts still apply.
Contributing
Check out CONTRIBUTING.md to see guidelines on how to contribute. This outlines what to do if you have a new feature, a change, translation update or have found an issue with auto-py-to-exe.
Issues Using the Tool
If you're having issues with the packaged executable or using this tool in general, I recommend you read my blog post on common issues when using auto-py-to-exe. This post covers things you should know about packaging Python scripts and fixes for things that commonly go wrong.
If you believe you've found an issue with this tool, please follow the "Reporting an Issue" section in CONTRIBUTING.md.
Screenshots
Response
I really wanted to get this project out there so I released a YouTube video demonstrating how to set up and use the interface (video above). A day later I made a post in the /r/Python subreddit titled "Auto Py to Exe is Complete". To my surprise, the next morning (about 7 hours) I had more than 300 upvotes which to me was a big thing. I had many replies which I took time to read and reply to. About 44 hours later the post finally lost its top place on the subreddit and the post is sitting at 454 points with 12.1k views and 75 comments. I can't believe how big this got and it means a lot to me when I saw people thanking me for the project. When a couple of issues came to the Github repo I realised people do care about this and I was quick to fix these. Once again, thank you for the support; I loved making this project.