Metadata-Version: 2.4
Name: ptool-launcher
Version: 0.0.1
Summary: Cross-platform floating quick access launcher with compact ball mode, edit support, and autostart
Author-email: abheekaryan <alterzehn02@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/abheekaryan/pToolFloatingLauncher
Project-URL: Repository, https://github.com/abheekaryan/pToolFloatingLauncher
Project-URL: Issues, https://github.com/abheekaryan/pToolFloatingLauncher/issues
Keywords: floating,launcher,quick-access,tkinter,desktop,ball
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pystray>=0.19.0
Requires-Dist: Pillow>=10.0.0
Dynamic: license-file

# pTool - Cross-Platform Floating Quick Access Launcher

A powerful floating always-on-top quick access panel for folders, files, apps and webpages. Works on Windows and Linux.

## Features

- **Always Floating** above all windows (toggleable)
- **Quick Folders** - Desktop, Downloads, Documents + custom (with Edit via right-click)
- **Quick Files** - Add any file for quick access (with Edit)
- **Quick Apps** - Smart defaults + custom apps (with Edit)
- **Quick Webpages** - Add any URL (with Edit)
- **Compact / Quick Ball mode** - Shrinks to a small floating orb that docks only to left/right edges
- **Right-click Edit** on any card
- **Tooltips** on all buttons
- **Autostart** on login (via standard .desktop method)
- **Themes**, opacity, always-on-top, position memory
- **Survives terminal close** on Linux (auto-daemonizes)
- Cross-platform (Windows + Linux)

## One-Click Installation (Recommended for Linux)

From the folder containing `install_pTool.sh` and `floating_launcher.py`:

```bash
bash install_pTool.sh
```

The installer will:
- Install dependencies
- Put pTool in `~/.local/bin/ptool`
- Create desktop entry
- Optionally enable autostart

After installation, search for **pTool** in your menu or type `ptool` in terminal.

## Portable Run (no installation)

```bash
python3 floating_launcher.py
```

## Autostart

Tick **"Start on startup"** in Settings (⚙). It uses the standard Linux `.desktop` method (exactly like the reference QuickFloat app).

## Logs

Logs are saved to:
`~/.config/PToolV1/PToolV1.log`

You can open it from inside the app via Settings → "Open Log File" button (added for easy copy-paste).

## Uninstall

```bash
bash uninstall_pTool.sh
```

## License
MIT

Enjoy your floating launcher! 🚀
