Folder Share

Folder Share is a simple one-file app for moving files between your computer, phone, tablet, or another computer on the same Wi-Fi.

Put folder_share.py inside a folder, run it, scan the QR code, and open that folder from any browser.

No accounts. No cloud. No cables. No pip install.

What You Can Do

• Browse folders from another device.
• Click files to download them.
• Upload files into the shared folder.
• Drag and drop files into the web page.
• See upload and download progress.
• See live requests on the host dashboard.
• Scan a real QR code from the dashboard.
• Use it as a single Python file.

Supported Operating Systems

Folder Share should work on:

• Linux
• Windows
• macOS

It only needs Python 3 and a web browser.

The receiving device can be anything with a browser: (you may also upload from the other device back to orignal device,,,, so 2 way share is possible)

• Android phone
• iPhone or iPad
• Windows PC
• Mac
• Linux PC
• Chromebook

Both devices must be connected to the same local network or Wi-Fi.

Python Requirement

You need Python 3 installed on the computer that will share the folder.

Check if Python is installed:

python3 --version

On Windows, this may be:

py --version

If Python is not installed, install it from the official Python website:

https://www.python.org/downloads/

On Windows, make sure to enable Add python.exe to PATH during installation.

Easiest Setup

1. Download folder_share.py.
2. Put it inside the folder you want to share.
3. Run it.
4. Your browser opens a dashboard with a QR code.
5. Scan the QR code from your phone or another device.

Run On Linux Or macOS

Open a terminal inside the folder that contains folder_share.py, then run:

python3 folder_share.py

Optional: make it double-click/runnable from terminal:

chmod +x folder_share.py
./folder_share.py

Run On Windows

Open PowerShell inside the folder that contains folder_share.py, then run:

py folder_share.py

If py does not work, try:

python folder_share.py

One Copy-Paste Setup

These commands download only folder_share.py from this repository and run it in the current folder.

Linux or macOS:

python3 - <<'PY'
from urllib.request import urlretrieve
urlretrieve('https://raw.githubusercontent.com/MIbrahimPro/Foldershare/main/folder_share.py', 'folder_share.py')
PY
python3 folder_share.py

Windows PowerShell:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MIbrahimPro/Foldershare/main/folder_share.py" -OutFile "folder_share.py"; py folder_share.py

What You Will See

When Folder Share starts, it prints something like this:

Folder Share started
Sharing: /home/user/Documents/MyFolder
Local:   http://127.0.0.1:8765/
Network: http://192.168.1.42:8765/
Dashboard: http://127.0.0.1:8765/qr

The dashboard opens automatically on the computer running the script.

Use the dashboard QR code or the Network link from another device.

Do not use the Local link on your phone. 127.0.0.1 only works on the computer running the server.

How To Stop It

Go back to the terminal window and press:

Ctrl+C

Important Security Note

Folder Share is for quick personal sharing on a trusted local network.

There is no password.

Anyone on the same network who can open the link can browse, download, and upload files in the shared folder.

The script blocks access outside the folder where folder_share.py is placed, but you should still stop the server when you are done.

Do not use this on public Wi-Fi unless you understand the risk.

Troubleshooting

If your phone cannot open the page:

• Make sure your phone and computer are on the same Wi-Fi.
• Use the Network link, not the Local link.
• Check whether your firewall is blocking the port.
• Try typing the Network link manually in the phone browser.

Tip: Try connecting the pc to the phone hotspot and restarting the server

If the QR code scans but the page does not load:

• The QR is probably correct, but the devices may not be able to see each other on the network.
• Some guest Wi-Fi networks block device-to-device connections.

If port 8765 is already in use:

• Folder Share automatically tries the next available port.

Credits

Folder Share is self-contained and does not install or import external packages at runtime.

During development, these QR-code projects helped with direction and validation:

• Segno by Lars Heuer. Segno helped confirm that a real browser-rendered SVG QR code was a better approach than terminal QR output.
• Nayuki QR Code generator by Project Nayuki. Nayuki's reference implementation was used to validate the embedded QR matrix generation.

Thank you to both projects.

License

Folder Share is released under the MIT License.

See LICENSE for details.