ezicon 1.2.6

Create Windows Start Menu shortcuts for Python scripts instantly.

ezicon

A simple tool to create Windows Start Menu shortcuts and Desktop links for Python scripts. It automatically detects virtual environments and GUI applications.

Installation

pip install ezicon

Features

• Auto-Venv Detection: Automatically finds and uses .venv, venv, or env folders near your script.
• GUI Detection: Automatically uses pythonw.exe for Tkinter/PyQt scripts (no console window).
• Shortcut Customization: Set custom names, icons, and locations.
• Terminal Commands: Create batch files to run your scripts from any terminal.

Usage

Basic Usage

Create a shortcut for your script in the Start Menu:

ezicon my_script.py

Custom Name and Icon

Specify a custom name and a specific .ico file:

ezicon my_script.py "My Awesome App" --icon app_icon.ico

Desktop Shortcut

Create a shortcut on the Desktop instead of the Start Menu:

ezicon my_script.py --desktop

Terminal Commands (Shell Shortcuts)

Create a batch command to run your script from any terminal:

ezicon my_script.py --terminal run_my_app

Then just type run_my_app in your terminal to execute it.

Force Console Window

If you have a GUI app but still want to see the console output:

ezicon my_gui_app.py --force-console

Manage Shortcuts

List all shortcuts created by ezicon:

ezicon --list

Remove all shortcuts:

ezicon --clean

Delete a specific shortcut:

ezicon --delete "My Awesome App"

After creating the program icon, you can execute your python script from the Start Menu or Desktop.