# 🎉 **~ {{cfg.name}} ~** 🎉 Welcome {{self.uname}} ! **copyparty** is a really cool all-in-one portable file server with accelerated resumable uploads, dedup, WebDAV, FTP, TFTP, zeroconf, media indexer, thumbnails++, and much more. No dependencies required! ## Getting Started Login with your password in the upper-right corner, no username required. If you need an account, or password reset, contact **Hordini**. Your named directory is only accessible to **you** Contact **Hordini** if you would like to share a new or existing directory with another user Only this **README** is visible without an account Full documentation and source code is available on [GitHub](https://github.com/9001/copyparty/blob/hovudstraum/README.md) ## Features ### Uploading * Drag files/folders into the web-browser to upload * Drag-drop is the recommended method, but you may also: * Select some files (not folders) in your file explorer and press CTRL-V inside the browser window * Use the [command-line uploader](https://github.com/9001/copyparty/tree/hovudstraum/bin#u2cpy) * Upload using [curl, sharex, ishare, ...](#client-examples) * When uploading files via drag-drop or CTRL-V, this initiates an upload using `[🚀] up2k`; there are two browser-based uploaders available: * `[🎈] bup` - the basic uploader, supports almost every browser since netscape 4.0 * `[🚀] up2k` - the good / fancy one `[🚀] up2k` has several advantages: * Files can be dropped into the browser (files are added recursively) * Files are processed in chunks, and each chunk is checksummed * Uploads auto-resume if they are interrupted by network issues * Uploads resume if you reboot your browser or PC, just upload the same files again * Server detects any corruption; the client re-uploads affected chunks * The client doesn't upload anything that already exists on the server * No file size limits, even when a proxy limits the request size (for example Cloudflare) * Much higher speeds than FTP/SCP/Tarpipe on some internet connections thanks to parallel connections * The last-modified timestamp of the file is preserved > File uploads can be stopped or deleted with `[🧯]` [unpost](#unpost), however you must refresh the page first. ### File Search Dropping files into the browser also allows you check if they exist on the server When you drag/drop files into the browser, you will see two dropzones: `Upload` and `Search` > On a phone? Toggle the `[🔎]` switch green before tapping the big yellow Search button to select your files. The files will be hashed on the client-side, and each hash is sent to the server, which checks if that file exists somewhere Files go into `[ok]` if they exist (and you get a link to where it is), otherwise they land in `[ng]` ### Media Player Almost every audio format can be played from copyparty Some highlights: * OS-Integration: Control playback from your phone's lockscreen ([Windows](https://user-images.githubusercontent.com/241032/233213022-298a98ba-721a-4cf1-a3d4-f62634bc53d5.png) // [iOS](https://user-images.githubusercontent.com/241032/142711926-0700be6c-3e31-47b3-9928-53722221f722.png) // [Android](https://user-images.githubusercontent.com/241032/233212311-a7368590-08c7-4f9f-a1af-48ccf3f36fad.png)) * Shows the audio waveform in the seekbar * Almost perfectly seamless playback transition * Videos can be played as audio for reduced bandwidth Click the `play` link next to an audio file, or copy the link target to [share it](https://a.ocv.me/pub/demo/music/Ubiktune%20-%20SOUNDSHOCK%202%20-%20FM%20FUNK%20TERRROR!!/#af-1fbfba61&t=18) (optionally with a timestamp to begin playback from) ### Hotkeys The following hotkeys are available while in a browser: * `?` Show hotkeys help * `B` Toggle breadcrumbs / [navpane](#navpane) * `I/K` Prev/Next folder * `M` Parent folder (or unexpand current) * `V` Toggle folders / textfiles in the navpane * `G` Toggle list / [grid view](#thumbnails) -- same as `田` bottom-right * `T` Toggle thumbnails / icons * `ESC` Close various things * `Ctrl` + `K` Delete selected files/folders * `Ctrl` + `X` Cut selected files/folders * `Ctrl` + `C` Copy selected files/folders to clipboard * `Ctrl` + `V` Paste (move/copy) * `Y` Download selected files * `F2` [Rename](#batch-rename) selected file/folder * When a file/folder is selected (in not-grid-view): * `Up/Down` Move cursor * `Shift` + `Up/Down` Select and move cursor * `Ctrl` + `Up/Down` Move cursor and scroll viewport * `Space` Toggle file selection * `Ctrl-A` Toggle select all * When a text file is open: * `I/K` Prev/Next text file * `S` Toggle selection of open file * `M` Close text file * When playing audio: * `J/L` Prev/next song * `U/O` Skip 10sec back/forward * `0..9` Jump to 0%..90% * `P` Play/Pause (also starts playing the folder) * `Y` Download file * When viewing images / playing videos: * `J/L` or `Left/Right` Prev/Next file * `Home/End` First/Last file * `F` Toggle fullscreen * `S` Toggle selection * `R` Rotate clockwise (shift=ccw) * `Y` Download file * `Esc` Close viewer * Videos: * `U/O` Skip 10sec back/forward * `0..9` Jump to 0%..90% * `P/K/Space` Play/Pause * `M` Mute * `C` Continue playing next video * `V` Loop entire file * `[` Loop range (start) * `]` Loop range (end) * When the navpane is open: * `A/D` Adjust tree width * In the [grid view](#thumbnails): * `S` Toggle multiselect * `Shift` + `A/D` Zoom * In the markdown editor: * `Ctrl` + `S` Save * `Ctrl` + `H` Header * `Ctrl` + `K` Autoformat table * `Ctrl` + `U` Jump to next unicode character * `Ctrl` + `E` Toggle editor / preview * `Ctrl` + `Up` or `Down` Jump paragraphs ## Mobile ### Android app Get it on F-Droid '' f-droid version info '' github version info ### iOS Shortcuts An iPhone app is not currently available, however the following shortcuts will work: * [upload to copyparty](https://www.icloud.com/shortcuts/41e98dd985cb4d3bb433222bc1e9e770) ([offline](https://github.com/9001/copyparty/raw/hovudstraum/contrib/ios/upload-to-copyparty.shortcut)) ([png](https://user-images.githubusercontent.com/241032/226118053-78623554-b0ed-482e-98e4-6d57ada58ea4.png)) based on the [original](https://www.icloud.com/shortcuts/ab415d5b4de3467b9ce6f151b439a5d7) by [Daedren](https://github.com/Daedren) (thx!) * Can strip exif, upload files, pics, vids, links, clipboard * Can download links and rehost the target file on copyparty (see first comment inside the shortcut) * Images resolution will be lowered if shared from the gallery to shortcut, so it's recommended to launch the shortcut and select files from there.