# pyscut - Python Shortcut Creator

`pyscut` is a Python utility that allows you to create **Windows Desktop Shortcuts (.lnk)** for any Python script.  
It uses the built-in `win32com.client` (via pywin32, automatically included with modern Python installations on Windows) to create shortcuts, so **the user does not need to install pywin32 manually**.

---

## 🌟 Features

- Create a `.lnk` shortcut for any Python file.
- Choose whether the script runs:
  - **With terminal** (`python.exe`)  
  - **Hidden** (`pythonw.exe`) for GUI scripts
- Assign a custom icon (`.ico`) to the shortcut.
- Set the working directory of the script.
- Shortcut is automatically placed on the **Desktop**.

---

## ⚙️ Requirements

- **Windows OS** (shortcuts are Windows-specific)
- Python 3.7+ (Windows installation)

---

## 📝 Usage

Import the package and call the main function **with all necessary parameters**:

```python
from pyscut import createDesktopShortcut

createDesktopShortcut(
    targetFile=r"C:\Path\To\YourScript.py",    # Full path to the Python file
    targetFileDir=r"C:\Path\To",               # Working directory of the script
    name="MyShortcut",                          # Name for the desktop shortcut
    icon=r"C:\Path\To\Icon.ico",               # Optional icon file
    terminal=True                               # True = run with terminal; False = run hidden
)
