Skip to main content

psgshortcut

A PySimpleGUI Application

PySimpleGUI Shortcut Tool

Creates Windows shortcuts for Python programs (and anything else) - drop the file on the window, click Create Shortcut.

Features

  • Drag and drop - drop a .py, .pyw, .exe or any file anywhere on the window
  • Automatic icon - the icon embedded in a PySimpleGUI program (ICON = b'iVBORw0KGgo...') is found, converted to a .ico and used for the shortcut. Programs without an icon get the PySimpleGUI default icon
  • Icon preview - see the icon the shortcut will get before you make it; use your own .ico / .png / .gif / .jpg instead if you prefer
  • Choose where it goes - same folder as the program, the Desktop, the Start Menu (so you can pin it to the taskbar) or any folder
  • Pins properly - the shortcut carries the program's Windows taskbar App ID, so the running window groups under its own pinned icon (works with PySimpleGUI 6.3.17+ and older versions)
  • Right launcher automatically - .pyw files are launched with pythonw.exe (no console window), .py files with python.exe
  • Shortcut name, arguments and description (tooltip) are all optional
  • Shortcut to this program - one click fills in a shortcut to psgshortcut itself, so you can pin psgshortcut to your taskbar or Desktop
  • Makes shortcuts to EXE and other files too - Windows uses the file's own icon unless you choose another
  • Dark HarborMist theme, Escape closes the window, Settings on the right-click menu

Installation

Using PIP with PyPI

The latest official release of PySimpleGUI products can be found on PyPI. To pip install the demo applications from PyPI, use this command

If you use the command python on your computer to invoke Python (Windows):

python -m pip install --upgrade psgshortcut

If you use the command python3 on your computer to invoke Python (Linux, Mac):

python3 -m pip install --upgrade psgshortcut

Using PIP with GitHub

You can also pip install the PySimpleGUI Applications that are in the PySimpleGUI GitHub account. The GitHub versions have bug fixes and new programs/features that have not yet been released to PyPI. To directly pip install from that repo:

If you use the command python on your computer to invoke Python (Windows):

python -m pip install --upgrade https://github.com/PySimpleGUI/psgshortcut/zipball/main

If you use the command python3 on your computer to invoke Python (Linux, Mac):

python3 -m pip install --upgrade https://github.com/PySimpleGUI/psgshortcut/zipball/main

Requirements

Installed automatically by pip: PySimpleGUI, pywin32 (writes the .lnk files), psgdnd (drag and drop) and pillow (makes the .ico files). psgshortcut still runs if psgdnd or pillow are missing - you just lose drag and drop, or icon conversion.

Usage

Once installed, launch psgshortcut by typing the following in your command line:

psgshortcut

You can also pass a file: psgshortcut my_program.pyw pre-fills the target.

  1. Drop your program on the window (or click Browse)
  2. Check the icon in the preview, pick where the shortcut should go
  3. Click Create Shortcut (or press Enter)

The shortcut is a normal Windows .lnk file - move it anywhere, double-click it, or pin it to the taskbar.

Make a Shortcut To This Program

Click Shortcut to this program. The form is filled in with psgshortcut itself (icon included), pick a destination and click Create Shortcut. Put it on your Desktop or in the Start Menu and pin it from there - no command window needed.

Make Shortcuts To Anything

You can not only make shortcuts to Python programs, but you can make shortcuts to EXE and other files. Drop the file on the window, click Create Shortcut and you'll find the shortcut in the folder you chose.

Pinning To The Taskbar

Windows will only pin shortcuts whose target is an EXE, which is why Python shortcuts are made with pythonw.exe (or python.exe) as the target and your program as the argument - the Python field shows which one will be used. Put the shortcut in the Start Menu or on the Desktop, then right-click it → Pin to taskbar.

For the running program to group under its pinned icon (instead of opening a second, generic Python icon) the shortcut must carry the same taskbar App ID the program sets. psgshortcut writes the .lnk with IShellLink + IPropertyStore and sets System.AppUserModel.ID to:

  • PySimpleGUI.App.<md5 of the script path> for programs run with PySimpleGUI 6.3.17 or newer (the ID PySimpleGUI derives from the script path - psgshortcut asks the interpreter in the Python field which version it has)
  • mycompany.myproduct.subproduct.version for programs run with an older PySimpleGUI
  • whatever the program passes to sg.set_options(win_app_id=...), if it does
  • no ID for programs that don't use PySimpleGUI

Where the Icons Go

The .ico files made from your programs' embedded icons are saved next to the program (my_program.pyw → my_program.ico). Right-click → Settings can send them to one central folder (%LOCALAPPDATA%\psgshortcut\icons) instead if you prefer to keep program folders clean.

Copyright 2023-2026 PySimpleGUI.

Licensed under LGPL3.

Contributing

I'm happy to receive issues describing bug reports and feature requests! The project does not accept pull requests.

Metadata

Release files for psgshortcut 6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for psgshortcut 6.1
File Size Uploaded Provenance Actions
psgshortcut-6.1.tar.gz 114.0 kB Without provenance Details for psgshortcut-6.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for psgshortcut 6.1
File Interpreter ABI Platform Actions
psgshortcut-6.1-py3-none-any.whl Python 3 none any Details for psgshortcut-6.1-py3-none-any.whl

Total release size: 227.7 kB

Release files / psgshortcut-6.1.tar.gz

Download URL psgshortcut-6.1.tar.gz
Size 114.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4eeff0ce504993d2b58a5043b440d40126aea5bc10c5d39e37bd5cf4c6e732c0
BLAKE2b-256 checksum
How to use checksums
2ef9f88c366517e5af6371fbfb8996f3080cd0ddbe72bc3ebb71944eb4b426d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / psgshortcut-6.1-py3-none-any.whl

Download URL psgshortcut-6.1-py3-none-any.whl
Size 113.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8d9355ec26eba69c7537fe567b8c1764e6ab613d2ebffc359ca6a9f5d8bb28ea
BLAKE2b-256 checksum
How to use checksums
e2134045b37291355d444c4d78169d5d1e2351ac4e6118c6512b11da3d1932d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Security for psgshortcut 6.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page