# Welcome! ## Getting Started ### Logins if this is your first time here and you're looking to get a login tell Grant. if you do have a login just press the "login" button up on the top right and type your password. ### Mobile this suite comes with quite a few cool features you'll see further down but first lets talk mobile usage. #### Android app Get it on F-Droid '' f-droid version info '' github version info #### iOS shortcuts there is no iPhone app, but the following shortcuts are almost as good: * [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) * pics become lowres if you share from gallery to shortcut, so better to launch the shortcut and pick stuff from there ## Features ### uploading drag files/folders into the web-browser to upload dragdrop is the recommended way, 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 through dragdrop 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 NB: you can undo/delete your own uploads with `[🧯]` [unpost](#unpost) (and this is also where you abort unfinished uploads, but you have to refresh the page first) up2k has several advantages: * you can drop folders into the browser (files are added recursively) * files are processed in chunks, and each chunk is checksummed * uploads autoresume 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 reuploads affected chunks * the client doesn't upload anything that already exists on the server * no filesize limit, even when a proxy limits the request size (for example Cloudflare) * much higher speeds than ftp/scp/tarpipe on some internet connections (mainly american ones) thanks to parallel connections * the last-modified timestamp of the file is preserved ### file-search dropping files into the browser also lets you see if they exist on the server ![copyparty-fsearch-fs8](https://user-images.githubusercontent.com/241032/129635361-c79286f0-b8f1-440e-aaf4-6e929428fac9.png) 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]` * the main reason filesearch is combined with the uploader is cause the code was too spaghetti to separate it out somewhere else, this is no longer the case but now i've warmed up to the idea too much ### hotkeys the browser has the following hotkeys (always qwerty) * `?` 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 textfile is open: * `I/K` prev/next textfile * `S` toggle selection of open file * `M` close textfile * 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, 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: * `^s` save * `^h` header * `^k` autoformat table * `^u` jump to next unicode character * `^e` toggle editor / preview * `^up, ^down` jump paragraphs ### Media player plays almost every audio format there is (if the server has FFmpeg installed for on-demand transcoding) the following audio formats are usually always playable, even without FFmpeg: `aac|flac|m4a|mp3|ogg|opus|wav` some hilights: * 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 * not perfectly gapless but can get really close (see settings + eq below); good enough to enjoy gapless albums as intended * videos can be played as audio, without wasting bandwidth on the video 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 start playing from, like that example does)