ptool-launcher 0.0.1

Cross-platform floating quick access launcher with compact ball mode, edit support, and autostart

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 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)

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 uninstall_pTool.sh

License

MIT

Enjoy your floating launcher! 🚀