global-directory
Share files from your computer for free. One command. Anyone gets a link.
No account. No upload. No cost. Files stay on your machine — just a public link anyone can open from any device.
How simple is it?
cd /your/folder
global-directory start
That is it. A public link and QR code appear in your terminal. Share either one. Stop anytime.
Why people use it
| You want to... | Old way | With global-directory |
|---|---|---|
| Share files with a client | Upload to cloud, set permissions, send link | One command, instant link |
| Send a large video or folder | Too big for email, slow to upload | No size limits, works instantly |
| Share a project with a teammate | Zip it, upload it, wait | Public link in seconds |
| Show files during a meeting | Screen share only | QR code — anyone scans and opens |
| Share from Mac to Android | Platform tools won't connect | Link opens on any device |
| Give someone temporary access | Cloud accounts, permissions, storage | Start, share, stop when done |
Why it is different
- Free — no cost, ever
- No account — nothing to sign up for
- No upload — files served directly from your machine, nothing stored in cloud
- One command — literally just one
- Any device — phone, laptop, tablet, any OS, any browser
- Full control — Ctrl+C stops sharing instantly, link dies immediately
Install
pip install global-directory
Then install the free connector (one time only):
Mac → brew install cloudflared
Linux → https://github.com/cloudflare/cloudflared/releases
Windows → winget install Cloudflare.cloudflared
No Cloudflare account needed.
Usage
cd /folder/you/want/to/share
global-directory start
A public link and QR code appear. Share either one.
To stop:
global-directory stop
How it works
- Starts a local file server on your machine
- Opens a free Cloudflare quick tunnel
- Prints a public link and QR code in your terminal
- Anyone with the link can browse and download your files
What people see
A clean file browser — grid or list view, search by name, filter by file type, sort by name or size, navigate into subfolders, download anything.
Limitations
- Free quick tunnels support up to 200 simultaneous connections
- Traffic routes through Cloudflare infrastructure — do not share confidential files
- Windows: cloudflared does not auto-update — check github.com/cloudflare/cloudflared for updates
GitHub
Release files for global-directory 3.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| global_directory-3.0.3.tar.gz | 12.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| global_directory-3.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 23.1 kB
Release files / global_directory-3.0.3.tar.gz
| Download URL | global_directory-3.0.3.tar.gz |
|---|---|
| Size | 12.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7c9274c4e5c5e2249b2633347bd480f56e2b42f163d019e9fb39216faa7e5bc3
|
|
BLAKE2b-256 checksum How to use checksums |
2cf067a864cc45de231fd7089cb3d328bcea821e429a50b08ac52169782e37fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.1
|
Release files / global_directory-3.0.3-py3-none-any.whl
| Download URL | global_directory-3.0.3-py3-none-any.whl |
|---|---|
| Size | 11.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
476d888e2fa9832fdf68eaf4f147a6f13b37f8ef6b1efe18c3b38636a6e7eba6
|
|
BLAKE2b-256 checksum How to use checksums |
6ce85b9c22c1f29efe65b65725d93dd90f29a01f53669039086095cd1eebd5f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.1
|