{"id":51592334,"url":"https://github.com/kiran99756/localshare","last_synced_at":"2026-07-11T16:00:21.467Z","repository":{"id":370814349,"uuid":"1296884789","full_name":"kiran99756/Localshare","owner":"kiran99756","description":"Secure Local Network File Sharing App built with FastAPI, WebSockets, QR Codes and AES Encryption.","archived":false,"fork":false,"pushed_at":"2026-07-11T05:42:56.000Z","size":60,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-11T07:11:54.433Z","etag":null,"topics":["encryption","fastapi","file-sharing","local-network","python","qrcode","sqlite","websocket","windows","zeroconf"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kiran99756.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-10T20:36:00.000Z","updated_at":"2026-07-11T05:52:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kiran99756/Localshare","commit_stats":null,"previous_names":["kiran99756/localshare"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kiran99756/Localshare","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiran99756%2FLocalshare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiran99756%2FLocalshare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiran99756%2FLocalshare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiran99756%2FLocalshare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kiran99756","download_url":"https://codeload.github.com/kiran99756/Localshare/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiran99756%2FLocalshare/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35367446,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["encryption","fastapi","file-sharing","local-network","python","qrcode","sqlite","websocket","windows","zeroconf"],"created_at":"2026-07-11T16:00:16.294Z","updated_at":"2026-07-11T16:00:21.447Z","avatar_url":"https://github.com/kiran99756.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📡 Local Share\n\n**Drop a file on your laptop, pick it up on your phone — no cloud, no cables, no account.**\n\nA self-hosted, LAN-only file-sharing web app: drag-and-drop uploads with a live progress bar, instant image/video preview, search, rename, a QR code + auto device discovery (mDNS), a shared-password login, and every file encrypted at rest. Runs anywhere Python runs, or as a single double-click `.exe` on Windows.\n\n\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)\n[![FastAPI](https://img.shields.io/badge/built%20with-FastAPI-009688.svg)](https://fastapi.tiangolo.com/)\n[![Build Windows exe]https://github.com/kiran99756/Localshare/releases/tag/v1.0.0\n## Why\n\nSharing a file between your laptop and your phone shouldn't require uploading it to a cloud you don't control, emailing it to yourself, or plugging in a cable. If both devices are on the same Wi-Fi, this spins up a tiny private webpage every device on that network can use — nothing leaves the LAN.\n\n## Features\n\n- 📤 **Drag-and-drop upload** with a real per-file progress bar\n- 🖼️ **Image \u0026 video preview** inline, no download needed\n- 🔍 **Search** across shared files\n- ✏️ **Rename** files from the browser\n- 📱 **Auto discovery, two ways** — scan the QR code, use `localshare.local` (mDNS), *or* a UDP broadcast beacon (`discovery.py`) that any client on the LAN can query for the server's IP — useful when mDNS is flaky\n- 🌐 **Optional internet sharing** — a \"Share Over the Internet\" button opens a temporary public HTTPS link (via a Cloudflare quick tunnel, no account/port-forwarding needed) for the rare case someone off your Wi-Fi needs a file. Password login still applies.\n- 📲 **Installable on Android** — Add to Home Screen for an app-like icon (PWA manifest + service worker); full standalone install works once accessed over HTTPS (e.g. the internet-sharing link above)\n- 🔒 **Password-protected + encrypted at rest** (AES via `cryptography`/Fernet) — a stolen laptop or leaked backup is just ciphertext\n- 💬 **Live chat + online presence** over WebSockets\n- 🖥️ **Single-file Windows `.exe`** — no Python required on the target machine\n- 🌗 Dark mode\n\n## Quick start\n\n```bash\ngit clone https://github.com/kiran99756/Localshare.git\ncd local-share\npip install -r requirements.txt\npython main.py\n```\n\nThe terminal prints your auto-generated password and a URL to open on your phone (or just scan the QR code shown on the page).\n\n### Windows (no Python needed)\n\nGrab `LocalShare.exe` from [Releases](../../releases) and double-click it. Or build it yourself — see [BUILD.md](BUILD.md).\n\n### Internet sharing (optional, one-time setup)\n\nThe \"Share Over the Internet\" button needs the free `cloudflared` binary installed once on the host machine — details in [BUILD.md](BUILD.md#3-internet-sharing-feature-optional-one-time).\n\nFull requirements/build details for every path (dev run, Windows exe, internet sharing, Android install) are in **[BUILD.md](BUILD.md)**.\n\n## Tech stack\n\nFastAPI + WebSockets · SQLite · vanilla JS/CSS (no build step) · `cryptography` for at-rest encryption · `zeroconf` for mDNS · PyInstaller for the Windows build.\n\n## Roadmap / ideas\n\n- [ ] Native Android app (currently: installable PWA via \"Add to Home Screen\")\n- [ ] Linux/macOS `.app` / AppImage builds (Windows exists via PyInstaller already)\n- [ ] Per-file expiry / auto-delete\n- [ ] Folder/zip upload support\n\nContributions welcome — see [Contributing](#contributing).\n\n## Contributing\n\nIssues and PRs are welcome. Good first areas: the roadmap above, UI polish, or testing on more Android/iOS browser combos. Please open an issue before a large PR so we can align on approach first.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiran99756%2Flocalshare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkiran99756%2Flocalshare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiran99756%2Flocalshare/lists"}