---
id: pyshortcuts
version: "1.9.9"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyshortcuts — Create desktop and Start Menu shortcuts for python scripts

License: permissive · Maintenance: active · Downloads: 120.0K/mo

## What it is and what it does

Pyshortcuts is a pure-Python utility that generates platform-native shortcuts for launching Python scripts and applications. It abstracts away the OS-specific details of shortcut creation—on Windows it generates .lnk files in the Start Menu and Desktop, on macOS it builds minimal application bundles, and on Linux it creates .desktop files in standard application directories. The package includes both a Python API (make_shortcut function) and a command-line tool (pyshortcut), plus an optional wxPython-based GUI for interactive shortcut creation.

The tool is designed for developers who need to package Python applications for end users without requiring elevated permissions or system-level modifications. It handles Anaconda Python specially on Windows to ensure shortcuts run in the correct environment, supports custom icons, and allows shortcuts to be organized into subfolders. After creation, users retain full control to rename, move, or delete shortcuts.

Use it for:

- Bundle a Python application with an installer that creates desktop shortcuts automatically during post-installation setup
- Provide end users with clickable desktop launchers for command-line Python tools without requiring terminal knowledge
- Create Start Menu entries for Python GUI applications on Windows with custom icons and descriptions
- Generate platform-specific shortcuts as part of a Python package's installation or deployment workflow
- Build a launcher GUI (using the wxPython interface) that lets non-technical users create shortcuts for their own scripts

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Creates desktop and Start Menu shortcuts for Python scripts and applications across Windows, macOS, and Linux with a consistent cross-platform interface.

Yes. Pyshortcuts solves a genuine cross-platform problem with low install friction, active maintenance, no security vulnerabilities, and permissive licensing. It is production-stable and suitable for both direct use and integration into larger installation workflows. Install it if you need to create desktop shortcuts for Python scripts or applications across multiple operating systems.

## Install

pip install pyshortcuts
uv add pyshortcuts
poetry add pyshortcuts

## Installing pyshortcuts

Before you install: Low friction: pure Python wheel with only three runtime dependencies (tabulate, charset-normalizer, pywin32). Active maintenance with recent release (93 days ago) and 128 repository stars. Supports Python 3.10 through 3.14.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal restrictions.

Quickstart:

pip install pyshortcuts

from pyshortcuts import make_shortcut

make_shortcut('/path/to/script.py', name='MyApp', icon='/path/to/icon.ico')

On Windows, pywin32 is automatically installed. The optional wxPython GUI requires separate installation (pip install wxPython).

Verify before relying:

- Whether icon format support (.ico, .icns) is consistent across all three platforms or has platform-specific limitations
- Performance characteristics when creating shortcuts for scripts with complex command-line arguments
- Behavior when shortcuts target scripts in virtual environments or non-standard Python installations

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 120.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

create desktop shortcuts python, start menu shortcuts cross-platform, python script launcher, desktop application shortcuts, cross-platform shortcut creation, python gui launcher, application shortcut generator, cross-platform, desktop-integration, installer-tool

[View on SkillFed](https://skillfed.io/packages/pyshortcuts) · [View on PyPI](https://pypi.org/project/pyshortcuts/)