Pineapplee turns any folder on your machine into a shareable web interface — browse, upload, download, and manage files from any device on your network, or share publicly with a single flag.

✨ Features

🚀 Installation

Recommended (using pipx)

pipx installs Python CLI tools in isolated environments — no conflicts, no permission errors. This is the best way to install on macOS, Linux, and Windows.

# Install pipx if you don't have it
# macOS / Linux (Homebrew)
brew install pipx

# Windows (scoop)
scoop install pipx

# Or with pip (any OS)
pip install pipx
pipx ensurepath

Then install Pineapplee:

pipx install pineapplee

Update to the latest version:

pipx upgrade pineapplee

Using pip

If you're inside a virtual environment or managing packages yourself:

pip install pineapplee

Update:

pip install --upgrade pineapplee

Getting externally-managed-environment error? Modern macOS/Linux (PEP 668) blocks system-wide pip installs to protect your OS Python. Use pipx instead (see above), or use a virtual environment:

python3 -m venv ~/myenv
source ~/myenv/bin/activate
pip install pineapplee

🚀 Quick Start

# Serve the current directory
pineapplee

# Serve a specific path
pineapplee ~/Downloads

# Different port
pineapplee --port 9000

# Share publicly over the internet
pineapplee --public

# Check installed version
pineapplee --version

Open http://localhost:8089 — and you're in.

📖 Usage

usage: pineapplee [-h] [-v] [--port PORT] [--public] [directory]

positional arguments:
  directory         Directory to serve (default: current directory)

options:
  -h, --help        show this help message and exit
  -v, --version     show installed version and exit
  --port, -p      Port to listen on (default: 8089)
  --public        Expose publicly via Cloudflare Tunnel

Local network sharing

Pineapple binds to 0.0.0.0, so any device on your LAN can reach it at the Network URL printed in the terminal:

  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
  ┃ 🍍 Pineapple File Server                  ┃
  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
  ┃                                           ┃
  ┃   📂 Serving     /Users/you/Documents     ┃
  ┃   🔗 Local       http://localhost:8089    ┃
  ┃   🌐 Network     http://192.168.1.5:8089  ┃
  ┃   📦 Max upload  500 MB                   ┃
  ┃                                           ┃
  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
  ┃   Press Ctrl+C to stop                    ┃
  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Public sharing

pineapplee --public

On first run this downloads the cloudflared binary (~50 MB, cached to ~/.pineapplee/bin/). A public trycloudflare.com URL is printed — share it with anyone, anywhere.

🔒 Security

• All file paths are validated and confined to the served directory
• Symlinks pointing outside the root are silently ignored
• Upload size capped at 500 MB by default
• Hidden files (dotfiles, __pycache__, node_modules, .egg-info, etc.) are never shown

Note: Pineapple is designed for local and trusted-network use. Do not expose it to the public internet without understanding the implications.

📋 Requirements

• Python >= 3.8
• Flask >= 2.0

All dependencies are installed automatically.

🐛 Troubleshooting

📄 License

MIT © KalaaKaar