global-directory

Share files from your computer for free. One command. Anyone gets a public link.

No account. No upload. No cost. Files stay on your machine — just a public link anyone can open from any device.

Terminal

Features

One command to share any folder publicly
Preview files inline — images, video, audio, PDF, code with syntax highlighting
Beautiful file browser — grid and list view
Filter by type — Images, Video, Audio, Docs, Code, Data, Archives
Search by filename, sort by name, size or date
Extension chips — see and filter by exact file extension
QR code printed in terminal for instant mobile access
Breadcrumb navigation — browse into subfolders
Free — Cloudflare quick tunnels, no account needed
Files never leave your machine — nothing is uploaded
Works on Mac, Linux, Windows

pip install global-directory

Install the free tunnel connector once:

Mac      →  brew install cloudflared
Linux    →  https://github.com/cloudflare/cloudflared/releases
Windows  →  winget install Cloudflare.cloudflared

cd /any/folder/you/want/to/share
global-directory start

A public URL and scannable QR code appear in your terminal. Share either one. Press Ctrl+C or run the stop command to end the session.

global-directory stop

File Browser

Code Preview

Image Preview

You want to...	Without this	With global-directory
Share files with a client	Upload to Drive, set perms, 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 opens on phone
Share from Mac to Android	AirDrop does not work cross-platform	Link opens on any device
Give temporary download access	Cloud accounts, permissions, storage	Start, share link, stop when done

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 releases manually
Text file preview is capped at 100 KB to protect the browser

Pull requests welcome. For major changes please open an issue first to discuss what you would like to change.

MIT — free to use, modify and distribute.

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for global-directory 4.0.2
File	Size	Uploaded
global_directory-4.0.2.tar.gz	19.0 kB	Sep 26, 2026	Details

Table of built distributions (wheels) for global-directory 4.0.2
File	Interpreter	ABI	Platform	Reset
global_directory-4.0.2-py3-none-any.whl 19.0 kB Sep 26, 2026	Python 3	none	any	Details

Total release size: 38.0 kB

Download URL	global_directory-4.0.2.tar.gz
Size	19.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`72837c47dd57a3ec2f55c778746d0e02e3f69edae4989169aa173e04398669d1`
BLAKE2b-256 checksum How to use checksums	`c9103f61ab627c2bd277566313e92986056a53e2c59650e4efcd71ccfb4d5d63`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.1`

Download URL	global_directory-4.0.2-py3-none-any.whl
Size	19.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b7ac02c71803802c1247cef3cd40c4e2ba0b6b564cca5e4ae60eb49631e7cbad`
BLAKE2b-256 checksum How to use checksums	`f67bcaba8aab3328d3df8b6e1e70555f1ce07cdf8da24a8b004f343b8248541b`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.1`