Open-source project
9001/copyparty avatar
9001/copyparty

copyparty: one Python file, six protocols, and a browser UI that does more than serve files

Portable file server with accelerated resumable uploads, dedup, WebDAV, SFTP, FTP, TFTP, zeroconf, media indexer, thumbnails++ all in one file

47,365 stars1,926 forksPythonMIT

At a glance

What is it?
copyparty is a portable file server that runs from a single Python script and adds resumable uploads, dedup, WebDAV, SFTP, FTP, TFTP, SMB, and a media indexer. The trade-off is a feature list so long that some parts are clearly rougher than others.
Who is it for?
Adopt copyparty if you need a quick, dependency-light file server on a machine where installing a full stack is overkill, and if you value resumable uploads and a browser UI that can also play media. Skip it if you require a hardened SMB implementation or if you want a project with a more conservative release cadence.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 25 days ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • 9001/copyparty47,365 ★ · +1,105
Star history
Repository2026-08-182026-11-15
9001/copyparty46.3k47.4k

1,105 Stars in the last 89 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

What copyparty actually is

The feature list is enormous. The README lists HTTP, WebDAV, SFTP, FTP, TFTP, and SMB/CIFS servers, plus an Android app and iOS shortcuts. There is a browser UI with tabs, hotkeys, thumbnails, zip downloads, a media player, a textfile viewer, a markdown viewer, search, RSS feeds, and OPDS feeds. That is not a typo. It also has file deduplication, file indexing, upload rules, autocompression, and a control panel that shows ETA for incoming files. The sheer scope is impressive, but it also raises a question: can one Python file do all of that well? The answer, based on the README's own caveats, is that some features are better than others.

How it works: one process, many protocols

The server configuration uses command-line arguments, config files, or a mix of both. That is a flexible approach, but the README's table of contents shows a long list of flags, so you will need to read the docs carefully. The version-checker feature is meant to help you sleep better at night, which is a nice way of saying it checks for updates automatically. Logging goes to stdout by default. Zeroconf announces services on the LAN via mDNS and SSDP, so other devices can discover the server automatically. There is also a QR code feature to print a link for quick access from a phone.

Getting it running: the quickstart and beyond

The quickstart is simple: download copyparty-sfx.py from the releases page and run it. That is it. The README directs you to the latest release asset, and the file is self-contained. You do not need to install anything else, assuming you have Python. For a home setup, you might want to expose it over the internet, and the README has an 'at home' section on making it accessible over the internet. For servers, it has an 'on servers' section listing additional flags you may want. You can start an FTP server with --ftp 3921, a TFTP server with --tftp 3969, and an SFTP server with its own flag. The README also shows how to connect to WebDAV from Windows using the GUI. The server config supports arguments, config files, or a mix, so you can put your setup in a file and reuse it. The README mentions upload-chunking configuration with u2sz, and upload rules via volflags. You can also set filesystem permissions and ownership per volume with chmod and chown flags. The key point is that the initial setup is trivial, but tuning it to your needs requires reading a lot of documentation.

The browser UI: more than a file list

The browser interface is where copyparty stands out. It is not just a directory listing. You get tabs, hotkeys, a navpane, and a grid view for thumbnails. Pressing 'g' toggles grid view. You can drag files and folders from your desktop into the browser to upload them. Dropping files also lets you see if they exist on the server, which is a file-search feature. There is an "unpost" feature to undo accidental uploads, and uploads can be given a lifetime with self-destruct. The media player plays almost every audio format, and there is an audio equalizer and dynamic range compressor. The README even warns about fixing unreliable playback on Android due to phone or app settings. The textfile viewer can stream logfiles in realtime, which is useful for monitoring. The markdown viewer has two editors and supports server-side variable expansion. The file manager allows cut/paste, rename, delete, and batch rename with F2. You can create shares with temporary links, and there are RSS and OPDS feeds. This is a lot of functionality in a browser UI, and it is clear the author has spent a lot of time on it. The trade-off is that the UI is likely heavier than a simple file server, and it may not be as polished as dedicated tools for each feature.

Real limitations and failure modes

