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.

Empty interface

The script is built using Eel and uses PyInstaller to convert the script

PyPI Version PyPI Supported Versions License Downloads Downloads Per Month Supported Platforms

Demo

auto-py-to-exe 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 of auto-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

  1. Select your script location (paste in or use a file explorer)
  2. The outline will become blue if the file exists
  3. Select other options and add things like an icon or other files
  4. Click the big blue button at the bottom to convert
  5. 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.

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

Empty interface

Filled out

Converting

Completed

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.