pyshortcuts

library1.9.9pypypi✓ verified 87d ago

Create desktop and Start Menu shortcuts for Python scripts on Windows, macOS, and Linux. Current version 1.9.7 (released March 2025). Active development, roughly 2-3 releases per year.

devops

pip install pyshortcuts

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · PYSHORTCUTS

pyshortcuts

devopspythonv1.9.9

Install

1.8s avg

Import

391ms

Disk

18MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.9.9 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.410s · 19.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.8s · import 0.372s · 20MB

18MB installed

● package 18MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

make_shortcut

✓ from pyshortcuts import make_shortcut

No common wrong import.

get_desktop

✓ from pyshortcuts import get_desktop

✗ from pyshortcuts.utils import get_desktop

Changed in 1.9.3; get_desktop is now exported from the main package.

Creates a desktop shortcut to a Python script.

from pyshortcuts import make_shortcut from pyshortcuts import get_desktop script = 'myscript.py' desktop = get_desktop() make_shortcut(script, name='MyScript', folder=desktop) print('Shortcut created on desktop')

pyshortcuts --version

Debug

Known issues

breakingPython 3.10 is now required. Versions 1.9.6+ dropped support for Python 3.9 and earlier. Upgrade your Python environment if using older versions.

fix

Use Python 3.10 or newer.

affects: >=1.9.6

deprecatedThe 'noexe' argument in make_shortcut is deprecated since 1.9.1. Use 'script' as the full path with no exe.

fix

Set script to the full path of the Python script and do not set 'exe'; or use the command-line -x flag.

affects: >=1.9.1

gotchaOn macOS, shortcuts may not open a terminal automatically unless the terminal app is properly configured. Use the -t flag or terminal=True argument to ensure a terminal window appears.

fix

Add terminal=True to make_shortcut or use -t on command line.

affects: all

gotchaWhen running inside a virtual environment, the executable path may not resolve correctly. Version 1.9.7 removes Path.resolve() to improve virtual environment support. If you experience issues, use the full path to the Python executable explicitly.

fix

Upgrade to 1.9.7 or pass the full path to the Python executable.

affects: <1.9.7

Errors

Common errors & fixes

AttributeError: module 'pyshortcuts' has no attribute 'get_desktop'

Before version 1.9.3, get_desktop was not exported from the main package; it was in pyshortcuts.utils.

fix

Upgrade to pyshortcuts>=1.9.3 or import from pyshortcuts.utils import get_desktop (deprecated).

ImportError: No module named 'pyshortcuts'

pyshortcuts is not installed, or the virtual environment is not activated.

fix

Run 'pip install pyshortcuts' in the correct environment.

Upgrade

Version history

1.9.9latest on PyPI · released May 13, 2026

Audit

Dependencies

pywin32optionalRequired only on Windows for creating shell links

numpyoptionalOptional, used for some icon handling examples

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/newville/pyshortcuts ↗

packagehttps://pypi.org/project/pyshortcuts/ ↗

docshttps://github.com/newville/pyshortcuts/README.md ↗

changeloghttps://github.com/newville/pyshortcuts/issues ↗