Metadata-Version: 2.4
Name: pclink
Version: 4.0.0
Summary: Cross-platform desktop app for secure remote PC control and management, featuring a lightweight built-in WebUI and API for local or remote access.
Author-email: AZHAR ZOUHIR <support@bytedz.com>
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://github.com/BYTEDz/PCLink
Project-URL: Repository, https://github.com/BYTEDz/PCLink
Project-URL: Issues, https://github.com/BYTEDz/PCLink/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE.AGPL
License-File: NOTICES
Requires-Dist: fastapi>=0.95.0
Requires-Dist: uvicorn[standard]>=0.22.0
Requires-Dist: websockets>=12.0
Requires-Dist: wsproto>=1.2.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: pyperclip>=1.8.2
Requires-Dist: mss>=9.0.0
Requires-Dist: keyboard>=0.13.5
Requires-Dist: requests>=2.31.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: getmac>=0.9.0
Requires-Dist: pyautogui>=0.9.54
Requires-Dist: pynput>=1.7.6
Requires-Dist: packaging>=21.0
Requires-Dist: PyYAML>=6.0.0
Requires-Dist: click
Requires-Dist: qrcode>=7.3
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: Pillow>=9.0.0
Requires-Dist: pystray>=0.19.0
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: evdev>=1.6.0; sys_platform == "linux"
Requires-Dist: comtypes>=1.2.0; sys_platform == "win32"
Requires-Dist: pycaw>=20230330; sys_platform == "win32"
Requires-Dist: pywin32>=306; sys_platform == "win32"
Requires-Dist: winrt-runtime; sys_platform == "win32"
Requires-Dist: winrt-Windows.Foundation; sys_platform == "win32"
Requires-Dist: winrt-Windows.Data.Xml.Dom; sys_platform == "win32"
Requires-Dist: winrt-Windows.UI.Notifications; sys_platform == "win32"
Requires-Dist: winrt-Windows.Media.Control; sys_platform == "win32"
Requires-Dist: winshell>=0.6; sys_platform == "win32"
Provides-Extra: dev
Requires-Dist: pytest>=7.3.1; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: black>=23.3.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.3.0; extra == "dev"
Requires-Dist: pyinstaller>=5.13.0; extra == "dev"
Requires-Dist: pre-commit>=2.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: svglib>=1.5.1; extra == "dev"
Requires-Dist: reportlab>=4.0.0; extra == "dev"
Dynamic: license-file

<div align="center">

<img src="assets/pclink_logo.svg" width="120" alt="PCLink Logo">

# PCLink Server

**The secure backbone for your personal PC remote control ecosystem.**

