9001/copyparty

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/9001/copyparty.svg?style=card)](https://bestofgithub.dev/repo/9001/copyparty)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/9001/copyparty.svg)](https://bestofgithub.dev/repo/9001/copyparty)

Loading README…

name	url-suffix	description
`tar`	`?tar`	plain gnutar, works great with `curl \| tar -xv`
`pax`	`?tar=pax`	pax-format tar, futureproof, not as fast
`tgz`	`?tar=gz`	gzip compressed gnu-tar (slow), for `curl \| tar -xvz`
`txz`	`?tar=xz`	gnu-tar with xz / lzma compression (v.slow)
`zip`	`?zip`	works everywhere, glitchy filenames on win7 and older
`zip_dos`	`?zip=dos`	traditional cp437 (no unicode) to fix glitchy filenames
`zip_crc`	`?zip=crc`	cp437 with crc32 computed early for truly ancient software

0. classic dark	2. flat pm-monokai	4. vice
1. classic light	3. flat light	5. hotdog stand

index.html	upload	download	software
28'900 req/s	6'900 MiB/s	7'400 MiB/s	no-proxy
18'750 req/s	3'500 MiB/s	2'370 MiB/s	haproxy
9'900 req/s	3'750 MiB/s	2'200 MiB/s	caddy
18'700 req/s	2'200 MiB/s	1'570 MiB/s	nginx
9'700 req/s	1'750 MiB/s	1'830 MiB/s	apache
9'900 req/s	1'300 MiB/s	1'470 MiB/s	lighttpd

index.html	upload	download	software
21'200 req/s	5'700 MiB/s	6'700 MiB/s	no-proxy
14'500 req/s	1'700 MiB/s	2'170 MiB/s	haproxy
11'100 req/s	2'750 MiB/s	2'000 MiB/s	traefik
8'400 req/s	2'300 MiB/s	1'950 MiB/s	caddy
13'400 req/s	1'100 MiB/s	1'480 MiB/s	nginx
8'400 req/s	1'000 MiB/s	1'000 MiB/s	apache
6'500 req/s	1'270 MiB/s	1'500 MiB/s	lighttpd

env-var	what it does
`PRTY_NO_CTYPES`	do not use features from external libraries such as kernel32
`PRTY_NO_DB_LOCK`	do not lock session/shares-databases for exclusive access
`PRTY_NO_ENVEXPAND`	do not expand environment-variables in configs and args
`PRTY_NO_IFADDR`	disable ip/nic discovery by poking into your OS with ctypes
`PRTY_NO_IMPRESO`	do not try to load js/css files using `importlib.resources`
`PRTY_NO_IPV6`	disable some ipv6 support (should not be necessary since windows 2000)
`PRTY_NO_LZMA`	disable streaming xz compression of incoming uploads
`PRTY_NO_MP`	disable all use of the python `multiprocessing` module (actual multithreading, cpu-count for parsers/thumbnailers)
`PRTY_NO_UNIDATA`	disable loading the unicodedata c-extension; saves 400k ram, breaks `--srch-nfkc`
`PRTY_NO_SQLITE`	disable all database-related functionality (file indexing, metadata indexing, most file deduplication logic)
`PRTY_NO_TLS`	disable native HTTPS support; if you still want to accept HTTPS connections then TLS must now be terminated by a reverse-proxy
`PRTY_NO_TPOKE`	disable systemd-tmpfilesd avoider
`PRTY_UNSAFE_STATE`	allow storing secrets into emergency-fallback locations

env-var	what it does
`PRTY_FORCE_MP`	force-enable multiprocessing (real multithreading) on MacOS and other broken platforms
`PRTY_FORCE_MAGIC`	use magic on Windows (you will segfault)

feature	ie6	ie9	ie10	ie11	ff 52	c 49	iOS	Andr
browse files	yep	yep	yep	yep	yep	yep	yep	yep
thumbnail view	-	yep	yep	yep	yep	yep	yep	yep
basic uploader	yep	yep	yep	yep	yep	yep	yep	yep
up2k	-	-	`*1`	`*1`	yep	yep	yep	yep
make directory	yep	yep	yep	yep	yep	yep	yep	yep
send message	yep	yep	yep	yep	yep	yep	yep	yep
set sort order	-	yep	yep	yep	yep	yep	yep	yep
zip selection	-	yep	yep	yep	yep	yep	yep	yep
file search	-	yep	yep	yep	yep	yep	yep	yep
file rename	-	yep	yep	yep	yep	yep	yep	yep
file cut/paste	-	yep	yep	yep	yep	yep	yep	yep
unpost uploads	-	-	yep	yep	yep	yep	yep	yep
navpane	-	yep	yep	yep	yep	yep	yep	yep
image viewer	-	yep	yep	yep	yep	yep	yep	yep
video player	-	yep	yep	yep	yep	yep	yep	yep
markdown editor	-	-	`*2`	`*2`	yep	yep	yep	yep
markdown viewer	-	`*2`	`*2`	`*2`	yep	yep	yep	yep
play mp3/m4a	-	yep	yep	yep	yep	yep	yep	yep
play ogg/opus	-	-	-	-	yep	yep	`*3`	yep
= feature =	ie6	ie9	ie10	ie11	ff 52	c 49	iOS	Andr

browser	will it blend
links (2.21/macports)	can browse, login, upload/mkdir/msg
lynx (2.8.9/macports)	can browse, login, upload/mkdir/msg
w3m (0.5.3/macports)	can browse, login, upload at 100kB/s, mkdir/msg
netsurf (3.10/arch)	is basically ie6 with much better css (javascript has almost no effect)
opera (11.60/winxp)	OK: thumbnails, image-viewer, zip-selection, rename/cut/paste. NG: up2k, navpane, markdown, audio
ie4 and netscape 4.0	can browse, upload with `?b=u`, auth with `&pw=wark`
ncsa mosaic 2.7	does not get a pass, pic1 - pic2
SerenityOS (7e98457)	hits a page fault, works with `?b=u`, file upload not-impl
sony psp 5.50	can browse, upload/mkdir/msg (thx dwarf) screenshot
nintendo 3ds	can browse, upload, view thumbnails (thx bnjmn)
Nintendo Wii (Opera 9.0 "Internet Channel")	can browse, can't upload or download (no local storage), can view images - works best with `?b=u`, default view broken

env-var	what it does
`PRTY_NO_ARGON2`	disable argon2-cffi password hashing
`PRTY_NO_CFSSL`	never attempt to generate self-signed certificates using cfssl
`PRTY_NO_DCRAW`	disable all libraw-based thumbnail support for RAW images
`PRTY_NO_FFMPEG`	audio transcoding goes byebye, thumbnailing must be handled by Pillow/libvips
`PRTY_NO_FFPROBE`	audio transcoding goes byebye, thumbnailing must be handled by Pillow/libvips, metadata-scanning must be handled by mutagen
`PRTY_NO_MAGIC`	do not use magic for filetype detection
`PRTY_NO_MUTAGEN`	do not use mutagen for reading metadata from media files; will fallback to ffprobe
`PRTY_NO_PARAMIKO`	disable sftp server (paramiko-based)
`PRTY_NO_PARTFTPY`	disable tftp server (partftpy-based)
`PRTY_NO_PIL`	disable all Pillow-based thumbnail support; will fallback to libvips or ffmpeg
`PRTY_NO_PILF`	disable Pillow `ImageFont` text rendering, used for folder thumbnails
`PRTY_NO_PIL_AVIF`	disable Pillow avif support (internal and/or plugin)
`PRTY_NO_PIL_HEIF`	disable 3rd-party Pillow plugin for HEIF support
`PRTY_NO_PIL_JXL`	disable 3rd-party Pillow plugin for JXL support
`PRTY_NO_PIL_WEBP`	disable use of native webp support in Pillow
`PRTY_NO_PSUTIL`	do not use psutil for reaping stuck hooks and plugins on Windows
`PRTY_NO_PYFTPD`	disable ftp(s) server (pyftpdlib-based)
`PRTY_NO_RAW`	same as `PRTY_NO_DCRAW` plus `PRTY_NO_RAWPY`
`PRTY_NO_RAWPY`	disable all rawpy-based thumbnail support for RAW images
`PRTY_NO_VIPS`	disable all libvips-based thumbnail support; will fallback to Pillow or ffmpeg

env-var	what it does
`PRTY_SYS_ALL`	all of the below
`PRTY_SYS_DNSLIB`	replace stolen/dnslib with upstream
`PRTY_SYS_IFADDR`	replace stolen/ifaddr with upstream
`PRTY_SYS_QRCG`	replace stolen/qrcodegen.py with upstream

💾🎉 copyparty

readme toc

quickstart

mirrors

at home

on servers

features

testimonials

motivations

notes

bugs

not my bugs

breaking changes

FAQ

accounts and volumes

shadowing

dotfiles

the browser

tabs

hotkeys

navpane

thumbnails

zip downloads

uploading

file-search

unpost

self-destruct

race the beam

incoming files

file manager

shares

batch rename

rss feeds

opds feeds

recent uploads

media player

playlists

creating a playlist

audio equalizer

fix unreliable playback on android

textfile viewer

markdown viewer

markdown vars

other tricks

searching

server config

version-checker

logging

zeroconf

mdns

ssdp

qr-code

ftp server

sftp server

webdav server

connecting to webdav from windows

tftp server

smb server

wopi server

browser ux

opengraph

file deduplication

file indexing

exclude-patterns

filesystem guards

periodic rescan

u2sz

upload rules

compress uploads

chmod and chown

other flags

descript.ion

dothidden

thumbnail pregen

database location

metadata from audio files

metadata from xattrs

file parser plugins

event hooks

zeromq