The README has a bugs section, which is refreshingly honest. It is sorted by chance of encounter, and there is also a "not my bugs" section. That suggests the author knows where the rough edges are. One concrete limitation is the SMB server: the README calls it "unsafe, slow, not recommended for wan." That is a direct warning. If you need SMB for Windows file sharing, you should look elsewhere. Another limitation is SFTP speed: the README says it goes roughly 700 MiB/s, which is slower than WebDAV and FTP. That is still fast, but if you need maximum throughput, use WebDAV or FTP. The recent v1.20.25 release is labelled 'SECURITY: shadowing on windows/mac', which shows that security issues exist and are being patched. The README also mentions "breaking changes" and upgrade notes, so you should read those before updating. The file indexing feature requires a rescan, and there are exclude-patterns and filesystem guards to avoid traversing into other filesystems. The dedup feature relies on symlinks, which may not work on all filesystems, especially on Windows or network drives. So copyparty is not the right tool if you need a robust, secure SMB server or if you need maximum SFTP performance.

Alternatives and how they differ

The README links to a comparison with similar software (docs/versus.md). Dedicated single-protocol servers such as vsftpd for FTP, OpenSSH for SFTP or Nginx for HTTP are the obvious alternatives. They do not give you the multi-protocol, browser-UI, resumable-upload, dedup package in one file. The key difference is that copyparty is a Swiss Army knife, while the alternatives are specialized tools. If you only need one protocol, a dedicated server is probably better. If you need several protocols on a small device, copyparty saves you from running multiple daemons. The README also mentions an Android app and iOS shortcuts, which are integrations you would not get with a plain FTP server.

Maintenance, upgrades, and license

The project is actively maintained, with releases every few weeks. The recent releases show a pattern: v1.20.26 on 2026-10-14, v1.20.25 on 2026-10-06, and v1.20.24 on 2026-09-19. That is a steady cadence. The security fix in v1.20.25 is a reminder that you need to update regularly. The README has a "breaking changes" section, so upgrades are not always drop-in. You should read the release notes before updating. The license is MIT, which means you can use it freely, modify it, and embed it in commercial products, as long as you retain the copyright notice. You are not required to share your changes, but if you find a bug, the project likely welcomes contributions. The single-file nature means that upgrading is as simple as downloading the new copyparty-sfx.py and replacing the old one, but you need to check if your config flags are still valid. The version-checker feature can help you stay on top of updates. If you use the single file rather than the wheels built by scripts/make-pypi-release.sh, you are responsible for keeping it up to date. The README also mentions mirrors for downloading, which is useful if GitHub is blocked.

Editorial conclusion

Adopt copyparty if you need a quick, dependency-light file server on a machine where installing a full stack is overkill, and if you value resumable uploads and a browser UI that can also play media. Skip it if you require a hardened SMB implementation or if you want a project with a more conservative release cadence. Before production use, verify the security fixes in recent releases, especially the shadowing fix on Windows and macOS in v1.20.25, and test the dedup and indexing features on your actual file tree. The project is MIT licensed, so you can audit and patch it, but the single-file approach means you must read the code yourself.

Frequently asked questions

What is a copyparty file server?

It is a portable file server that turns almost any device with Python into a file server with resumable uploads and downloads from a web browser. The server needs only Python and the project states all dependencies are optional, with WebDAV, SFTP, FTP, TFTP and SMB available as additional protocols.

How do I install copyparty?

The quickstart sends you to the single-file download copyparty-sfx.py on the latest release and tells you to run it. If you prefer a wheel, pyproject.toml declares requires-python >=3.3 and one dependency, Jinja2, and setup.py states it is no longer in use since pyproject.toml and scripts/make-pypi-release.sh build the wheels.

What does copyparty do besides serving files?

It adds resumable and self-destructing uploads, undo for accidental uploads, temporary share links, symlink-based deduplication, a file indexer that powers music search, thumbnails, a textfile viewer that streams logfiles, a markdown viewer with two editors, search by size, date, path, name and mp3 tags, and rss and opds feeds.

How do I configure a copyparty server?

Configuration comes from command arguments, config files, or a mix of both. The documented flags include u2sz for upload chunking, upload rules through volflags, per-volume chmod and chown, and a version checker; the file indexing feature adds exclude-patterns, filesystem guards and a periodic rescan.

How do I access copyparty from a browser?

You connect with any web browser to the server and use the file manager, where cut, paste, rename and delete are available when you have permission. Dragging files or folders into the page uploads them, pressing g or the grid icon toggles the thumbnail view, F2 opens batch rename, and shares create a temporary link to a file or folder.

Is copyparty safe to expose to the internet?

The project itself flags the smb server as unsafe, slow and not recommended for wan, so treat that protocol as LAN only. The README also has an 'at home' section on making the server accessible over the internet.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/9001-copyparty.svg)](https://hysenlabs.com/projects/9001-copyparty)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/9001-copyparty.svg)](https://hysenlabs.com/projects/9001-copyparty)

Was this useful?