[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg?style=for-the-badge)](https://www.gnu.org/licenses/agpl-3.0)
[![Platform](https://img.shields.io/badge/Platform-Windows%20|%20Linux-lightgrey?style=for-the-badge)](https://github.com/BYTEDz/PCLink)
[![Python](https://img.shields.io/badge/Python-3.8%2B-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
[![Play Store](https://img.shields.io/badge/Android-Play%20Store-3DDC84?style=for-the-badge&logo=google-play&logoColor=white)](https://play.google.com/store/apps/details?id=xyz.bytedz.pclink)

PCLink is a modern, **web-first** server designed for **secure remote PC management**.
Featuring a high-performance FastAPI backend, a responsive Web UI, and an extensible plugin system.

[**Download Releases**](https://github.com/BYTEDz/PCLink/releases) • [**Mobile App**](https://play.google.com/store/apps/details?id=xyz.bytedz.pclink) • [**Wiki Portal**](https://github.com/BYTEDz/PCLink/wiki)

</div>

## 🚀 Quick Start

### 1. Install

Choose your platform to install the PCLink server:

- **🐧 Linux (Automated):**
  ```bash
  bash <(curl -fsSL https://raw.githubusercontent.com/BYTEDz/PCLink/main/install.sh)
  ```
- **🪟 Windows:** Download the [`.exe` installer](https://github.com/BYTEDz/PCLink/releases).
- **📦 Arch Linux:** Available on the AUR (maintained by [Mark Wagie](https://github.com/yochananmarqos)). Install with `yay -S pclink`.
- **⚙️ Manual:** Grab the [`.deb` or `.rpm`](https://github.com/BYTEDz/PCLink/releases) packages from the releases page.

### 2. Launch

Start the PCLink server on your machine:

```bash
pclink
```

### 3. Pair & Connect

1. Open `https://localhost:38080/ui/` in your desktop browser.
2. Open the **PCLink Mobile App**.
3. Scan the QR code displayed on your Web UI and approve the connection.

> [!NOTE]
> New to PCLink? Check out the comprehensive [**Getting Started Guide**](https://github.com/BYTEDz/PCLink/wiki/Getting-Started).

> [!IMPORTANT]
> **Antivirus Notice:** PCLink integrates deeply with your system (remote input, screen capture, terminal access). This can occasionally trigger **False Positive** alerts (e.g., `Wacatac.B!ml`) from Windows Defender. Every release is verified via VirusTotal. This project is 100% Open Source and transparent.

---

## 🎨 Key Features

- **🌐 Web-First Management** – Configure your server and manage paired devices entirely from your browser.
- **🛡️ Zero-Trust Security** – Mandatory HTTPS, manual device approval, and cryptographically secure sessions.
- **⌨️ Peripheral Sync** – Seamlessly control your remote keyboard, mouse, system volume, and media playback.
- **📂 Remote Explorer** – Full-featured remote file browser and system process manager.
- **💻 Integrated Shell** – WebSocket-powered terminal access for remote CLI management.
- **🧩 Extensible Architecture** – Add capabilities via the built-in [Extension System](https://github.com/BYTEDz/PCLink/wiki/Extension-Development).

---

## 🏗️ Documentation Hub

Whether you're a user or a developer, we have you covered in our **[Project Wiki](https://github.com/BYTEDz/PCLink/wiki)**.

| 📚 User Guides                                                                              | 🛠️ Development                                                                         | ⚙️ Reference                                                                  |
| :------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------- |
| 📖 [Getting Started](https://github.com/BYTEDz/PCLink/wiki/Getting-Started)                 | 🏗️ [Build from Source](https://github.com/BYTEDz/PCLink/wiki/Building-and-Development) | 🔌 [API Endpoints](https://github.com/BYTEDz/PCLink/wiki/API-Endpoints)       |
| 🌐 [Web UI Guide](https://github.com/BYTEDz/PCLink/wiki/Web-UI)                             | 🧩 [Extension SDK](https://github.com/BYTEDz/PCLink/wiki/Extension-Development)        | 🔒[Security Model](https://github.com/BYTEDz/PCLink/wiki/Server-Architecture) |
| ⚠️ [Troubleshooting](https://github.com/BYTEDz/PCLink/wiki/Getting-Started#troubleshooting) | 🤝 [Contributing](https://github.com/BYTEDz/PCLink/wiki/Contributing)                  | ⚡ [Quick Commands](https://github.com/BYTEDz/PCLink/wiki/Quick-Reference)    |

---

## 🌐 The Ecosystem & Activity

Join the wider PCLink ecosystem:

- 🏠 **[PCLink Server](https://github.com/BYTEDz/PCLink)** – The core backend service.
- 📱 **[PCLink Mobile](https://play.google.com/store/apps/details?id=xyz.bytedz.pclink)** – Companion app for Android.
- 📦 **[PCLink Extensions](https://github.com/BYTEDz/pclink-extensions)** – Official repository for community extensions.

<div align="center">

[![GitHub Release Date](https://img.shields.io/github/release-date/BYTEDz/PCLink?style=flat-square&color=blue)](https://github.com/BYTEDz/PCLink/releases) [![GitHub Last Commit](https://img.shields.io/github/last-commit/BYTEDz/PCLink?style=flat-square&color=green)](https://github.com/BYTEDz/PCLink/commits/main) [![GitHub Issues](https://img.shields.io/github/issues/BYTEDz/PCLink?style=flat-square&color=orange)](https://github.com/BYTEDz/PCLink/issues)

[![PCLink Stars](https://starchart.cc/BYTEDz/PCLink.svg?variant=adaptive)](https://starchart.cc/BYTEDz/PCLink)

</div>

---

## 🤝 Support & Maintainers

<div align="center">

<a href="https://github.com/AzharZouhir">
  <img src="https://github.com/AzharZouhir.png" width="100px" style="border-radius: 50%; border: 3px solid #3d76ab;" alt="Azhar Zouhir"/>
</a>

**[Azhar Zouhir](https://github.com/AzharZouhir)**
_Creator & Lead Developer_
Building the next generation of PC remote management.

[![GitHub](https://img.shields.io/badge/GitHub-181717?style=flat-square&logo=github&logoColor=white)](https://github.com/AzharZouhir) [![Email](https://img.shields.io/badge/Email-D14836?style=flat-square&logo=gmail&logoColor=white)](mailto:support@bytedz.com)

🕊️ Free Palestine • 🇩🇿 Made with ❤️ in Algeria

</div>
