README

💾🎉 copyparty

turn almost any device into a file server with resumable uploads/downloads using any web browser

 server only needs Python (2 or 3), all dependencies optional
 🔌 protocols: http(s) // webdav // sftp // ftp(s) // tftp // smb/cifs
 📱 android app // iPhone shortcuts

👉 Get started! or visit the read-only demo server 👀 running on a nuc in my basement

📷 screenshots: browser // upload // unpost // thumbnails // search // fsearch // zip-DL // md-viewer

🎬 videos: upload // cli-upload // race-the-beam // 👉 feature-showcase (youtube)

built in Norway 🇳🇴 with contributions from not-norway


 readme toc

 top
     quickstart - just run copyparty-sfx.py -- that's it! 🎉
         mirrors - other places to download copyparty from
         at home - make it accessible over the internet
         on servers - you may also want these, especially on servers
     features - also see comparison to similar software
     testimonials - small collection of user feedback
 motivations - project goals / philosophy
     notes - general notes
 bugs - roughly sorted by chance of encounter
     not my bugs - same order here too
 breaking changes - upgrade notes
 FAQ - "frequently" asked questions
 accounts and volumes - per-folder, per-user permissions
     shadowing - hiding specific subfolders
     dotfiles - unix-style hidden files/folders
 the browser - accessing a copyparty server using a web-browser
     tabs - the main tabs in the ui
     hotkeys - the browser has the following hotkeys
     navpane - switching between breadcrumbs or navpane
     thumbnails - press g or 田 to toggle grid-view instead of the file listing
     zip downloads - download folders (or file selections) as zip or tar files
     uploading - drag files/folders into the web-browser to upload
         file-search - dropping files into the browser also lets you see if they exist on the server
         unpost - undo/delete accidental uploads
         self-destruct - uploads can be given a lifetime
         race the beam - download files while they're still uploading (demo video)
         incoming files - the control-panel shows the ETA for all incoming files
     file manager - cut/paste, rename, and delete files/folders (if you have permission)
     shares - share a file or folder by creating a temporary link
     batch rename - select some files and press F2 to bring up the rename UI
     rss feeds - monitor a folder with your RSS reader
     opds feeds - browse and download files from your e-book reader
     recent uploads - list all recent uploads
     media player - plays almost every audio format there is
         playlists - create and play m3u8 playlists
         creating a playlist - with a standalone mediaplayer or copyparty
         audio equalizer - and dynamic range compressor
         fix unreliable playback on android - due to phone / app settings
     textfile viewer - with realtime streaming of logfiles and such (demo)
     markdown viewer - and there are two editors
    

Top issues

Discussions

Latest release

read-only demo server at https://a.ocv.me/pub/demo/
 docker image ╱ similar software ╱ client testbed

there is a discord server with an @everyone in case of future important updates, such as vulnerabilities (most recently 2026-10-06)

 recent important news

 v1.20.25 (2026-10-06) improved shadowing on Windows/MacOS
 v1.20.19 (2026-07-27) fixed an FTP-server vuln (upload outside defined volumes)
 v1.20.17 (2026-07-06) introduced csp nonces, possibly breaking some javascript-based plugins

 🧪 new features

 xvol/xdev now usually doesn't list symlinks that can't be followed 7ce483e