explaingit

9001/copyparty

📈 Trending★ 44,889PythonAudience · vibe coderComplexity · 2/5ActiveLicenseSetup · easy

TLDR

A self-hosted file server in a single Python script that lets you share, upload, and browse files over your network without cloud services or complex setup.

Mindmap

mindmap
  root((copyparty))
    What it does
      File sharing server
      Browser and app access
      Network drive mounting
    Protocols supported
      HTTP and HTTPS
      WebDAV and SFTP
      FTP and SMB
    Key features
      Resumable uploads
      Media player built-in
      Full-text search
      Access permissions
    Use cases
      Home network sharing
      NAS backup server
      Mobile file access
    Tech details
      Single Python file
      No dependencies
      Cross-platform

Things people build with this

USE CASE 1

Set up a personal file server on a home computer to share files with family or roommates over your local network.

USE CASE 2

Back up files from phones and laptops to a NAS device without relying on cloud storage services.

USE CASE 3

Mount a folder on your computer as a network drive using WebDAV to access files as if they were local.

USE CASE 4

Stream audio and video files to any device on your network with the built-in media player.

Tech stack

PythonHTTP/HTTPSWebDAVSFTPSMB

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice and license text.

In plain English

copyparty is a self-hosted file server that you can run from a single Python script on almost any computer, turning that machine into a personal file-sharing server accessible from a browser or standard file-transfer client. The problem it solves is the need to share, upload, and browse files over a network without relying on cloud services or setting up complex server software. Because it is distributed as one self-contained Python file with no required dependencies, you can start a file server on a computer with just Python installed by running a single command. The feature set is unusually broad for a single-file project. It supports multiple protocols for accessing files: an HTTP/HTTPS web interface, WebDAV (which lets operating systems mount it as a network drive), SFTP, FTP, TFTP, and SMB. Uploads through the browser are resumable, if a large upload is interrupted, it picks up where it left off rather than restarting from zero. The server supports file deduplication (if you upload the same file twice, it stores only one copy), a built-in media player for audio and video, thumbnail generation for images, full-text and metadata search for music tags and file attributes, per-folder and per-user access permissions, zip downloads of entire folders, automatic service announcement on the local network (zeroconf/mDNS), and an Android app and iPhone shortcuts for mobile use. Files can be downloaded while still being uploaded, and you can set uploads to self-destruct after a time period. You would use copyparty when you need a quick, powerful personal file server for a home network, a NAS device, or any situation where you want to share or back up files without a cloud service. It runs on Python 2 or 3, is cross-platform, and requires no installation beyond downloading the single script file.

Copy-paste prompts

Prompt 1
How do I set up copyparty on my Raspberry Pi to share files with my home network?
Prompt 2
Show me how to enable WebDAV in copyparty so I can mount it as a network drive on Windows.
Prompt 3
How do I configure per-folder permissions in copyparty so different users can only access certain directories?
Prompt 4
What's the best way to use copyparty's resumable uploads for backing up large files over a slow connection?
Prompt 5
How do I set up SFTP access in copyparty for secure file transfers from the command line?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.