Only handle requests with the same origin via the service worker

## Enhancements
- Speed up update process by skipping waiting and claiming currently open pages -> no need to close all tabs in order to get an update anymore
- Update Bluesky icon from square to butterfly
- Update node dependencies

## Fixes
- Prevent service-worker from responding with redirect (fixes #384)
- Fix: switch off twitter button via env var not possible (#388)
- Add missing files to paths that get cached upon sw installation

## Languages
- Translations updates from Hosted Weblate (Japanese)

.dockerignore

@@ -1,5 +1,13 @@
-node_modules
 .github
 .git*
-
-*.md
+.idea
+dev
+docs
+licenses
+node_modules
+pairdrop-cli
+*.md
+*.yml
+Dockerfile
+rtc_config_example.json
+turnserver_example.conf

.github/ISSUE_TEMPLATE/bug-report.md

@@ -36,15 +36,15 @@ If applicable, add screenshots to help explain your problem.
 
 **Bug occurs on official PairDrop instance https://pairdrop.net/**
 No | Yes
-Version: v1.8.0
+Version: v1.11.2
 
 **Bug occurs on self-hosted PairDrop instance**
 No | Yes
 
 **Self-Hosted Setup**
 Proxy: Nginx | Apache2
-Deployment: docker run | docker-compose | npm run start:prod
-Version: v1.8.0
+Deployment: docker run | docker compose | npm run start:prod
+Version: v1.11.2
 
 **Additional context**
 Add any other context about the problem here.

.github/workflows/docker-image.yml

@@ -1,3 +1,14 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# GitHub recommends pinning actions to a commit SHA.
+# To get a newer version, you will need to update the SHA.
+# You can also reference a tag or branch, but the action may change without warning.
+
+# Build a Docker image whenever it is pushed to master
+
 name: Docker Image CI
 
 on:
@@ -13,6 +24,6 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
     - name: Build the Docker image
       run: docker build --pull . -f Dockerfile -t pairdrop

.github/workflows/github-image.yml

@@ -7,6 +7,8 @@
 # To get a newer version, you will need to update the SHA.
 # You can also reference a tag or branch, but the action may change without warning.
 
+# Create a Docker image and push it to ghcr.io whenever a new version tag is pushed
+
 name: GHCR Image CI
 
 on:
@@ -27,16 +29,16 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
         
       - name: Setup qemu
-        uses: docker/setup-qemu-action@v2.1.0
+        uses: docker/setup-qemu-action@68827325e0b33c7199eb31dd4e31fbe9023e06e3 # v3.0.0
 
       - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2.5.0
+        uses: docker/setup-buildx-action@f95db51fddba0c2d1ec667646a06c2ce06100226 # v3.0.0
 
       - name: Log in to the Container registry
-        uses: docker/login-action@f054a8b539a109f9f41c372932f1ae047eff08c9
+        uses: docker/login-action@343f7c4344506bcbf9b4de18042ae17996df046d # v3.0.0
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
@@ -44,12 +46,12 @@ jobs:
 
       - name: Extract metadata (tags, labels) for Docker
         id: meta
-        uses: docker/metadata-action@98669ae865ea3cffbcbaa878cf57c20bbf1c6c38
+        uses: docker/metadata-action@31cebacef4805868f9ce9a0cb03ee36c32df2ac4 # v5.3.0
         with:
           images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
 
       - name: Build and push Docker image
-        uses: docker/build-push-action@ad44023a93711e3deb337508980b4b5e9bcdc5dc
+        uses: docker/build-push-action@4a13e500e55cf31b7a5d59a38ab2040ab0f42f56 # v5.1.0
         with:
           context: .
           platforms: linux/amd64,linux/arm64

.github/workflows/zip-release.yml

@@ -0,0 +1,36 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# GitHub recommends pinning actions to a commit SHA.
+# To get a newer version, you will need to update the SHA.
+# You can also reference a tag or branch, but the action may change without warning.
+
+# Create a new zip file from pairdrop-cli whenever a new version tag is pushed
+
+name: Zip Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@master
+      - name: Archive Release
+        uses: thedoctor0/zip-release@b57d897cb5d60cb78b51a507f63fa184cfe35554 # v0.7.6
+        with:
+          filename: 'pairdrop-cli.zip'
+          directory: 'pairdrop-cli'
+          exclusions: '*.git* /*node_modules/* .editorconfig'
+      - name: Upload Release
+        uses: ncipollo/release-action@6c75be85e571768fa31b40abf38de58ba0397db5 # v1.13.0
+        with:
+          artifacts: "pairdrop-cli/pairdrop-cli.zip"
+          token: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,5 +1,7 @@
 node_modules
 .DS_Store
-fqdn.env
-/docker/certs
+/dev/certs
 qrcode-svg/
+turnserver.conf
+rtc_config.json
+ssl/

Dockerfile

@@ -1,14 +1,21 @@
-FROM node:lts-alpine
+FROM alpine:latest
 
 WORKDIR /home/node/app
 
 COPY package*.json ./
 
-RUN npm ci
+RUN apk add --no-cache nodejs npm
+RUN NODE_ENV="production" npm ci --omit=dev
 
+# Directories and files excluded via .dockerignore
 COPY . .
 
+# environment settings
+ENV NODE_ENV="production"
+
 EXPOSE 3000
 
 HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
   CMD wget --quiet --tries=1 --spider http://localhost:3000 || exit 1
+
+ENTRYPOINT ["npm", "start"]

README.md

@@ -1,131 +1,134 @@
 <div align="center">
   <a href="https://github.com/schlagmichdoch/PairDrop">
-    <img src="https://raw.githubusercontent.com/schlagmichdoch/PairDrop/master/public/images/android-chrome-512x512.png" alt="Logo"  width="150" height="150">
+    <img src="public/images/android-chrome-512x512.png" alt="Logo"  width="150" height="150">
   </a>
  
-  <h1>PairDrop</h1>
+  # _Send it_, with [PairDrop](https://pairdrop.net)
 
   <p>
-    Local file sharing in your browser. Inspired by Apple's AirDrop.
+    Local file sharing <a href="https://pairdrop.net"><strong>in your web browser</strong></a>. 
+    <br>
+    Inspired by Apple's AirDrop.
+    <br> 
+    Fork of Snapdrop.
+    <br>
+    <br>
+    <a href="https://github.com/schlagmichdoch/PairDrop/issues">Report a bug</a>
     <br />
-    <a href="https://pairdrop.net"><strong>Explore  »</strong></a>
-    <br />
-    <br />
-    <a href="https://github.com/schlagmichdoch/PairDrop/issues">Report Bug</a>
-    ·
-    <a href="https://github.com/schlagmichdoch/PairDrop/issues">Request Feature</a>
+    <a href="https://github.com/schlagmichdoch/PairDrop/issues">Request feature</a>
   </p>
 </div>
+<br>
 
 ## Features
-[PairDrop](https://pairdrop.net) is a sublime alternative to AirDrop that works on all platforms.
+File sharing on your local network that works on all platforms.
 
-- File Sharing on your local network
-  - Send images, documents or text via peer to peer connection to devices on the same local network.
-- Internet Transfers
-  - Join temporary public rooms to transfer files easily over the internet!
-- Web-Application 
-  - As it is web based, it runs on all devices.
+- A multi-platform AirDrop-like solution that works.
+  - Send images, documents or text via peer-to-peer connection to devices on the same local network.
+- Internet transfers
+  - Join temporary public rooms to transfer files easily over the Internet.
+- Web-app 
+  - Works on all devices with a modern web-browser.
+ 
+Send a file from your phone to your laptop?
+<br>Share photos in original quality with friends using Android and iOS?
+<br>Share private files peer-to-peer between Linux systems?
 
-You want to quickly send a file from your phone to your laptop?
-<br>You want to share photos in original quality with friends that use a mixture of Android and iOS?
-<br>You want to share private files peer to peer between Linux systems?
-<br>AirDrop is unreliable again?
-<br>_Send it with PairDrop!_
+<img src="docs/pairdrop_screenshot_mobile.gif" alt="Screenshot GIF showing PairDrop in use" style="width: 300px">
 
-Developed based on [Snapdrop](https://github.com/RobinLinus/snapdrop)
+## Differences to the [Snapdrop](https://github.com/RobinLinus/snapdrop) it is based on
+<details><summary>View all differences</summary>
 
-## Differences to Snapdrop
-<details><summary>Click to expand</summary>
-
-### Paired Devices and Public Rooms - Internet Transfer
-* Transfer files over the internet between paired devices or by entering temporary public rooms.
-* Connect to devices in complex network environments (public Wi-Fi, company network, Apple Private Relay, VPN etc.).
+### Paired Devices and Public Rooms — Internet Transfer
+* Transfer files over the Internet between paired devices or by entering temporary public rooms.
+* Connect to devices in complex network environments (public Wi-Fi, company network, iCloud Private Relay, VPN, etc.).
 * Connect to devices on your mobile hotspot.
-* Devices outside your local network that are behind a NAT are connected automatically via the PairDrop TURN server.
-* Connect to devices on your mobile hotspot.
-* You will always discover devices on your local network. Paired devices and devices in the same public room are shown additionally.
+* Devices outside of your local network that are behind a NAT are auto-connected via the PairDrop TURN server.
+* Devices from the local network, in the same public room, or previously paired are shown.
 
 #### Persistent Device Pairing
-* Pair your devices via a 6-digit code or a QR-Code.
-* Paired devices will always find each other via shared secrets independently of their local network. 
-* Paired devices are persistent. You find your devices even after reopening PairDrop.
-* You can edit and unpair devices easily
-* Ideal to always connect easily to your own devices
+
+Always connect to known devices
+
+* Pair devices via a 6-digit code or a QR-Code.
+* Paired devices always find each other via shared secrets independently of their local network. 
+* Pairing is persistent. You find your devices even after reopening PairDrop.
+* You can edit and unpair devices easily.
 
 #### Temporary Public Rooms
-* Enter a public room via a 5-letter code or a QR-Code.
-* Enter a public room to temporarily connect to devices outside your local network.
-* All devices in the same public room see each other mutually.
-* Public rooms are temporary. Public rooms are left as soon as PairDrop is closed.
-* Ideal to connect easily to others in complex network situations or over the internet.
 
-### [Improved UI for sending/receiving files](https://github.com/RobinLinus/snapdrop/issues/560)
-* Files are transferred only after a request is accepted first. On transfer completion files are downloaded automatically if possible.
+Connect to others in complex network situations, or over the Internet.
+
+* Enter a public room via a 5-letter code or a QR-code.
+* Enter a public room to temporarily connect to devices outside your local network.
+* All devices in the same public room see each other.
+* Public rooms are temporary. Closing PairDrop  leaves all rooms.
+
+### [Improved UI for Sending/Receiving Files](https://github.com/RobinLinus/snapdrop/issues/560)
+* Files are transferred after a request is accepted. Files are auto-downloaded upon completing a transfer, if possible.
 * Multiple files are downloaded as a ZIP file
-* On iOS and Android, in addition to downloading, files can be shared or saved to the gallery via the Share menu.
-* Multiple files are transferred at once with an overall progress indicator
+* Download, share or save to gallery via the "Share" menu on Android and iOS.
+* Multiple files are transferred at once with an overall progress indicator.
 
 ### Send Files or Text Directly From Share Menu, Context Menu or CLI
-* [Send files directly from context menu on Windows](/docs/how-to.md#send-files-directly-from-context-menu-on-windows)
-* [Send directly from share menu on iOS](/docs/how-to.md#send-directly-from-share-menu-on-ios)
-* [Send directly from share menu on Android](/docs/how-to.md#send-directly-from-share-menu-on-android)
-* [Send directly via command-line interface](/docs/how-to.md#send-directly-via-command-line-interface)
+* [Send files directly from context menu on Ubuntu (using Nautilus)](docs/how-to.md#send-multiple-files-and-directories-directly-from-context-menu-on-ubuntu-using-nautilus)
+* [Send files directly from the context menu on Windows](docs/how-to.md#send-files-directly-from-context-menu-on-windows)
+* [Send directly from the "Share" menu on iOS](docs/how-to.md#send-directly-from-share-menu-on-ios)
+* [Send directly from the "Share" menu on Android](docs/how-to.md#send-directly-from-share-menu-on-android)
+* [Send directly via the command-line interface](docs/how-to.md#send-directly-via-command-line-interface)
 
-### Other changes
-* Change your display name permanently to easily differentiate your devices
-* [Paste files/text and choose the recipient afterwords ](https://github.com/RobinLinus/snapdrop/pull/534)
+### Other Changes
+* Change your display name to easily differentiate your devices.
+* [Paste files/text and choose the recipient afterwards ](https://github.com/RobinLinus/snapdrop/pull/534)
 * [Prevent devices from sleeping on file transfer](https://github.com/RobinLinus/snapdrop/pull/413)
 * Warn user before PairDrop is closed on file transfer
 * Open PairDrop on multiple tabs simultaneously (Thanks [@willstott101](https://github.com/willstott101))
-* [Video and Audio preview](https://github.com/RobinLinus/snapdrop/pull/455) (Thanks [@victorwads](https://github.com/victorwads))
-* Switch theme back to auto/system after darkmode or lightmode is enabled
+* [Video and audio preview](https://github.com/RobinLinus/snapdrop/pull/455) (Thanks [@victorwads](https://github.com/victorwads))
+* Switch theme back to auto/system after dark or light mode is on
 * Node-only implementation (Thanks [@Bellisario](https://github.com/Bellisario))
-* Automatic restart on error (Thanks [@KaKi87](https://github.com/KaKi87))
+* Auto-restart on error (Thanks [@KaKi87](https://github.com/KaKi87))
 * Lots of stability fixes (Thanks [@MWY001](https://github.com/MWY001) [@skiby7](https://github.com/skiby7) and [@willstott101](https://github.com/willstott101))
 * To host PairDrop on your local network (e.g. on Raspberry Pi): [All peers connected with private IPs are discoverable by each other](https://github.com/RobinLinus/snapdrop/pull/558)
-* When hosting PairDrop yourself you can [set your own STUN/TURN servers](/docs/host-your-own.md#specify-stunturn-servers)
-* Built-in translations
+* When hosting PairDrop yourself, you can [set your own STUN/TURN servers](docs/host-your-own.md#specify-stunturn-servers)
+* Translations.
 
 </details>
 
-## Screenshots
-<img src="https://raw.githubusercontent.com/schlagmichdoch/PairDrop/master/docs/pairdrop_screenshot_mobile.gif" style="max-height: 50vh">
-
-## PairDrop is built with the following awesome technologies:
-* Vanilla HTML5 / ES6 / CSS3 frontend
-* [WebRTC](http://webrtc.org/) / [WebSockets](http://www.websocket.org/)
-* [NodeJS](https://nodejs.org/en/) backend
-* [Progressive Web App](https://wikipedia.org/wiki/Progressive_Web_App)
-* [IndexedDB API](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API)
-* [zip.js](https://gildas-lormeau.github.io/zip.js/)
-* [cyrb53](https://github.com/bryc) super fast hash function
-* [Weblate](https://weblate.org/) Web based localization tool
-
-Have any questions? Read our [FAQ](/docs/faq.md).
-
-You can [host your own instance with Docker](/docs/host-your-own.md).
-
-
-## Support PairDrop
-<a href="https://www.buymeacoffee.com/pairdrop" target="_blank">
-<img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" >
-</a>
-
-PairDrop is free and always will be.
-Still, we have to pay for the domain and the server.
-
-To contribute and support, please use BuyMeACoffee via the button above.
-
-Thanks a lot for supporting free and open software!
-
-## Translate PairDrop
+## Translate PairDrop on [Hosted Weblate](https://hosted.weblate.org/engage/pairdrop/)
 <a href="https://hosted.weblate.org/engage/pairdrop/">
-<img src="https://hosted.weblate.org/widget/pairdrop/pairdrop-spa/open-graph.png" alt="Translation status" style="max-height: 30vh" />
+<img src="https://hosted.weblate.org/widget/pairdrop/horizontal-blue.svg" alt="Translation status" style="width: 300px" />
 </a>
 
-## How to contribute
+## Built with the following awesome technologies:
+* Vanilla HTML5 / JS ES6 / CSS 3 frontend
+* [WebRTC](http://webrtc.org/) / WebSockets
+* [Node.js](https://nodejs.org/en/) backend
+* [Progressive web app (PWA)](https://en.wikipedia.org/wiki/Progressive_web_app) unified functionality
+* [IndexedDB API](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API) storage handling
+* [zip.js](https://gildas-lormeau.github.io/zip.js/) library
+* [cyrb53](https://github.com/bryc/code/blob/master/jshash/experimental/cyrb53.js) super-fast hash function
+* [NoSleep](https://github.com/richtr/NoSleep.js) display sleep, add wake lock ([MIT](licenses/MIT-NoSleep))
+* [heic2any](https://github.com/alexcorvi/heic2any) HEIC/HEIF to PNG/GIF/JPEG ([MIT](licenses/MIT-heic2any))
+* [Weblate](https://weblate.org/) web-based localization tool
+* [BrowserStack](https://www.browserstack.com/) This project is tested with BrowserStack
 
+[FAQ](docs/faq.md)
+
+[Host your own instance with Docker or Node.js](docs/host-your-own.md).
+
+## Support
+<a href="https://www.buymeacoffee.com/pairdrop" target="_blank">
+<img src="https://cdn.buymeacoffee.com/buttons/v2/default-blue.png" alt="Buy me a coffee" style="height: 60px !important;width: 217px !important;" >
+</a>
+<br />
+<br />
+
+PairDrop is libre, and always will be. \
+If you find it useful and want to support free and open-source software, please consider donating using the button above. \
+I footed the bill for the domain and the server, and you can help create and maintain great software by supporting me. \
+Thank you very much for your contribution!
+
+## Contributing
 Feel free to [open an issue](https://github.com/schlagmichdoch/pairdrop/issues/new/choose) or a
-[pull request](https://github.com/schlagmichdoch/pairdrop/pulls) but follow
-[Contributing Guidelines](/CONTRIBUTING.md).
+[pull request](https://github.com/schlagmichdoch/pairdrop/pulls), following the
+[Contributing Guidelines](CONTRIBUTING.md).

dev/nginx-with-openssl.Dockerfile

@@ -0,0 +1,3 @@
+FROM nginx:alpine
+
+RUN apk add --no-cache openssl

dev/nginx/default.conf

@@ -0,0 +1,42 @@
+server {
+    listen       80;
+
+    expires epoch;
+
+    location / {
+        proxy_connect_timeout 300;
+        proxy_pass http://pairdrop:3000;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Upgrade $http_upgrade;
+    }
+
+    location /ca.crt {
+        alias /etc/ssl/certs/pairdropCA.crt;
+    }
+
+    # To allow POST on static pages
+    error_page  405     =200 $uri;
+}
+
+server {
+    listen 443 ssl;
+    http2 on;
+    ssl_certificate /etc/ssl/certs/pairdrop-dev.crt;
+    ssl_certificate_key /etc/ssl/certs/pairdrop-dev.key;
+
+    expires epoch;
+
+    location / {
+        proxy_connect_timeout 300;
+        proxy_pass http://pairdrop:3000;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Upgrade $http_upgrade;
+    }
+
+    location /ca.crt {
+        alias /etc/ssl/certs/pairdropCA.crt;
+    }
+    # To allow POST on static pages
+    error_page  405 =200 $uri;
+}
+

dev/openssl/create.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+cnf_dir='/mnt/openssl/'
+certs_dir='/etc/ssl/certs/'
+openssl req -config ${cnf_dir}pairdropCA.cnf -new -x509 -days 1 -keyout ${certs_dir}pairdropCA.key -out ${certs_dir}pairdropCA.crt
+openssl req -config ${cnf_dir}pairdropCert.cnf -new -out /tmp/pairdrop-dev.csr -keyout ${certs_dir}pairdrop-dev.key
+openssl x509 -req -in /tmp/pairdrop-dev.csr -CA ${certs_dir}pairdropCA.crt -CAkey ${certs_dir}pairdropCA.key -CAcreateserial -extensions req_ext -extfile ${cnf_dir}pairdropCert.cnf -sha512 -days 1 -out ${certs_dir}pairdrop-dev.crt
+
+exec "$@"

dev/openssl/pairdropCA.cnf

@@ -0,0 +1,26 @@
+[ req ]
+default_bits       = 2048
+default_md         = sha256
+default_days       = 1
+encrypt_key        = no
+distinguished_name = subject
+x509_extensions    = x509_ext
+string_mask        = utf8only
+prompt             = no
+
+[ subject ]
+organizationName = PairDrop
+OU               = CA
+commonName       = pairdrop-CA
+
+[ x509_ext ]
+subjectKeyIdentifier      = hash
+authorityKeyIdentifier    = keyid:always,issuer
+
+# You only need digitalSignature below. *If* you don't allow
+#   RSA Key transport (i.e., you use ephemeral cipher suites), then
+#   omit keyEncipherment because that's key transport.
+
+basicConstraints = critical, CA:TRUE, pathlen:0
+keyUsage         = critical, digitalSignature, keyEncipherment, cRLSign, keyCertSign
+

dev/openssl/pairdropCert.cnf

@@ -0,0 +1,29 @@
+[ req ]
+default_bits        = 2048
+default_md          = sha256
+default_days        = 1
+encrypt_key         = no
+distinguished_name  = subject
+req_extensions      = req_ext
+string_mask         = utf8only
+prompt              = no
+
+[ subject ]
+organizationName    = PairDrop
+OU                  = Development
+
+# Use a friendly name here because it's presented to the user. The server's DNS
+#   names are placed in Subject Alternate Names. Plus, DNS names here is deprecated
+#   by both IETF and CA/Browser Forums. If you place a DNS name here, then you
+#   must include the DNS name in the SAN too (otherwise, Chrome and others that
+#   strictly follow the CA/Browser Baseline Requirements will fail).
+
+commonName           = ${ENV::FQDN}
+
+[ req_ext ]
+subjectKeyIdentifier = hash
+basicConstraints     = CA:FALSE
+keyUsage             = digitalSignature, keyEncipherment
+subjectAltName       = DNS:${ENV::FQDN}
+nsComment            = "OpenSSL Generated Certificate"
+extendedKeyUsage     = serverAuth

docker-compose-coturn.yml

@@ -1,19 +1,31 @@
 version: "3"
 services:
-  node:
-    image: "node:lts-alpine"
-    user: "node"
-    working_dir: /home/node/app
-    volumes:
-      - ./:/home/node/app
-    command: ash -c "npm i && npm run start:prod"
+  pairdrop:
+    image: "lscr.io/linuxserver/pairdrop:latest"
+    container_name: pairdrop
     restart: unless-stopped
+    volumes:
+      - ./rtc_config.json:/home/node/app/rtc_config.json
+    environment:
+      - PUID=1000 # UID to run the application as
+      - PGID=1000 # GID to run the application as
+      - WS_FALLBACK=false # Set to true to enable websocket fallback if the peer to peer WebRTC connection is not available to the client.
+      - RATE_LIMIT=false # Set to true to limit clients to 1000 requests per 5 min.
+      - RTC_CONFIG=/home/node/app/rtc_config.json # Set to the path of a file that specifies the STUN/TURN servers.
+      - DEBUG_MODE=false # Set to true to debug container and peer connections.
+      - TZ=Etc/UTC # Time Zone
     ports:
-      - "3000:3000"
+      - "127.0.0.1:3000:3000" # Web UI. Change the port number before the last colon e.g. `127.0.0.1:9000:3000`
   coturn_server:
     image: "coturn/coturn"
-    restart: always
-    network_mode: "host"
+    restart: unless-stopped
     volumes:
       - ./turnserver.conf:/etc/coturn/turnserver.conf
-    #you need to copy turnserver_example.conf to turnserver.conf and specify domain, IP address, user and password
+      - ./ssl/:/etc/coturn/ssl/
+    ports:
+      - "3478:3478"
+      - "3478:3478/udp"
+      - "5349:5349"
+      - "5349:5349/udp"
+      - "10000-20000:10000-20000/udp"
+    # see guide at docs/host-your-own.md#coturn-and-pairdrop-via-docker-compose

docker-compose-dev.yml

@@ -0,0 +1,34 @@
+version: "3"
+services:
+  pairdrop:
+    build: .
+    container_name: pairdrop
+    restart: unless-stopped
+    environment:
+      - PUID=1000 # UID to run the application as
+      - PGID=1000 # GID to run the application as
+      - WS_FALLBACK=false # Set to true to enable websocket fallback if the peer to peer WebRTC connection is not available to the client.
+      - RATE_LIMIT=false # Set to true to limit clients to 1000 requests per 5 min.
+      - RTC_CONFIG=false # Set to the path of a file that specifies the STUN/TURN servers.
+      - DEBUG_MODE=false # Set to true to debug container and peer connections.
+      - TZ=Etc/UTC # Time Zone
+    ports:
+      - "127.0.0.1:3000:3000" # Web UI. Change the port number before the last colon e.g. `127.0.0.1:9000:3000`
+  nginx:
+    build:
+      context: dev/
+      dockerfile: nginx-with-openssl.Dockerfile
+    image: "nginx-with-openssl"
+    volumes:
+      - ./public:/usr/share/nginx/html
+      - ./dev/certs:/etc/ssl/certs
+      - ./dev/openssl:/mnt/openssl
+      - ./dev/nginx/default.conf:/etc/nginx/conf.d/default.conf
+    ports:
+      - "8080:80"
+      - "8443:443"
+    environment:
+      - FQDN=localhost
+    entrypoint: /mnt/openssl/create.sh
+    command: ["nginx", "-g", "daemon off;"]
+    restart: unless-stopped

docker-compose.yml

@@ -1,12 +1,16 @@
 version: "3"
 services:
-  node:
-    image: "node:lts-alpine"
-    user: "node"
-    working_dir: /home/node/app
-    volumes:
-      - ./:/home/node/app
-    command: ash -c "npm i && npm run start:prod"
+  pairdrop:
+    image: "lscr.io/linuxserver/pairdrop:latest"
+    container_name: pairdrop
     restart: unless-stopped
+    environment:
+      - PUID=1000 # UID to run the application as
+      - PGID=1000 # GID to run the application as
+      - WS_FALLBACK=false # Set to true to enable websocket fallback if the peer to peer WebRTC connection is not available to the client.
+      - RATE_LIMIT=false # Set to true to limit clients to 1000 requests per 5 min.
+      - RTC_CONFIG=false # Set to the path of a file that specifies the STUN/TURN servers.
+      - DEBUG_MODE=false # Set to true to debug container and peer connections.
+      - TZ=Etc/UTC # Time Zone
     ports:
-      - "3000:3000"
+      - "127.0.0.1:3000:3000" # Web UI. Change the port number before the last colon e.g. `127.0.0.1:9000:3000`

docs/faq.md

@@ -5,18 +5,39 @@
     Help! I can't install the PWA!
 </summary>
 
-if you are using a Chromium-based browser (Chrome, Edge, Vivaldi, Brave, etc.), you can easily install PairDrop PWA on your desktop 
-by clicking the install-button in the top-right corner while on [pairdrop.net](https://pairdrop.net).
+<br>
+
+Here is a good guide on how to install PWAs on different platforms: \
+https://www.cdc.gov/niosh/mining/content/hearingloss/installPWA.html
+
+
+**Chromium-based browser on Desktop (Chrome, Edge, Vivaldi, Brave, etc.)** \
+Easily install PairDrop PWA on your desktop by clicking the install-button in the top-right corner while on [pairdrop.net](https://pairdrop.net).
 
 <img width="400" src="pwa-install.png" alt="Example on how to install a pwa with Edge">
 
+**Desktop Firefox** \
 On Firefox, PWAs are installable via [this browser extensions](https://addons.mozilla.org/de/firefox/addon/pwas-for-firefox/)
+
+**Android** \
+PWAs are installable only by using Google Chrome or Samsung Browser:
+1. Visit [pairdrop.net](https://pairdrop.net)
+2. Click _Install_ on the installation pop-up or use the three-dot-menu and click on _Add to Home screen_
+3. Click _Add_ on the pop-up
+
+**iOS** \
+PWAs are installable only by using Safari:
+1. Visit [pairdrop.net](https://pairdrop.net)
+2. Click on the share icon
+3. Click _Add to Home Screen_
+4. Click _Add_ in the top right corner
+
 <br>
 
-<b>Self-Hosted Instance?</b>
-
+**Self-Hosted Instance?** \
 To be able to install the PWA from a self-hosted instance, the connection needs to be [established through HTTPS](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Installable_PWAs).
 See [this host your own section](https://github.com/schlagmichdoch/PairDrop/blob/master/docs/host-your-own.md#testing-pwa-related-features) for more info.
+
 <br>
 
 </details>
@@ -26,7 +47,9 @@ See [this host your own section](https://github.com/schlagmichdoch/PairDrop/blob
     Shortcuts?
 </summary>
 
-Shortcuts
+<br>
+
+Available shortcuts:
 - Send a message with `CTRL + ENTER`
 - Close all "Send" and "Pair" dialogs by pressing `Esc`.
 - Copy a received message to the clipboard with `CTRL/⌘ + C`.
@@ -40,12 +63,20 @@ Shortcuts
     How to save images directly to the gallery on iOS?
 </summary>
 
-Apparently, iOS does not allow images shared from a website to be saved to the gallery directly.
-It simply does not offer that option for images shared from a website.
+<br>
 
-iOS Shortcuts saves the day:
+~~Apparently, iOS does not allow images shared from a website to be saved to the gallery directly.~~
+~~It simply does not offer that option for images shared from a website.~~
+
+~~iOS Shortcuts saves the day:~~ \
 I created a simple iOS shortcut that takes your photos and saves them to your gallery:
 https://routinehub.co/shortcut/13988/
+
+Update: \
+Apparently, this was only a bug that is fixed in recent iOS version (https://github.com/WebKit/WebKit/pull/13111). \
+If you use an older affected iOS version this might still be of use. \
+Luckily, you can now simply use `Save Image`/`Save X Images` 🎉
+
 <br>
 
 </details>
@@ -55,10 +86,13 @@ https://routinehub.co/shortcut/13988/
     Is it possible to send files or text directly from the "Context" or "Share" menu?
 </summary>
 
+<br>
+
 Yes, it finally is.
 * [Send files directly from the "Context" menu on Windows](/docs/how-to.md#send-files-directly-from-context-menu-on-windows)
 * [Send directly from the "Share" menu on iOS](/docs/how-to.md#send-directly-from-share-menu-on-ios)
 * [Send directly from the "Share" menu on Android](/docs/how-to.md#send-directly-from-share-menu-on-android)
+
 <br>
 
 </details>
@@ -68,9 +102,12 @@ Yes, it finally is.
     Is it possible to send files or text directly via CLI?
 </summary>
 
+<br>
+
 Yes.
 
 * [Send directly from a command-line interface](/docs/how-to.md#send-directly-via-command-line-interface)
+
 <br>
 
 </details>
@@ -80,11 +117,14 @@ Yes.
     Are there any third-party Apps?
 </summary>
 
+<br>
+
 These third-party apps are compatible with PairDrop:
 
 1. [Snapdrop Android App](https://github.com/fm-sys/snapdrop-android)
 2. [Snapdrop for Firefox (Addon)](https://github.com/ueen/SnapdropFirefoxAddon)
 3. Feel free to make one :)
+
 <br>
 
 </details>
@@ -94,6 +134,8 @@ These third-party apps are compatible with PairDrop:
     What about the connection? Is it a P2P connection directly from device to device or is there any third-party-server?
 </summary>
 
+<br>
+
 It uses a WebRTC peer-to-peer connection.
 WebRTC needs a signaling server that is only used to establish a connection.
 The server is not involved in the file transfer.
@@ -109,6 +151,7 @@ to learn more about STUN, TURN and WebRTC.
 If you host your own instance
 and want to support devices that do not support WebRTC,
 you can [start the PairDrop instance with an activated WebSocket fallback](https://github.com/schlagmichdoch/PairDrop/blob/master/docs/host-your-own.md#websocket-fallback-for-vpn).
+
 <br>
 
 </details>
@@ -118,9 +161,11 @@ you can [start the PairDrop instance with an activated WebSocket fallback](https
     What about privacy? Will files be saved on third-party servers?
 </summary>
 
+<br>
+
 Files are sent directly between peers.
 PairDrop doesn't even use a database.
-If curious, study [the server](https://github.com/schlagmichdoch/pairdrop/blob/master/index.js).
+If curious, study [the signaling server](https://github.com/schlagmichdoch/PairDrop/blob/master/server/ws-server.js).
 WebRTC encrypts the files in transit.
 
 If the devices are on the same network,
@@ -130,6 +175,7 @@ If your devices are paired and behind a NAT,
 the PairDrop TURN Server is used to route your files and messages.
 See the [Technical Documentation](technical-documentation.md#encryption-webrtc-stun-and-turn)
 to learn more about STUN, TURN and WebRTC.
+
 <br>
 
 </details>
@@ -139,10 +185,12 @@ to learn more about STUN, TURN and WebRTC.
     What about security? Are my files encrypted while sent between the computers?
 </summary>
 
+<br>
+
 Yes. Your files are sent using WebRTC, encrypting them in transit.
-To ensure the connection is secure and there is no [MITM](https://wikiless.org/wiki/Man-in-the-middle_attack),
-compare the security number shown under the device name on both devices.
-The security number is different for every connection.
+Still you have to trust the PairDrop server. To ensure the connection is secure and there is no [MITM](https://en.m.wikipedia.org/wiki/Man-in-the-middle_attack) there is a plan to make PairDrop
+zero trust by encrypting the signaling and implementing a verification process. See [issue #180](https://github.com/schlagmichdoch/PairDrop/issues/180) to keep updated.
+
 <br>
 
 </details>
@@ -152,6 +200,8 @@ The security number is different for every connection.
     Transferring many files with paired devices takes too long
 </summary>
 
+<br>
+
 Naturally, if traffic needs to be routed through the TURN server
 because your devices are behind different NATs, transfer speed decreases.
 
@@ -164,6 +214,7 @@ which omits the need of the TURN server.
 
 You can also use mobile hotspots on phones to do that. 
 Then, all data should be sent directly between devices and not use your data plan.
+
 <br>
 
 </details>
@@ -173,6 +224,8 @@ Then, all data should be sent directly between devices and not use your data pla
     Why don't you implement feature xyz?
 </summary>
 
+<br>
+
 Snapdrop and PairDrop are a study in radical simplicity.
 The user interface is insanely simple.
 Features are chosen very carefully because complexity grows quadratically
@@ -184,22 +237,24 @@ Don't be sad. We may decline your feature request for the sake of simplicity.
 Read *Insanely Simple: The Obsession that Drives Apple's Success*,
 and/or *Thinking, Fast and Slow* to learn more.
 
-
 <br>
 
 </details>
 
 <details>
 <summary style="font-size:1.25em;margin-top: 24px; margin-bottom: 16px; font-weight: var(--base-text-weight-semibold, 600); line-height: 1.25;">
-    Snapdrop and PairDrop are awesome. How can I support them? 
+    PairDrop is awesome. How can I support it? 
 </summary>
 
+<br>
+
 * [Buy me a coffee](https://www.buymeacoffee.com/pairdrop) to pay for the domain and the server, and support libre software.
 * [File bugs, give feedback, submit suggestions](https://github.com/schlagmichdoch/pairdrop/issues)
 * Share PairDrop on social media.
-* Fix bugs and make a pull request. 
+* Fix bugs and create a pull request.
 * Do some security analysis and make suggestions.
-* To support the original Snapdrop and its creator go to [his GitHub page](https://github.com/RobinLinus/snapdrop)
+* Participate in [active discussions](https://github.com/schlagmichdoch/PairDrop/discussions)
+
 <br>
 
 </details>
@@ -209,7 +264,10 @@ and/or *Thinking, Fast and Slow* to learn more.
     How does it work?
 </summary>
 
+<br>
+
 [See here for info about the technical implementation](/docs/technical-documentation.md)
+
 <br>
 
 </details>

docs/host-your-own.md

@@ -1,181 +1,132 @@
 # Deployment Notes
-The easiest way to get PairDrop up and running is by using Docker.
 
-> <b>TURN server for Internet Transfer</b>
-> 
-> Beware that you have to host your own TURN server to enable transfers between different networks.
->
-> Follow [this guide](https://gabrieltanner.org/blog/turn-server/) to either install coturn directly on your system (Step 1) \
-> or deploy it via docker-compose (Step 5).
+## TURN server for Internet Transfer
 
-> <b>PairDrop via HTTPS</b>
-> 
-> On some browsers PairDrop must be served over TLS in order for some feautures to work properly. These may include copying an incoming message via the 'copy' button, installing PairDrop as PWA, persistent pairing of devices and changing of the display name, and notifications. Naturally, this is also recommended to increase security.
+Beware that you have to host your own TURN server to enable transfers between different networks.
+
+Follow [this guide](https://gabrieltanner.org/blog/turn-server/) to either install coturn directly on your system (Step 1) 
+or deploy it via Docker (Step 5).
+
+You can use the `docker-compose-coturn.yml` in this repository. See [Coturn and PairDrop via Docker Compose](#coturn-and-pairdrop-via-docker-compose).
+ 
+Alternatively, use a free, pre-configured TURN server like [OpenRelay](https://www.metered.ca/tools/openrelay/)
+
+<br>
+
+## PairDrop via HTTPS
+
+On some browsers PairDrop must be served over TLS in order for some features to work properly.
+These may include:
+- Copying an incoming message via the 'copy' button
+- Installing PairDrop as PWA
+- Persistent pairing of devices
+- Changing of the display name
+- Notifications
+
+Naturally, this is also recommended to increase security.
+
+<br>
 
 ## Deployment with Docker
 
+The easiest way to get PairDrop up and running is by using Docker.
+
 ### Docker Image from Docker Hub
 
 ```bash
 docker run -d --restart=unless-stopped --name=pairdrop -p 127.0.0.1:3000:3000 lscr.io/linuxserver/pairdrop
 ```
-
-> You must use a server proxy to set the X-Forwarded-For \
-> to prevent all clients from discovering each other (See [#HTTP-Server](#http-server)).
->
-> To prevent bypassing the proxy by reaching the docker container directly, \
-> `127.0.0.1` is specified in the run command.
-
-#### Options / Flags
-Set options by using the following flags in the `docker run` command:
-
-##### Port
-```bash
--p 127.0.0.1:8080:3000
-```
-> Specify the port used by the docker image 
-> - 3000 -> `-p 127.0.0.1:3000:3000`
-> - 8080 -> `-p 127.0.0.1:8080:3000`
-##### Rate limiting requests
-```bash
--e RATE_LIMIT=true
-```
-> Limits clients to 1000 requests per 5 min
-
-##### IPv6 Localization
-```bash
--e IPV6_LOCALIZE=4
-```
-> To enable Peer Discovery among IPv6 peers, you can specify a reduced number of segments \
-> of the client IPv6 address to be evaluated as the peer's IP. \
-> This can be especially useful when using Cloudflare as a proxy.
-> 
-> The flag must be set to an **integer** between `1` and `7`. \
-> The number represents the number of IPv6 [hextets](https://en.wikipedia.org/wiki/IPv6#Address_representation) \
-> to match the client IP against. The most common value would be `4`, \
-> which will group peers within the same `/64` subnet.
-
-##### Websocket Fallback (for VPN)
-```bash
--e WS_FALLBACK=true
-```
-> Provides PairDrop to clients with an included websocket fallback \
-> if the peer to peer WebRTC connection is not available to the client.
->
-> This is not used on the official https://pairdrop.net website, \
-> but you can activate it on your self-hosted instance.
-> This is especially useful if you connect to your instance via a VPN (as most VPN services block WebRTC completely in order to hide your real IP address). ([Read more here](https://privacysavvy.com/security/safe-browsing/disable-webrtc-chrome-firefox-safari-opera-edge/)).
->
-> **Warning:** All traffic sent between devices using this fallback \
-> is routed through the server and therefor not peer to peer! \
-> Beware that the traffic routed via this fallback is readable by the server. \
-> Only ever use this on instances you can trust. \
-> Additionally, beware that all traffic using this fallback debits the servers data plan.
-
-##### Specify STUN/TURN Servers
-```bash
--e RTC_CONFIG="rtc_config.json"
-```
-
-> Specify the STUN/TURN servers PairDrop clients use by setting \
-> `RTC_CONFIG` to a JSON file including the configuration. \
-> You can use `pairdrop/rtc_config_example.json` as a starting point.
->
-> To host your own TURN server you can follow this guide: https://gabrieltanner.org/blog/turn-server/
-> Alternatively, use a free, pre-configured TURN server like [OpenRelay]([url](https://www.metered.ca/tools/openrelay/))
->
-> Default configuration:
-> ```json
-> {
->   "sdpSemantics": "unified-plan",
->   "iceServers": [
->     {
->       "urls": "stun:stun.l.google.com:19302"
->     }
->   ]
-> }
-> ```
-
-##### Debug Mode
-```bash
--e DEBUG_MODE="true"
-```
-
-> Use this flag to enable debugging information about the connecting peers IP addresses. \
-> This is quite useful to check whether the [#HTTP-Server](#http-server) \
-> is configured correctly, so the auto-discovery feature works correctly. \
-> Otherwise, all clients discover each other mutually, independently of their network status.
-> 
-> If this flag is set to `"true"` each peer that connects to the PairDrop server will produce a log to STDOUT like this:
-> ```
-> ----DEBUGGING-PEER-IP-START----
-> remoteAddress: ::ffff:172.17.0.1
-> x-forwarded-for: 19.117.63.126
-> cf-connecting-ip: undefined
-> PairDrop uses: 19.117.63.126
-> IP is private: false
-> if IP is private, '127.0.0.1' is used instead
-> ----DEBUGGING-PEER-IP-END----
-> ```
-> If the IP PairDrop uses is the public IP of your device, everything is set up correctly. \ 
->To find out your devices public IP visit https://www.whatismyip.com/.
-> 
-> To preserve your clients' privacy, **never use this flag in production!** 
+> This image is hosted by [linuxserver.io](https://linuxserver.io). For more information visit https://hub.docker.com/r/linuxserver/pairdrop
 
 
 <br>
 
-### Docker Image from GHCR
-```bash
-docker run -d --restart=unless-stopped --name=pairdrop -p 127.0.0.1:3000:3000 ghcr.io/schlagmichdoch/pairdrop npm run start:prod 
-```
-> You must use a server proxy to set the X-Forwarded-For to prevent \
-> all clients from discovering each other (See [#HTTP-Server](#http-server)).
->
-> To prevent bypassing the proxy by reaching the Docker container directly, \
-> `127.0.0.1` is specified in the run command.
->
-> To specify options replace `npm run start:prod` \
-> according to [the documentation below.](#options--flags-1)
+### Docker Image from GitHub Container Registry (ghcr.io)
 
-> The Docker Image includes a healthcheck. \
-> Read more about [Docker Swarm Usage](docker-swarm-usage.md#docker-swarm-usage).
+```bash
+docker run -d --restart=unless-stopped --name=pairdrop -p 127.0.0.1:3000:3000 ghcr.io/schlagmichdoch/pairdrop
+```
+
+
+<br>
 
 ### Docker Image self-built
+
 #### Build the image
+
 ```bash
 docker build --pull . -f Dockerfile -t pairdrop
 ```
-> A GitHub action is set up to do this step automatically.
+
+> A GitHub action is set up to do this step automatically at the release of new versions.
 >
 > `--pull` ensures always the latest node image is used.
 
 #### Run the image
+
 ```bash
-docker run -d --restart=unless-stopped --name=pairdrop -p 127.0.0.1:3000:3000 -it pairdrop npm run start:prod
+docker run -d --restart=unless-stopped --name=pairdrop -p 127.0.0.1:3000:3000 -it pairdrop
 ```
-> You must use a server proxy to set the X-Forwarded-For \
+
+> You must use a server proxy to set the `X-Forwarded-For` header 
 > to prevent all clients from discovering each other (See [#HTTP-Server](#http-server)).
 >
-> To prevent bypassing the proxy by reaching the Docker container \
-> directly, `127.0.0.1` is specified in the run command.
->
-> To specify options replace `npm run start:prod` \
-> according to [the documentation below.](#options--flags-1)
+> To prevent bypassing the proxy by reaching the docker container directly, 
+> `127.0.0.1` is specified in the run command.
 
-> The Docker Image includes a Healthcheck. \
-Read more about [Docker Swarm Usage](docker-swarm-usage.md#docker-swarm-usage).
+
+<br>
+
+### Flags
+
+Set options by using the following flags in the `docker run` command:
+
+#### Port
+
+```bash
+-p 127.0.0.1:8080:3000
+```
+
+> Specify the port used by the docker image
+>
+> - 3000 -> `-p 127.0.0.1:3000:3000`
+> - 8080 -> `-p 127.0.0.1:8080:3000`
+
+#### Set Environment Variables via Docker
+
+Environment Variables are set directly in the `docker run` command: \
+e.g. `docker run -p 127.0.0.1:3000:3000 -it pairdrop -e DEBUG_MODE="true"`
+
+Overview of available Environment Variables are found [here](#environment-variables).
+
+Example:
+```bash
+docker run -d \
+    --name=pairdrop \
+    --restart=unless-stopped \
+    -p 127.0.0.1:3000:3000 \
+    -e PUID=1000 \
+    -e PGID=1000 \
+    -e WS_SERVER=false \
+    -e WS_FALLBACK=false \
+    -e RTC_CONFIG=false \
+    -e RATE_LIMIT=false \
+    -e DEBUG_MODE=false \
+    -e TZ=Etc/UTC \
+    lscr.io/linuxserver/pairdrop 
+```
 
 <br>
 
 ## Deployment with Docker Compose
-Here's an example docker-compose file:
+
+Here's an example docker compose file:
 
 ```yaml
-version: "2"
+version: "3"
 services:
     pairdrop:
-        image: lscr.io/linuxserver/pairdrop:latest
+        image: "lscr.io/linuxserver/pairdrop:latest"
         container_name: pairdrop
         restart: unless-stopped
         environment:
@@ -183,22 +134,26 @@ services:
             - PGID=1000 # GID to run the application as
             - WS_FALLBACK=false # Set to true to enable websocket fallback if the peer to peer WebRTC connection is not available to the client.
             - RATE_LIMIT=false # Set to true to limit clients to 1000 requests per 5 min.
+            - RTC_CONFIG=false # Set to the path of a file that specifies the STUN/TURN servers.
+            - DEBUG_MODE=false # Set to true to debug container and peer connections.
             - TZ=Etc/UTC # Time Zone
         ports:
-            - 127.0.0.1:3000:3000 # Web UI
+            - "127.0.0.1:3000:3000" # Web UI
 ```
 
 Run the compose file with `docker compose up -d`.
 
-> You must use a server proxy to set the X-Forwarded-For \
+> You must use a server proxy to set the `X-Forwarded-For` header
 > to prevent all clients from discovering each other (See [#HTTP-Server](#http-server)).
 >
-> To prevent bypassing the proxy by reaching the Docker container \
-> directly, `127.0.0.1` is specified in the run command.
+> To prevent bypassing the proxy by reaching the Docker container 
+> directly, `127.0.0.1` is specified in the `ports` argument.
 
 <br>
 
-## Deployment with node
+## Deployment with Node.js
+
+Clone this repository and enter the folder
 
 ```bash
 git clone https://github.com/schlagmichdoch/PairDrop.git && cd PairDrop
@@ -212,56 +167,223 @@ npm install
 
 Start the server with:
 
-```bash
-node index.js
-```
-or
 ```bash
 npm start
 ```
 
-> Remember to check your IP address using your OS command to see where you can access the server.
-
 > By default, the node server listens on port 3000.
 
+
 <br>
 
-### Environment variables
-#### Port
-On Unix based systems
-```bash
-PORT=3010 npm start
-```
-On Windows
-```bash
-$env:PORT=3010; npm start 
-```
-> Specify the port PairDrop is running on. (Default: 3000)
+### Options / Flags
+
+These are some flags only reasonable when deploying via Node.js
+
+#### Port
+
+```bash
+PORT=3000
+```
+
+> Default: `3000`
+> 
+> Environment variable to specify the port used by the Node.js server \
+> e.g. `PORT=3010 npm start`
+
+#### Local Run
+
+```bash
+npm start -- --localhost-only
+```
+
+> Only allow connections from localhost.
+>
+> You must use a server proxy to set the `X-Forwarded-For` header 
+> to prevent all clients from discovering each other (See [#HTTP-Server](#http-server)).
+>
+> Use this when deploying PairDrop with node to prevent 
+> bypassing the reverse proxy by reaching the Node.js server directly.
+
+#### Automatic restart on error
+
+```bash
+npm start -- --auto-restart
+```
+
+> Restarts server automatically on error
+
+#### Production (autostart and rate-limit)
+
+```bash
+npm run start:prod
+```
+
+> shortcut for `RATE_LIMIT=5 npm start -- --auto-restart`
+
+#### Production (autostart, rate-limit, localhost-only)
+
+```bash
+npm run start:prod -- --localhost-only
+```
+
+> To prevent connections to the node server from bypassing \
+> the proxy server you should always use "--localhost-only" on production.
+
+#### Set Environment Variables via Node.js
+
+To specify environment variables set them in the run command in front of `npm start`.
+The syntax is different on Unix and Windows.
+
+On Unix based systems
+
+```bash
+PORT=3000 RTC_CONFIG="rtc_config.json" npm start
+```
+
+On Windows
+
+```bash
+$env:PORT=3000 RTC_CONFIG="rtc_config.json"; npm start
+```
+
+Overview of available Environment Variables are found [here](#environment-variables).
+
+<br>
+
+## Environment Variables
+
+### Debug Mode
+
+```bash
+DEBUG_MODE="true"
+```
+
+> Default: `false`
+>
+> Logs the used environment variables for debugging.
+>
+> Prints debugging information about the connecting peers IP addresses.
+> 
+> This is quite useful to check whether the [#HTTP-Server](#http-server)
+> is configured correctly, so the auto-discovery feature works correctly.
+> Otherwise, all clients discover each other mutually, independently of their network status.
+>
+> If this flag is set to `"true"` each peer that connects to the PairDrop server will produce a log to STDOUT like this:
+>
+> ```
+> ----DEBUGGING-PEER-IP-START----
+> remoteAddress: ::ffff:172.17.0.1
+> x-forwarded-for: 19.117.63.126
+> cf-connecting-ip: undefined
+> PairDrop uses: 19.117.63.126
+> IP is private: false
+> if IP is private, '127.0.0.1' is used instead
+> ----DEBUGGING-PEER-IP-END----
+> ```
+>
+> If the IP address "PairDrop uses" matches the public IP address of the client device, everything is set up correctly. \
+> To find out the public IP address of the client device visit https://whatsmyip.com/.
+>
+> To preserve your clients' privacy: \
+> **Never use this environment variable in production!**
+
+
+<br>
+
+### Rate limiting requests
+
+```bash
+RATE_LIMIT=1
+```
+
+> Default: `false`
+>
+> Limits clients to 1000 requests per 5 min
+>
+> "If you are behind a proxy/load balancer (usually the case with most hosting services, e.g. Heroku, Bluemix, AWS ELB,
+> Render, Nginx, Cloudflare, Akamai, Fastly, Firebase Hosting, Rackspace LB, Riverbed Stingray, etc.), the IP address of
+> the request might be the IP of the load balancer/reverse proxy (making the rate limiter effectively a global one and
+> blocking all requests once the limit is reached) or undefined."
+> (See: https://express-rate-limit.mintlify.app/guides/troubleshooting-proxy-issues)
+>
+> To find the correct number to use for this setting:
+>
+> 1. Start PairDrop with `DEBUG_MODE=True` and `RATE_LIMIT=1`
+> 2. Make a `get` request to `/ip` of the PairDrop instance (e.g. `https://pairdrop-example.net/ip`)
+> 3. Check if the IP address returned in the response matches your public IP address (find out by visiting e.g. https://whatsmyip.com/)
+> 4. You have found the correct number if the IP addresses match. If not, then increase `RATE_LIMIT` by one and redo 1. - 4.
+>
+> e.g. on Render you must use RATE_LIMIT=5
+
+
+<br>
+
+### IPv6 Localization
 
-#### IPv6 Localization
 ```bash
 IPV6_LOCALIZE=4
 ```
-> Truncate a portion of the client IPv6 address to make peers more discoverable. \
-> See [Options/Flags](#options--flags) above.
 
-#### Specify STUN/TURN Server
-On Unix based systems
+> Default: `false`
+>
+> To enable Peer Auto-Discovery among IPv6 peers, you can specify a reduced number of segments \
+> of the client IPv6 address to be evaluated as the peer's IP. \
+> This can be especially useful when using Cloudflare as a proxy.
+>
+> The flag must be set to an **integer** between `1` and `7`. \
+> The number represents the number of IPv6 [hextets](https://en.wikipedia.org/wiki/IPv6#Address_representation) \
+> to match the client IP against. The most common value would be `4`, \
+> which will group peers within the same `/64` subnet.
+
+
+<br>
+
+### Websocket Fallback (for VPN)
+
 ```bash
-RTC_CONFIG="rtc_config.json" npm start
+WS_FALLBACK=true
 ```
-On Windows
-```bash
-$env:RTC_CONFIG="rtc_config.json"; npm start 
-```
-> Specify the STUN/TURN servers PairDrop clients use by setting `RTC_CONFIG` \
-> to a JSON file including the configuration. \
-> You can use `pairdrop/rtc_config_example.json` as a starting point.
+
+> Default: `false`
+>
+> Provides PairDrop to clients with an included websocket fallback \
+> if the peer to peer WebRTC connection is not available to the client.
+>
+> This is not used on the official https://pairdrop.net website, 
+> but you can activate it on your self-hosted instance.\
+> This is especially useful if you connect to your instance via a VPN (as most VPN services block WebRTC completely in 
+> order to hide your real IP address). ([Read more here](https://privacysavvy.com/security/safe-browsing/disable-webrtc-chrome-firefox-safari-opera-edge/)).
+>
+> **Warning:** \
+> All traffic sent between devices using this fallback
+> is routed through the server and therefor not peer to peer!
 > 
-> To host your own TURN server you can follow this guide: \
-> https://gabrieltanner.org/blog/turn-server/ 
+> Beware that the traffic routed via this fallback is readable by the server. \
+> Only ever use this on instances you can trust.
+> 
+> Additionally, beware that all traffic using this fallback debits the servers data plan.
+
+
+<br>
+
+### Specify STUN/TURN Servers
+
+```bash
+RTC_CONFIG="rtc_config.json"
+```
+
+> Default: `false`
+>
+> Specify the STUN/TURN servers PairDrop clients use by setting \
+> `RTC_CONFIG` to a JSON file including the configuration. \
+> You can use `rtc_config_example.json` as a starting point.
+>
+> To host your own TURN server you can follow this guide: https://gabrieltanner.org/blog/turn-server/
+> Alternatively, use a free, pre-configured TURN server like [OpenRelay](<[url](https://www.metered.ca/tools/openrelay/)>)
 >
 > Default configuration:
+>
 > ```json
 > {
 >   "sdpSemantics": "unified-plan",
@@ -273,109 +395,90 @@ $env:RTC_CONFIG="rtc_config.json"; npm start
 > }
 > ```
 
-#### Debug Mode
-On Unix based systems
+<br>
+
+You can host an instance that uses another signaling server
+This can be useful if you don't want to trust the client files that are hosted on another instance but still want to connect to devices that use https://pairdrop.net.
+
+### Specify Signaling Server
+
 ```bash
-DEBUG_MODE="true" npm start
-```
-On Windows
-```bash
-$env:DEBUG_MODE="true"; npm start 
+SIGNALING_SERVER="pairdrop.net"
 ```
 
-> Use this flag to enable debugging info about the connecting peers IP addresses. \
-> This is quite useful to check whether the [#HTTP-Server](#http-server) \
-> is configured correctly, so the auto discovery feature works correctly. \
-> Otherwise, all clients discover each other mutually, independently of their network status.
+> Default: `false`
 >
-> If this flag is set to `"true"` each peer that connects to the \
-> PairDrop server will produce a log to STDOUT like this:
-> ```
-> ----DEBUGGING-PEER-IP-START----
-> remoteAddress: ::ffff:172.17.0.1
-> x-forwarded-for: 19.117.63.126
-> cf-connecting-ip: undefined
-> PairDrop uses: 19.117.63.126
-> IP is private: false
-> if IP is private, '127.0.0.1' is used instead
-> ----DEBUGGING-PEER-IP-END----
-> ```
-> If the IP PairDrop uses is the public IP of your device everything is set up correctly. \
->Find your devices public IP by visiting https://www.whatismyip.com/.
->
-> Preserve your clients' privacy. **Never use this flag in production!**
-
-
-### Options / Flags
-#### Local Run
-```bash
-npm start -- --localhost-only
-```
-> Only allow connections from localhost.
+> By default, clients connecting to your instance use the signaling server of your instance to connect to other devices.
 > 
-> You must use a server proxy to set the X-Forwarded-For \
-> to prevent all clients from discovering each other (See [#HTTP-Server](#http-server)).
->
-> Use this when deploying PairDrop with node to prevent \
-> bypassing the proxy by reaching the Docker container directly.
-
-#### Automatic restart on error
-```bash
-npm start -- --auto-restart 
-```
-> Restarts server automatically on error
-
-<br>
-
-#### Rate limiting requests
-```bash
-npm start -- --rate-limit 
-```
-> Limits clients to 1000 requests per 5 min
-
-<br>
-
-#### Websocket Fallback (for VPN)
-```bash
-npm start -- --include-ws-fallback
-```
-> Provides PairDrop to clients with an included websocket fallback \
-> if the peer to peer WebRTC connection is not available to the client.
->
-> This is not used on the official https://pairdrop.net, \
-but you can activate it on your self-hosted instance. \
-> This is especially useful if you connect to your instance \
-> via a VPN as most VPN services block WebRTC completely in order to hide your real IP address.
-> ([Read more](https://privacysavvy.com/security/safe-browsing/disable-webrtc-chrome-firefox-safari-opera-edge/)).
+> By using `SIGNALING_SERVER`, you can host an instance that uses another signaling server.
 > 
-> **Warning:** All traffic sent between devices using this fallback \
-> is routed through the server and therefor not peer to peer! \
-> Beware that the traffic routed via this fallback is readable by the server. \
-> Only ever use this on instances you can trust. \
-> Additionally, beware that all traffic using this fallback debits the servers data plan.
+> This can be useful if you want to ensure the integrity of the client files and don't want to trust the client files that are hosted on another PairDrop instance but still want to connect to devices that use the other instance.
+> E.g. host your own client files under *pairdrop.your-domain.com* but use the official signaling server under *pairdrop.net*
+> This way devices connecting to *pairdrop.your-domain.com* and *pairdrop.net* can discover each other.
+> 
+> Beware that the version of your PairDrop server must be compatible with the version of the signaling server.
+>
+> `SIGNALING_SERVER` must be a valid url without the protocol prefix. 
+> Examples of valid values: `pairdrop.net`, `pairdrop.your-domain.com:3000`, `your-domain.com/pairdrop`
 
 <br>
 
-#### Production (autostart and rate-limit)
+### Customizable buttons for the _About PairDrop_ page
+
 ```bash
-npm run start:prod
+DONATION_BUTTON_ACTIVE=true
+DONATION_BUTTON_LINK="https://www.buymeacoffee.com/pairdrop"
+DONATION_BUTTON_TITLE="Buy me a coffee"
+TWITTER_BUTTON_ACTIVE=true
+TWITTER_BUTTON_LINK="https://twitter.com/account"
+TWITTER_BUTTON_TITLE="Find me on Twitter"
+MASTODON_BUTTON_ACTIVE=true
+MASTODON_BUTTON_LINK="https://mastodon.social/account"
+MASTODON_BUTTON_TITLE="Find me on Mastodon"
+BLUESKY_BUTTON_ACTIVE=true
+BLUESKY_BUTTON_LINK="https://bsky.app/profile/account"
+BLUESKY_BUTTON_TITLE="Find me on Bluesky"
+CUSTOM_BUTTON_ACTIVE=true
+CUSTOM_BUTTON_LINK="https://your-custom-social-network.net/account"
+CUSTOM_BUTTON_TITLE="Find me on this custom social network"
+PRIVACYPOLICY_BUTTON_ACTIVE=true
+PRIVACYPOLICY_BUTTON_LINK="https://link-to-your-privacy-policy.net"
+PRIVACYPOLICY_BUTTON_TITLE="Open our privacy policy"
 ```
 
-#### Production (autostart, rate-limit, localhost-only and websocket fallback for VPN)
-```bash
-npm run start:prod -- --localhost-only --include-ws-fallback
-```
-> To prevent connections to the node server from bypassing \
-> the proxy server you should always use "--localhost-only" on production.
+> Default: unset
+>
+> By default, clients will show the default button configuration: GitHub, BuyMeACoffee, Twitter, and FAQ on GitHub.
+> 
+> The GitHub and FAQ on GitHub buttons are essential, so they are always shown.
+> 
+> The other buttons can be customized:
+>
+> * `*_BUTTON_ACTIVE`: set this to `true` to show a natively hidden button or to `false` to hide a normally shown button
+> * `*_BUTTON_LINK`: set this to any URL to overwrite the href attribute of the button
+> * `*_BUTTON_TITLE`: set this to overwrite the hover title of the button. This will prevent the title from being translated.
+
+<br>
+
+## Healthcheck
+
+> The Docker Image hosted on `ghcr.io` and the self-built Docker Image include a healthcheck.
+>
+> Read more about [Docker Swarm Usage](docker-swarm-usage.md#docker-swarm-usage).
+
+<br>
 
 ## HTTP-Server
+
 When running PairDrop, the `X-Forwarded-For` header has to be set by a proxy. \
 Otherwise, all clients will be mutually visible.
 
 To check if your setup is configured correctly [use the environment variable `DEBUG_MODE="true"`](#debug-mode).
 
 ### Using nginx
+
 #### Allow http and https requests
+
 ```
 server {
     listen       80;
@@ -409,6 +512,7 @@ server {
 ```
 
 #### Automatic http to https redirect:
+
 ```
 server {
     listen       80;
@@ -437,110 +541,169 @@ server {
 }
 ```
 
+
+<br>
+
 ### Using Apache
+
 install modules `proxy`, `proxy_http`, `mod_proxy_wstunnel`
+
 ```bash
 a2enmod proxy
 ```
+
 ```bash
 a2enmod proxy_http
 ```
-```bash
-a2enmod proxy_wstunnel
-```
 
 <br>
 
 Create a new configuration file under `/etc/apache2/sites-available` (on Debian)
 
 **pairdrop.conf**
+
 #### Allow HTTP and HTTPS requests
+
 ```apacheconf
-<VirtualHost *:80>	
-	ProxyPass / http://127.0.0.1:3000/
-	RewriteEngine on
-	RewriteCond %{HTTP:Upgrade} websocket [NC]
-	RewriteCond %{HTTP:Connection} upgrade [NC]
-	RewriteRule ^/?(.*) "ws://127.0.0.1:3000/$1" [P,L]
+<VirtualHost *:80>
+	ProxyPass / http://127.0.0.1:3000/ upgrade=websocket
 </VirtualHost>
-<VirtualHost *:443>	
-	ProxyPass / https://127.0.0.1:3000/
-	RewriteEngine on
-	RewriteCond %{HTTP:Upgrade} websocket [NC]
-	RewriteCond %{HTTP:Connection} upgrade [NC]
-	RewriteRule ^/?(.*) "wws://127.0.0.1:3000/$1" [P,L]
+<VirtualHost *:443>
+	ProxyPass / https://127.0.0.1:3000/ upgrade=websocket
 </VirtualHost>
 ```
+
 #### Automatic HTTP to HTTPS redirect:
+
 ```apacheconf
-<VirtualHost *:80>	
-   Redirect permanent / https://127.0.0.1:3000/
+<VirtualHost *:80>
+	Redirect permanent / https://127.0.0.1:3000/
 </VirtualHost>
-<VirtualHost *:443>	
-	ProxyPass / https://127.0.0.1:3000/
-	RewriteEngine on
-	RewriteCond %{HTTP:Upgrade} websocket [NC]
-	RewriteCond %{HTTP:Connection} upgrade [NC]
-	RewriteRule ^/?(.*) "wws://127.0.0.1:3000/$1" [P,L]
+<VirtualHost *:443>
+	ProxyPass / http://127.0.0.1:3000/ upgrade=websocket
 </VirtualHost>
 ```
+
 Activate the new virtual host and reload Apache:
+
 ```bash
 a2ensite pairdrop
 ```
+
 ```bash
 service apache2 reload
 ```
 
-# Local Development
-## Install
-All files needed for developing are available on the branch `dev`.
+<br>
 
-First, [Install docker with docker-compose.](https://docs.docker.com/compose/install/)
+## Coturn and PairDrop via Docker Compose
 
-Then, clone the repository and run docker-compose:
-```bash
-    git clone https://github.com/schlagmichdoch/PairDrop.git
-
-    cd PairDrop
-
-    git checkout dev
-    
-    docker-compose up -d
-```
-Now point your web browser to `http://localhost:8080`.
-
-- To restart the containers, run `docker-compose restart`.
-- To stop the containers, run `docker-compose stop`.
-- To debug the NodeJS server, run `docker logs pairdrop_node_1`.
+### Setup container
+To run coturn and PairDrop at once by using the `docker-compose-coturn.yml` with TURN over TLS enabled
+you need to follow these steps:
 
+1. Generate or retrieve certificates for your `<DOMAIN>` (e.g. letsencrypt / certbot)
+2. Create `./ssl` folder: `mkdir ssl`
+3. Copy your ssl-certificates and the privkey to `./ssl` 
+4. Restrict access to `./ssl`: `chown -R nobody:nogroup ./ssl`
+5. Create a dh-params file: `openssl dhparam -out ./ssl/dhparams.pem 4096` 
+6. Copy `rtc_config_example.json` to `rtc_config.json`
+7. Copy `turnserver_example.conf` to `turnserver.conf`
+8. Change `<DOMAIN>` in both files to the domain where your PairDrop instance is running 
+9. Change `username` and `password` in `turnserver.conf` and `rtc-config.json`
+10. To start the container including coturn run: \
+  `docker compose -f docker-compose-coturn.yml up -d`
 
 <br>
 
-## Testing PWA related features
+#### Setup container
+To restart the container including coturn run: \
+  `docker compose -f docker-compose-coturn.yml restart`
+
+<br>
+
+#### Setup container
+To stop the container including coturn run: \
+  `docker compose -f docker-compose-coturn.yml stop`
+
+<br>
+
+### Firewall
+To run PairDrop including its own coturn-server you need to punch holes in the firewall. These ports must be opened additionally:
+- 3478 tcp/udp
+- 5349 tcp/udp
+- 10000:20000 tcp/udp
+
+<br>
+
+## Local Development
+
+### Install
+
+All files needed for developing are available in the folder `./dev`.
+
+For convenience, there is also a docker compose file for developing:
+
+#### Developing with docker compose
+First, [Install docker with docker compose.](https://docs.docker.com/compose/install/)
+
+Then, clone the repository and run docker compose:
+
+```bash
+git clone https://github.com/schlagmichdoch/PairDrop.git && cd PairDrop
+```
+```bash
+docker compose -f docker-compose-dev.yml up --no-deps --build
+```
+
+Now point your web browser to `http://localhost:8080`.
+
+- To debug the Node.js server, run `docker logs pairdrop`.
+- After changes to the code you have to rerun the `docker compose` command
+
+<br>
+
+#### Testing PWA related features
+
 PWAs requires the app to be served under a correctly set up and trusted TLS endpoint.
 
-The NGINX container creates a CA certificate and a website certificate for you. \
-To correctly set the common name of the certificate, \
-you need to change the FQDN environment variable in `docker/fqdn.env` \
-to the fully qualified domain name of your workstation.
+The NGINX container creates a CA certificate and a website certificate for you. 
+To correctly set the common name of the certificate, 
+you need to change the FQDN environment variable in `docker-compose-dev.yml`
+to the fully qualified domain name of your workstation. (Default: localhost)
 
 If you want to test PWA features, you need to trust the CA of the certificate for your local deployment. \
 For your convenience, you can download the crt file from `http://<Your FQDN>:8080/ca.crt`. \
 Install that certificate to the trust store of your operating system. \
-- On Windows, make sure to install it to the `Trusted Root Certification Authorities` store. \
-- On macOS, double-click the installed CA certificate in `Keychain Access`, \
-- expand `Trust`, and select `Always Trust` for SSL. \
-- Firefox uses its own trust store. To install the CA, \
-- point Firefox at `http://<Your FQDN>:8080/ca.crt`. \
-- When prompted, select `Trust this CA to identify websites` and click *OK*. \
-- When using Chrome, you need to restart Chrome so it reloads the trust store (`chrome://restart`). \
-- Additionally, after installing a new cert, \
-- you need to clear the Storage (DevTools → Application → Clear storage → Clear site data).
+
+##### Windows
+- Make sure to install it to the `Trusted Root Certification Authorities` store.
+
+##### macOS
+- Double-click the installed CA certificate in `Keychain Access`,
+- expand `Trust`, and select `Always Trust` for SSL.
+
+##### Firefox
+Firefox uses its own trust store. To install the CA:
+- point Firefox at `http://<Your FQDN>:8080/ca.crt` (Default: `http://localhost:8080/ca.crt`)
+- When prompted, select `Trust this CA to identify websites` and click _OK_.
+
+Alternatively:
+1. Download `ca.crt` from `http://<Your FQDN>:8080/ca.crt` (Default: `http://localhost:8080/ca.crt`)
+2. Go to `about:preferences#privacy` scroll down to `Security` and `Certificates` and click `View Certificates`
+3. Import the downloaded certificate file (step 1)
+
+##### Chrome
+- When using Chrome, you need to restart Chrome so it reloads the trust store (`chrome://restart`).
+- Additionally, after installing a new cert, you need to clear the Storage (DevTools → Application → Clear storage → Clear site data).
+
+##### Google Chrome
+- To skip the installation of the certificate, you can also open `chrome://flags/#unsafely-treat-insecure-origin-as-secure`
+- The feature `Insecure origins treated as secure` must be enabled and the list must include your PairDrop test instance. E.g.: `http://127.0.0.1:3000,https://127.0.0.1:8443`
 
 Please note that the certificates (CA and webserver cert) expire after a day.
-Also, whenever you restart the NGINX Docker, container new certificates are created.
+Also, whenever you restart the NGINX Docker container new certificates are created.
 
-The site is served on `https://<Your FQDN>:8443`.
+The site is served on `https://<Your FQDN>:8443` (Default: `https://localhost:8443`).
 
 [< Back](/README.md)

docs/how-to.md

@@ -1,84 +1,142 @@
 # How-To
-## Send files directly from context menu on Windows
-### Registering to open files with PairDrop
-The [File Handling API](https://learn.microsoft.com/en-us/microsoft-edge/progressive-web-apps-chromium/how-to/handle-files) is implemented
-
-This is still experimental and must be enabled via a flag **before** the PWA is installed to Windows.
-1. [Enabled feature in Edge](https://learn.microsoft.com/en-us/microsoft-edge/progressive-web-apps-chromium/how-to/handle-files#enable-the-file-handling-api)
-2. Install PairDrop by visiting https://pairdrop.net/ with the Edge web browser and install it as described [here](faq.md#help--i-cant-install-the-pwa-).
-3. You are done! You can now send most files one at a time via PairDrop:
-   
-   _context menu > Open with > PairDrop_
-
-[//]: # (Todo: add screenshots)
-
-### Sending multiple files to PairDrop
-Outstandingly, it is also possible to send multiple files to PairDrop \
-via the context menu by adding PairDrop to the `Send to` menu:
-1. [Register PairDrop as file handler](#registering-to-open-files-with-pairdrop) 
-2. Hit Windows Key+R, type: `shell:programs` and hit Enter.
-3. Copy the PairDrop shortcut from the directory
-4. Hit Windows Key+R, type: `shell:sendto` and hit Enter.
-5. Paste the copied shortcut into the directory
-6. You are done! You can now send multiple files (but no directories) directly via PairDrop:
-   
-   _context menu > Send to > PairDrop_
-
-[//]: # (Todo: add screenshots)
 
 ## Send directly from share menu on iOS
 I created an iOS shortcut to send images, files, folder, URLs \
 or text directly from the share-menu 
 https://routinehub.co/shortcut/13990/
 
-[//]: # (Todo: add doku with screenshots)
+[//]: # (Todo: Add screenshots)
 
+<br>
 
 ## Send directly from share menu on Android
 The [Web Share Target API](https://developer.mozilla.org/en-US/docs/Web/Manifest/share_target) is implemented.
 
 When the PWA is installed, it will register itself to the share-menu of the device automatically.
 
+<br>
 
 ## Send directly via command-line interface
-Send files or text with PairDrop via command-line interface.
-
+Send files or text with PairDrop via command-line interface. \
 This opens PairDrop in the default browser where you can choose the receiver.
 
 ### Usage
 ```bash
-$ pairdrop -h
-Current domain: https://pairdrop.net/
+pairdrop -h
+```
+```
+Send files or text with PairDrop via command-line interface.
+Current domain: https://pairdrop-dev.onrender.com/
 
 Usage:
-Open PairDrop:          pairdrop
-Send files:             pairdrop file/directory
-Send text:              pairdrop -t "text"
-Specify domain:         pairdrop -d "https://pairdrop.net/"
-Show this help text:    pairdrop (-h|--help)
+Open PairDrop:		pairdrop
+Send files:		pairdrop file1/directory1 (file2/directory2 file3/directory3 ...)
+Send text:		pairdrop -t "text"
+Specify domain:		pairdrop -d "https://pairdrop.net/"
+Show this help text:	pairdrop (-h|--help)
+
+This pairdrop-cli version was released alongside v1.10.4
 ```
 
-On Windows Command Prompt you need to use bash: `bash pairdrop -h`
-
+<br>
 
 ### Setup
-Download the bash file: [pairdrop-cli/pairdrop](/pairdrop-cli/pairdrop).
 
-#### Linux
-1. Put the file in a preferred folder e.g. `/usr/local/bin`
-2. Make sure the bash file is executable. Otherwise, use `chmod +x pairdrop`
-3. Add absolute path of the folder to PATH variable to make `pairdrop` available globally by executing
-   `export PATH=$PATH:/opt/pairdrop-cli`
+#### Linux / Mac
+1. Download the latest _pairdrop-cli.zip_ from the [releases page](https://github.com/schlagmichdoch/PairDrop/releases)
+   ```shell
+   wget "https://github.com/schlagmichdoch/PairDrop/releases/download/v1.11.2/pairdrop-cli.zip"
+   ```
+   or
+   ```shell
+   curl -LO "https://github.com/schlagmichdoch/PairDrop/releases/download/v1.11.2/pairdrop-cli.zip"
+   ```
+2. Unzip the archive to a folder of your choice e.g. `/usr/share/pairdrop-cli/`
+   ```shell
+   sudo unzip pairdrop-cli.zip -d /usr/share/pairdrop-cli/
+   ```
+3. Copy the file _.pairdrop-cli-config.example_ to _.pairdrop-cli-config_
+   ```shell
+   sudo cp /usr/share/pairdrop-cli/.pairdrop-cli-config.example /usr/share/pairdrop-cli/.pairdrop-cli-config
+   ```
+4. Make the bash file _pairdrop_ executable
+   ```shell
+   sudo chmod +x /usr/share/pairdrop-cli/pairdrop
+   ```
+5. Add a symlink to /usr/local/bin/ to include _pairdrop_ to _PATH_
+   ```shell
+   sudo ln -s /usr/share/pairdrop-cli/pairdrop /usr/local/bin/pairdrop
+   ```
 
-#### Mac
-1. add bash file to `/usr/local/bin`
+<br>
 
 #### Windows
-1. Put file in a preferred folder e.g. `C:\Users\Public\pairdrop-cli`
-2. Search for and open `Edit environment variables for your account`
-3. Click `Environment Variables…`
-4. Under *System Variables* select `Path` and click *Edit...*
-5. Click *New*, insert the preferred folder (`C:\Users\Public\pairdrop-cli`), click *OK* until all windows are closed
-6. Reopen Command prompt window
+1. Download the latest _pairdrop-cli.zip_ from the [releases page](https://github.com/schlagmichdoch/PairDrop/releases)
+2. Put file in a preferred folder e.g. `C:\Program Files\pairdrop-cli`
+3. Inside this folder, copy the file _.pairdrop-cli-config.example_ to _.pairdrop-cli-config_
+4. Search for and open `Edit environment variables for your account`
+5. Click `Environment Variables…`
+6. Under _System Variables_ select `Path` and click _Edit..._
+7. Click _New_, insert the preferred folder (`C:\Program Files\pairdrop-cli`), click *OK* until all windows are closed
+8. Reopen Command prompt window
+
+**Requirements**
+
+As Windows cannot execute bash scripts natively, you need to install [Git Bash](https://gitforwindows.org/).
+
+Then, you can also use pairdrop-cli from the default Windows Command Prompt 
+by using the shell file instead of the bash file which then itself executes 
+_pairdrop-cli_ (the bash file) via the Git Bash.
+```shell
+pairdrop.sh -h
+```
+
+<br>
+
+## Send multiple files and directories directly from context menu on Windows
+
+### Registering to open files with PairDrop
+It is possible to send multiple files with PairDrop via the context menu by adding pairdrop-cli to Windows `Send to` menu:
+1. Download the latest _pairdrop-cli.zip_ from the [releases page](https://github.com/schlagmichdoch/PairDrop/releases)
+2. Unzip the archive to a folder of your choice e.g. `C:\Program Files\pairdrop-cli\`
+3. Inside this folder, copy the file _.pairdrop-cli-config.example_ to _.pairdrop-cli-config_
+4. Copy the shortcut _send with PairDrop.lnk_
+5. Hit Windows Key+R, type: `shell:sendto` and hit Enter.
+6. Paste the copied shortcut into the directory
+7. Open the properties window of the shortcut and edit the link field to point to _send-with-pairdrop.ps1_ located in the folder you used in step 2: \
+   `"C:\Program Files\PowerShell\7\pwsh.exe" -File "C:\Program Files\pairdrop-cli\send-with-pairdrop.ps1"`
+8. You are done! You can now send multiple files and directories directly via PairDrop:
+
+   _context menu_ > _Send to_ > _PairDrop_
+
+##### Requirements
+As Windows cannot execute bash scripts natively, you need to install [Git Bash](https://gitforwindows.org/).
+
+<br>
+
+## Send multiple files and directories directly from context menu on Ubuntu using Nautilus
+
+### Registering to open files with PairDrop
+It is possible to send multiple files with PairDrop via the context menu by adding pairdrop-cli to Nautilus `Scripts` menu:
+1. Register _pairdrop_ as executable via [guide above](#linux).
+2. Copy the shell file _send-with-pairdrop_ to `~/.local/share/nautilus/scripts/` to include it in the context menu
+   ```shell
+   cp /usr/share/pairdrop-cli/send-with-pairdrop ~/.local/share/nautilus/scripts/
+   ```
+3. Make the shell file _send-with-pairdrop_ executable
+   ```shell
+   chmod +x ~/.local/share/nautilus/scripts/send-with-pairdrop
+   ```
+4. You are done! You can now send multiple files and directories directly via PairDrop:
+
+   _context menu_ > _Scripts_ > _send-with-pairdrop_
+
+<br>
+
+## File Handling API
+The [File Handling API](https://learn.microsoft.com/en-us/microsoft-edge/progressive-web-apps-chromium/how-to/handle-files)
+was implemented, but it was removed as default file associations were overwritten ([#17](https://github.com/schlagmichdoch/PairDrop/issues/17),
+[#116](https://github.com/schlagmichdoch/PairDrop/issues/116) [#190](https://github.com/schlagmichdoch/PairDrop/issues/190))
+and it only worked with explicitly specified file types and couldn't handle directories at all.
 
 [< Back](/README.md)

index.js

@@ -1,838 +0,0 @@
-const process = require('process')
-const crypto = require('crypto')
-const {spawn} = require('child_process')
-const WebSocket = require('ws');
-const fs = require('fs');
-const parser = require('ua-parser-js');
-const { uniqueNamesGenerator, animals, colors } = require('unique-names-generator');
-const express = require('express');
-const RateLimit = require('express-rate-limit');
-const http = require('http');
-
-// Handle SIGINT
-process.on('SIGINT', () => {
-    console.info("SIGINT Received, exiting...")
-    process.exit(0)
-})
-
-// Handle SIGTERM
-process.on('SIGTERM', () => {
-    console.info("SIGTERM Received, exiting...")
-    process.exit(0)
-})
-
-// Handle APP ERRORS
-process.on('uncaughtException', (error, origin) => {
-    console.log('----- Uncaught exception -----')
-    console.log(error)
-    console.log('----- Exception origin -----')
-    console.log(origin)
-})
-process.on('unhandledRejection', (reason, promise) => {
-    console.log('----- Unhandled Rejection at -----')
-    console.log(promise)
-    console.log('----- Reason -----')
-    console.log(reason)
-})
-
-if (process.argv.includes('--auto-restart')) {
-    process.on(
-        'uncaughtException',
-        () => {
-            process.once(
-                'exit',
-                () => spawn(
-                    process.argv.shift(),
-                    process.argv,
-                    {
-                        cwd: process.cwd(),
-                        detached: true,
-                        stdio: 'inherit'
-                    }
-                )
-            );
-            process.exit();
-        }
-    );
-}
-
-const rtcConfig = process.env.RTC_CONFIG
-    ? JSON.parse(fs.readFileSync(process.env.RTC_CONFIG, 'utf8'))
-    : {
-        "sdpSemantics": "unified-plan",
-        "iceServers": [
-            {
-                "urls": "stun:stun.l.google.com:19302"
-            }
-        ]
-    };
-
-const app = express();
-
-if (process.argv.includes('--rate-limit')) {
-    const limiter = RateLimit({
-        windowMs: 5 * 60 * 1000, // 5 minutes
-        max: 1000, // Limit each IP to 1000 requests per `window` (here, per 5 minutes)
-        message: 'Too many requests from this IP Address, please try again after 5 minutes.',
-        standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
-        legacyHeaders: false, // Disable the `X-RateLimit-*` headers
-    })
-
-    app.use(limiter);
-    // ensure correct client ip and not the ip of the reverse proxy is used for rate limiting on render.com
-    // see https://github.com/express-rate-limit/express-rate-limit#troubleshooting-proxy-issues
-    app.set('trust proxy', 5);
-}
-
-if (process.argv.includes('--include-ws-fallback')) {
-    app.use(express.static('public_included_ws_fallback'));
-} else {
-    app.use(express.static('public'));
-}
-
-const debugMode = process.env.DEBUG_MODE === "true";
-
-if (debugMode) {
-    console.log("DEBUG_MODE is active. To protect privacy, do not use in production.")
-}
-
-let ipv6_lcl;
-if (process.env.IPV6_LOCALIZE) {
-    ipv6_lcl = parseInt(process.env.IPV6_LOCALIZE);
-    if (!ipv6_lcl || !(0 < ipv6_lcl && ipv6_lcl < 8)) {
-        console.error("IPV6_LOCALIZE must be an integer between 1 and 7");
-        return;
-    }
-
-    console.log("IPv6 client IPs will be localized to", ipv6_lcl, ipv6_lcl === 1 ? "segment" : "segments");
-}
-
-app.use(function(req, res) {
-    res.redirect('/');
-});
-
-app.get('/', (req, res) => {
-    res.sendFile('index.html');
-});
-
-const server = http.createServer(app);
-const port = process.env.PORT || 3000;
-
-if (process.argv.includes('--localhost-only')) {
-    server.listen(port, '127.0.0.1');
-} else {
-    server.listen(port);
-}
-
-class PairDropServer {
-
-    constructor() {
-        this._wss = new WebSocket.Server({ server });
-        this._wss.on('connection', (socket, request) => this._onConnection(new Peer(socket, request)));
-
-        this._rooms = {}; // { roomId: peers[] }
-        this._roomSecrets = {}; // { pairKey: roomSecret }
-
-        this._keepAliveTimers = {};
-
-        console.log('PairDrop is running on port', port);
-    }
-
-    _onConnection(peer) {
-        peer.socket.on('message', message => this._onMessage(peer, message));
-        peer.socket.onerror = e => console.error(e);
-
-        this._keepAlive(peer);
-
-        this._send(peer, {
-            type: 'rtc-config',
-            config: rtcConfig
-        });
-
-        // send displayName
-        this._send(peer, {
-            type: 'display-name',
-            message: {
-                displayName: peer.name.displayName,
-                deviceName: peer.name.deviceName,
-                peerId: peer.id,
-                peerIdHash: hasher.hashCodeSalted(peer.id)
-            }
-        });
-    }
-
-    _onMessage(sender, message) {
-        // Try to parse message
-        try {
-            message = JSON.parse(message);
-        } catch (e) {
-            return; // TODO: handle malformed JSON
-        }
-
-        switch (message.type) {
-            case 'disconnect':
-                this._onDisconnect(sender);
-                break;
-            case 'pong':
-                this._keepAliveTimers[sender.id].lastBeat = Date.now();
-                break;
-            case 'join-ip-room':
-                this._joinIpRoom(sender);
-                break;
-            case 'room-secrets':
-                this._onRoomSecrets(sender, message);
-                break;
-            case 'room-secrets-deleted':
-                this._onRoomSecretsDeleted(sender, message);
-                break;
-            case 'pair-device-initiate':
-                this._onPairDeviceInitiate(sender);
-                break;
-            case 'pair-device-join':
-                this._onPairDeviceJoin(sender, message);
-                break;
-            case 'pair-device-cancel':
-                this._onPairDeviceCancel(sender);
-                break;
-            case 'regenerate-room-secret':
-                this._onRegenerateRoomSecret(sender, message);
-                break;
-            case 'create-public-room':
-                this._onCreatePublicRoom(sender);
-                break;
-            case 'join-public-room':
-                this._onJoinPublicRoom(sender, message);
-                break;
-            case 'leave-public-room':
-                this._onLeavePublicRoom(sender);
-                break;
-            case 'signal':
-            default:
-                this._signalAndRelay(sender, message);
-        }
-    }
-
-    _signalAndRelay(sender, message) {
-        const room = message.roomType === 'ip'
-            ? sender.ip
-            : message.roomId;
-
-        // relay message to recipient
-        if (message.to && Peer.isValidUuid(message.to) && this._rooms[room]) {
-            const recipient = this._rooms[room][message.to];
-            delete message.to;
-            // add sender
-            message.sender = {
-                id: sender.id,
-                rtcSupported: sender.rtcSupported
-            };
-            this._send(recipient, message);
-        }
-    }
-
-    _onDisconnect(sender) {
-        this._disconnect(sender);
-    }
-
-    _disconnect(sender) {
-        this._removePairKey(sender.pairKey);
-        sender.pairKey = null;
-
-        this._cancelKeepAlive(sender);
-        delete this._keepAliveTimers[sender.id];
-
-        this._leaveIpRoom(sender, true);
-        this._leaveAllSecretRooms(sender, true);
-        this._leavePublicRoom(sender, true);
-
-        sender.socket.terminate();
-    }
-
-    _onRoomSecrets(sender, message) {
-        if (!message.roomSecrets) return;
-
-        const roomSecrets = message.roomSecrets.filter(roomSecret => {
-            return /^[\x00-\x7F]{64,256}$/.test(roomSecret);
-        })
-
-        if (!roomSecrets) return;
-
-        this._joinSecretRooms(sender, roomSecrets);
-    }
-
-    _onRoomSecretsDeleted(sender, message) {
-        for (let i = 0; i<message.roomSecrets.length; i++) {
-            this._deleteSecretRoom(message.roomSecrets[i]);
-        }
-    }
-
-    _deleteSecretRoom(roomSecret) {
-        const room = this._rooms[roomSecret];
-        if (!room) return;
-
-        for (const peerId in room) {
-            const peer = room[peerId];
-
-            this._leaveSecretRoom(peer, roomSecret, true);
-
-            this._send(peer, {
-                type: 'secret-room-deleted',
-                roomSecret: roomSecret,
-            });
-        }
-    }
-
-    _onPairDeviceInitiate(sender) {
-        let roomSecret = randomizer.getRandomString(256);
-        let pairKey = this._createPairKey(sender, roomSecret);
-
-        if (sender.pairKey) {
-            this._removePairKey(sender.pairKey);
-        }
-        sender.pairKey = pairKey;
-
-        this._send(sender, {
-            type: 'pair-device-initiated',
-            roomSecret: roomSecret,
-            pairKey: pairKey
-        });
-        this._joinSecretRoom(sender, roomSecret);
-    }
-
-    _onPairDeviceJoin(sender, message) {
-        if (sender.rateLimitReached()) {
-            this._send(sender, { type: 'join-key-rate-limit' });
-            return;
-        }
-
-        if (!this._roomSecrets[message.pairKey] || sender.id === this._roomSecrets[message.pairKey].creator.id) {
-            this._send(sender, { type: 'pair-device-join-key-invalid' });
-            return;
-        }
-
-        const roomSecret = this._roomSecrets[message.pairKey].roomSecret;
-        const creator = this._roomSecrets[message.pairKey].creator;
-        this._removePairKey(message.pairKey);
-        this._send(sender, {
-            type: 'pair-device-joined',
-            roomSecret: roomSecret,
-            peerId: creator.id
-        });
-        this._send(creator, {
-            type: 'pair-device-joined',
-            roomSecret: roomSecret,
-            peerId: sender.id
-        });
-        this._joinSecretRoom(sender, roomSecret);
-        this._removePairKey(sender.pairKey);
-    }
-
-    _onPairDeviceCancel(sender) {
-        const pairKey = sender.pairKey
-
-        if (!pairKey) return;
-
-        this._removePairKey(pairKey);
-        this._send(sender, {
-            type: 'pair-device-canceled',
-            pairKey: pairKey,
-        });
-    }
-
-    _onCreatePublicRoom(sender) {
-        let publicRoomId = randomizer.getRandomString(5, true).toLowerCase();
-
-        this._send(sender, {
-            type: 'public-room-created',
-            roomId: publicRoomId
-        });
-
-        this._joinPublicRoom(sender, publicRoomId);
-    }
-
-    _onJoinPublicRoom(sender, message) {
-        if (sender.rateLimitReached()) {
-            this._send(sender, { type: 'join-key-rate-limit' });
-            return;
-        }
-
-        if (!this._rooms[message.publicRoomId] && !message.createIfInvalid) {
-            this._send(sender, { type: 'public-room-id-invalid', publicRoomId: message.publicRoomId });
-            return;
-        }
-
-        this._leavePublicRoom(sender);
-        this._joinPublicRoom(sender, message.publicRoomId);
-    }
-
-    _onLeavePublicRoom(sender) {
-        this._leavePublicRoom(sender, true);
-        this._send(sender, { type: 'public-room-left' });
-    }
-
-    _onRegenerateRoomSecret(sender, message) {
-        const oldRoomSecret = message.roomSecret;
-        const newRoomSecret = randomizer.getRandomString(256);
-
-        // notify all other peers
-        for (const peerId in this._rooms[oldRoomSecret]) {
-            const peer = this._rooms[oldRoomSecret][peerId];
-            this._send(peer, {
-                type: 'room-secret-regenerated',
-                oldRoomSecret: oldRoomSecret,
-                newRoomSecret: newRoomSecret,
-            });
-            peer.removeRoomSecret(oldRoomSecret);
-        }
-        delete this._rooms[oldRoomSecret];
-    }
-
-    _createPairKey(creator, roomSecret) {
-        let pairKey;
-        do {
-            // get randomInt until keyRoom not occupied
-            pairKey = crypto.randomInt(1000000, 1999999).toString().substring(1); // include numbers with leading 0s
-        } while (pairKey in this._roomSecrets)
-
-        this._roomSecrets[pairKey] = {
-            roomSecret: roomSecret,
-            creator: creator
-        }
-
-        return pairKey;
-    }
-
-    _removePairKey(roomKey) {
-        if (roomKey in this._roomSecrets) {
-            this._roomSecrets[roomKey].creator.roomKey = null
-            delete this._roomSecrets[roomKey];
-        }
-    }
-
-    _joinIpRoom(peer) {
-        this._joinRoom(peer, 'ip', peer.ip);
-    }
-
-    _joinSecretRoom(peer, roomSecret) {
-        this._joinRoom(peer, 'secret', roomSecret);
-
-        // add secret to peer
-        peer.addRoomSecret(roomSecret);
-    }
-
-    _joinPublicRoom(peer, publicRoomId) {
-        // prevent joining of 2 public rooms simultaneously
-        this._leavePublicRoom(peer);
-
-        this._joinRoom(peer, 'public-id', publicRoomId);
-
-        peer.publicRoomId = publicRoomId;
-    }
-
-    _joinRoom(peer, roomType, roomId) {
-        // roomType: 'ip', 'secret' or 'public-id'
-        if (this._rooms[roomId] && this._rooms[roomId][peer.id]) {
-            // ensures that otherPeers never receive `peer-left` after `peer-joined` on reconnect.
-            this._leaveRoom(peer, roomType, roomId);
-        }
-
-        // if room doesn't exist, create it
-        if (!this._rooms[roomId]) {
-            this._rooms[roomId] = {};
-        }
-
-        this._notifyPeers(peer, roomType, roomId);
-
-        // add peer to room
-        this._rooms[roomId][peer.id] = peer;
-    }
-
-
-    _leaveIpRoom(peer, disconnect = false) {
-        this._leaveRoom(peer, 'ip', peer.ip, disconnect);
-    }
-
-    _leaveSecretRoom(peer, roomSecret, disconnect = false) {
-        this._leaveRoom(peer, 'secret', roomSecret, disconnect)
-
-        //remove secret from peer
-        peer.removeRoomSecret(roomSecret);
-    }
-
-    _leavePublicRoom(peer, disconnect = false) {
-        if (!peer.publicRoomId) return;
-
-        this._leaveRoom(peer, 'public-id', peer.publicRoomId, disconnect);
-
-        peer.publicRoomId = null;
-    }
-
-    _leaveRoom(peer, roomType, roomId, disconnect = false) {
-        if (!this._rooms[roomId] || !this._rooms[roomId][peer.id]) return;
-
-        // remove peer from room
-        delete this._rooms[roomId][peer.id];
-
-        // delete room if empty and abort
-        if (!Object.keys(this._rooms[roomId]).length) {
-            delete this._rooms[roomId];
-            return;
-        }
-
-        // notify all other peers that remain in room that peer left
-        for (const otherPeerId in this._rooms[roomId]) {
-            const otherPeer = this._rooms[roomId][otherPeerId];
-
-            let msg = {
-                type: 'peer-left',
-                peerId: peer.id,
-                roomType: roomType,
-                roomId: roomId,
-                disconnect: disconnect
-            };
-
-            this._send(otherPeer, msg);
-        }
-    }
-
-    _notifyPeers(peer, roomType, roomId) {
-        if (!this._rooms[roomId]) return;
-
-        // notify all other peers that peer joined
-        for (const otherPeerId in this._rooms[roomId]) {
-            if (otherPeerId === peer.id) continue;
-            const otherPeer = this._rooms[roomId][otherPeerId];
-
-            let msg = {
-                type: 'peer-joined',
-                peer: peer.getInfo(),
-                roomType: roomType,
-                roomId: roomId
-            };
-
-            this._send(otherPeer, msg);
-        }
-
-        // notify peer about peers already in the room
-        const otherPeers = [];
-        for (const otherPeerId in this._rooms[roomId]) {
-            if (otherPeerId === peer.id) continue;
-            otherPeers.push(this._rooms[roomId][otherPeerId].getInfo());
-        }
-
-        let msg = {
-            type: 'peers',
-            peers: otherPeers,
-            roomType: roomType,
-            roomId: roomId
-        };
-
-        this._send(peer, msg);
-    }
-
-    _joinSecretRooms(peer, roomSecrets) {
-        for (let i=0; i<roomSecrets.length; i++) {
-            this._joinSecretRoom(peer, roomSecrets[i])
-        }
-    }
-
-    _leaveAllSecretRooms(peer, disconnect = false) {
-        for (let i=0; i<peer.roomSecrets.length; i++) {
-            this._leaveSecretRoom(peer, peer.roomSecrets[i], disconnect);
-        }
-    }
-
-    _send(peer, message) {
-        if (!peer) return;
-        if (this._wss.readyState !== this._wss.OPEN) return;
-        message = JSON.stringify(message);
-        peer.socket.send(message);
-    }
-
-    _keepAlive(peer) {
-        this._cancelKeepAlive(peer);
-        let timeout = 1000;
-
-        if (!this._keepAliveTimers[peer.id]) {
-            this._keepAliveTimers[peer.id] = {
-                timer: 0,
-                lastBeat: Date.now()
-            };
-        }
-
-        if (Date.now() - this._keepAliveTimers[peer.id].lastBeat > 5 * timeout) {
-            // Disconnect peer if unresponsive for 10s
-            this._disconnect(peer);
-            return;
-        }
-
-        this._send(peer, { type: 'ping' });
-
-        this._keepAliveTimers[peer.id].timer = setTimeout(() => this._keepAlive(peer), timeout);
-    }
-
-    _cancelKeepAlive(peer) {
-        if (this._keepAliveTimers[peer.id]?.timer) {
-            clearTimeout(this._keepAliveTimers[peer.id].timer);
-        }
-    }
-}
-
-
-
-class Peer {
-
-    constructor(socket, request) {
-        // set socket
-        this.socket = socket;
-
-        // set remote ip
-        this._setIP(request);
-
-        // set peer id
-        this._setPeerId(request);
-
-        // is WebRTC supported ?
-        this.rtcSupported = request.url.indexOf('webrtc') > -1;
-
-        // set name
-        this._setName(request);
-
-        this.requestRate = 0;
-
-        this.roomSecrets = [];
-        this.roomKey = null;
-
-        this.publicRoomId = null;
-    }
-
-    rateLimitReached() {
-        // rate limit implementation: max 10 attempts every 10s
-        if (this.requestRate >= 10) {
-            return true;
-        }
-        this.requestRate += 1;
-        setTimeout(_ => this.requestRate -= 1, 10000);
-        return false;
-    }
-
-    _setIP(request) {
-        if (request.headers['cf-connecting-ip']) {
-            this.ip = request.headers['cf-connecting-ip'].split(/\s*,\s*/)[0];
-        } else if (request.headers['x-forwarded-for']) {
-            this.ip = request.headers['x-forwarded-for'].split(/\s*,\s*/)[0];
-        } else {
-            this.ip = request.connection.remoteAddress;
-        }
-
-        // remove the prefix used for IPv4-translated addresses
-        if (this.ip.substring(0,7) === "::ffff:")
-            this.ip = this.ip.substring(7);
-
-        let ipv6_was_localized = false;
-        if (ipv6_lcl && this.ip.includes(':')) {
-            this.ip = this.ip.split(':',ipv6_lcl).join(':');
-            ipv6_was_localized = true;
-        }
-
-        if (debugMode) {
-            console.debug("----DEBUGGING-PEER-IP-START----");
-            console.debug("remoteAddress:", request.connection.remoteAddress);
-            console.debug("x-forwarded-for:", request.headers['x-forwarded-for']);
-            console.debug("cf-connecting-ip:", request.headers['cf-connecting-ip']);
-            if (ipv6_was_localized)
-                console.debug("IPv6 client IP was localized to", ipv6_lcl, ipv6_lcl > 1 ? "segments" : "segment");
-            console.debug("PairDrop uses:", this.ip);
-            console.debug("IP is private:", this.ipIsPrivate(this.ip));
-            console.debug("if IP is private, '127.0.0.1' is used instead");
-            console.debug("----DEBUGGING-PEER-IP-END----");
-        }
-
-        // IPv4 and IPv6 use different values to refer to localhost
-        // put all peers on the same network as the server into the same room as well
-        if (this.ip === '::1' || this.ipIsPrivate(this.ip)) {
-            this.ip = '127.0.0.1';
-        }
-    }
-
-    ipIsPrivate(ip) {
-        // if ip is IPv4
-        if (!ip.includes(":")) {
-            //         10.0.0.0 - 10.255.255.255        ||   172.16.0.0 - 172.31.255.255                          ||    192.168.0.0 - 192.168.255.255
-            return  /^(10)\.(.*)\.(.*)\.(.*)$/.test(ip) || /^(172)\.(1[6-9]|2[0-9]|3[0-1])\.(.*)\.(.*)$/.test(ip) || /^(192)\.(168)\.(.*)\.(.*)$/.test(ip)
-        }
-
-        // else: ip is IPv6
-        const firstWord = ip.split(":").find(el => !!el); //get first not empty word
-
-        // The original IPv6 Site Local addresses (fec0::/10) are deprecated. Range: fec0 - feff
-        if (/^fe[c-f][0-f]$/.test(firstWord))
-            return true;
-
-        // These days Unique Local Addresses (ULA) are used in place of Site Local.
-        // Range: fc00 - fcff
-        else if (/^fc[0-f]{2}$/.test(firstWord))
-            return true;
-
-        // Range: fd00 - fcff
-        else if (/^fd[0-f]{2}$/.test(firstWord))
-            return true;
-
-        // Link local addresses (prefixed with fe80) are not routable
-        else if (firstWord === "fe80")
-            return true;
-
-        // Discard Prefix
-        else if (firstWord === "100")
-            return true;
-
-        // Any other IP address is not Unique Local Address (ULA)
-        return false;
-    }
-
-    _setPeerId(request) {
-        const searchParams = new URL(request.url, "http://server").searchParams;
-        let peerId = searchParams.get("peer_id");
-        let peerIdHash = searchParams.get("peer_id_hash");
-        if (peerId && Peer.isValidUuid(peerId) && this.isPeerIdHashValid(peerId, peerIdHash)) {
-            this.id = peerId;
-        } else {
-            this.id = crypto.randomUUID();
-        }
-    }
-
-    toString() {
-        return `<Peer id=${this.id} ip=${this.ip} rtcSupported=${this.rtcSupported}>`
-    }
-
-    _setName(req) {
-        let ua = parser(req.headers['user-agent']);
-
-
-        let deviceName = '';
-
-        if (ua.os && ua.os.name) {
-            deviceName = ua.os.name.replace('Mac OS', 'Mac') + ' ';
-        }
-
-        if (ua.device.model) {
-            deviceName += ua.device.model;
-        } else {
-            deviceName += ua.browser.name;
-        }
-
-        if(!deviceName)
-            deviceName = 'Unknown Device';
-
-        const displayName = uniqueNamesGenerator({
-            length: 2,
-            separator: ' ',
-            dictionaries: [colors, animals],
-            style: 'capital',
-            seed: cyrb53(this.id)
-        })
-
-        this.name = {
-            model: ua.device.model,
-            os: ua.os.name,
-            browser: ua.browser.name,
-            type: ua.device.type,
-            deviceName,
-            displayName
-        };
-    }
-
-    getInfo() {
-        return {
-            id: this.id,
-            name: this.name,
-            rtcSupported: this.rtcSupported
-        }
-    }
-
-    static isValidUuid(uuid) {
-        return /^([0-9]|[a-f]){8}-(([0-9]|[a-f]){4}-){3}([0-9]|[a-f]){12}$/.test(uuid);
-    }
-
-    isPeerIdHashValid(peerId, peerIdHash) {
-        return peerIdHash === hasher.hashCodeSalted(peerId);
-    }
-
-    addRoomSecret(roomSecret) {
-        if (!(roomSecret in this.roomSecrets)) {
-            this.roomSecrets.push(roomSecret);
-        }
-    }
-
-    removeRoomSecret(roomSecret) {
-        if (roomSecret in this.roomSecrets) {
-            delete this.roomSecrets[roomSecret];
-        }
-    }
-}
-
-const hasher = (() => {
-    let password;
-    return {
-        hashCodeSalted(salt) {
-            if (!password) {
-                // password is created on first call.
-                password = randomizer.getRandomString(128);
-            }
-
-            return crypto.createHash("sha3-512")
-                .update(password)
-                .update(crypto.createHash("sha3-512").update(salt, "utf8").digest("hex"))
-                .digest("hex");
-        }
-    }
-})()
-
-const randomizer = (() => {
-    let charCodeLettersOnly = r => 65 <= r && r <= 90;
-    let charCodeAllPrintableChars = r => r === 45 || 47 <= r && r <= 57 || 64 <= r && r <= 90 || 97 <= r && r <= 122;
-
-    return {
-        getRandomString(length, lettersOnly = false) {
-            const charCodeCondition = lettersOnly
-                ? charCodeLettersOnly
-                : charCodeAllPrintableChars;
-
-            let string = "";
-            while (string.length < length) {
-                let arr = new Uint16Array(length);
-                crypto.webcrypto.getRandomValues(arr);
-                arr = Array.apply([], arr); /* turn into non-typed array */
-                arr = arr.map(function (r) {
-                    return r % 128
-                })
-                arr = arr.filter(function (r) {
-                    /* strip non-printables: if we transform into desirable range we have a probability bias, so I suppose we better skip this character */
-                    return charCodeCondition(r);
-                });
-                string += String.fromCharCode.apply(String, arr);
-            }
-            return string.substring(0, length)
-        }
-    }
-})()
-
-/*
-    cyrb53 (c) 2018 bryc (github.com/bryc)
-    A fast and simple hash function with decent collision resistance.
-    Largely inspired by MurmurHash2/3, but with a focus on speed/simplicity.
-    Public domain. Attribution appreciated.
-*/
-const cyrb53 = function(str, seed = 0) {
-    let h1 = 0xdeadbeef ^ seed, h2 = 0x41c6ce57 ^ seed;
-    for (let i = 0, ch; i < str.length; i++) {
-        ch = str.charCodeAt(i);
-        h1 = Math.imul(h1 ^ ch, 2654435761);
-        h2 = Math.imul(h2 ^ ch, 1597334677);
-    }
-    h1 = Math.imul(h1 ^ (h1>>>16), 2246822507) ^ Math.imul(h2 ^ (h2>>>13), 3266489909);
-    h2 = Math.imul(h2 ^ (h2>>>16), 2246822507) ^ Math.imul(h1 ^ (h1>>>13), 3266489909);
-    return 4294967296 * (2097151 & h2) + (h1>>>0);
-};
-
-new PairDropServer();

licenses/BSD_3-Clause-zip-js

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2023, Gildas Lormeau
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

licenses/MIT-NoSleep

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) Rich Tibbett
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

licenses/MIT-heic2any

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2020 Alex Corvi
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package.json

@@ -1,20 +1,21 @@
 {
   "name": "pairdrop",
-  "version": "1.8.0",
+  "version": "1.11.2",
+  "type": "module",
   "description": "",
-  "main": "index.js",
+  "main": "server/index.js",
   "scripts": {
-    "start": "node index.js",
-    "start:prod": "node index.js --rate-limit --auto-restart"
+    "start": "node server/index.js",
+    "start:prod": "node server/index.js --rate-limit --auto-restart"
   },
   "author": "",
   "license": "ISC",
   "dependencies": {
     "express": "^4.18.2",
-    "express-rate-limit": "^7.0.1",
-    "ua-parser-js": "^1.0.36",
+    "express-rate-limit": "^7.1.5",
+    "ua-parser-js": "^1.0.37",
     "unique-names-generator": "^4.3.0",
-    "ws": "^8.14.1"
+    "ws": "^8.16.0"
   },
   "engines": {
     "node": ">=15"

pairdrop-cli/.gitignore

@@ -0,0 +1 @@
+.pairdrop-cli-config

pairdrop-cli/.pairdrop-cli-config.example

@@ -0,0 +1 @@
+DOMAIN=https://pairdrop.net/

pairdrop-cli/pairdrop

@@ -1,6 +1,9 @@
 #!/bin/bash
 set -e
 
+# PairDrop version when this file was last changed
+version="v1.10.4"
+
 ############################################################
 # Help                                                     #
 ############################################################
@@ -12,10 +15,12 @@ help()
    echo
    echo "Usage:"
    echo -e "Open PairDrop:\t\t$(basename "$0")"
-   echo -e "Send files:\t\t$(basename "$0") file/directory"
+   echo -e "Send files:\t\t$(basename "$0") file1/directory1 (file2/directory2 file3/directory3 ...)"
    echo -e "Send text:\t\t$(basename "$0") -t \"text\""
    echo -e "Specify domain:\t\t$(basename "$0") -d \"https://pairdrop.net/\""
    echo -e "Show this help text:\t$(basename "$0") (-h|--help)"
+   echo
+   echo "This pairdrop-cli version was released alongside ${version}"
 }
 
 openPairDrop()
@@ -36,7 +41,7 @@ openPairDrop()
   elif [[ $OS == "WSL" || $OS == "WSL2" ]];then
     powershell.exe /c "Start-Process ${url}"
   else
-    xdg-open "$url"
+    xdg-open "$url" > /dev/null 2>&1
   fi
 
 
@@ -62,7 +67,7 @@ setOs()
 specifyDomain()
 {
   [[ ! $1 = http* ]] || [[ ! $1 = */ ]] && echo "Incorrect format. Specify domain like https://pairdrop.net/" && exit
-  echo "DOMAIN=${1}" > "$CONFIGPATH"
+  echo "DOMAIN=${1}" > "$config_path"
   echo -e "Domain is now set to:\n$1\n"
 }
 
@@ -87,75 +92,228 @@ sendText()
     exit
 }
 
+escapePSPath()
+{
+  local path=$1
+  
+  # escape '[' and ']' with grave accent (`) character
+  pathPS=${path//[/\`[}
+  pathPS=${pathPS//]/\`]}
+  # escape single quote (') with another single quote (')
+  pathPS=${pathPS//\'/\'\'}
+  
+  # Convert GitHub bash path "/i/path" to Windows path "I:/path"
+  if [[ $pathPS == /* ]]; then
+    # Remove preceding slash
+    pathPS="${pathPS#/}"
+    # Convert drive letter to uppercase
+    driveLetter=$(echo "${pathPS::1}" | tr '[:lower:]' '[:upper:]')
+    # Put together absolute path as used in Windows
+    pathPS="${driveLetter}:${pathPS:1}"        
+  fi
+  
+  echo "$pathPS"
+}
+
 sendFiles()
 {
   params="base64zip=hash"
-  if [[ $1 == */ ]]; then
-    path="${1::-1}"
-  else
-    path=$1
-  fi
-  zipPath="${path}_pairdrop.zip"
-  zipPath=${zipPath// /_}
+  workingDir="$(pwd)"
+  tmpDir="/tmp/pairdrop-cli-temp/"
+  tmpDirPS="\$env:TEMP/pairdrop-cli-temp/"
+  
+  index=0
+  directoryBaseNamesUnix=()
+  directoryPathsUnix=()
+  filePathsUnix=()
+  directoryCount=0
+  fileCount=0
+  pathsPS=""
 
-  [[ -a "$zipPath" ]] && echo "Cannot overwrite $zipPath. Please remove first." && exit
-
-  if [[ -d $path ]]; then
-    zipPathTemp="${path}_pairdrop_temp.zip"
-    [[ -a "$zipPathTemp" ]] && echo "Cannot overwrite $zipPathTemp. Please remove first." && exit
-    echo "Processing directory..."
-
-    # Create zip files temporarily to send directory
-    if [[ $OS == "Windows" ]];then
-          powershell.exe -Command "Compress-Archive -Path ${path} -DestinationPath ${zipPath}"
-          echo "Compress-Archive -Path ${zipPath} -DestinationPath ${zipPathTemp}"
-          powershell.exe -Command "Compress-Archive -Path ${zipPath} -DestinationPath ${zipPathTemp}"
-    else
-          zip -q -b /tmp/ -r "$zipPath" "$path"
-          zip -q -b /tmp/ "$zipPathTemp" "$zipPath"
-    fi
-
-    if [[ $OS == "Mac" ]];then
-      hash=$(base64 -i "$zipPathTemp")
-    else
-      hash=$(base64 -w 0 "$zipPathTemp")
-    fi
-
-    # remove temporary temp file
-    rm "$zipPathTemp"
-  else
-    echo "Processing file..."
-
-    # Create zip file temporarily to send file
-
-    if [[ $OS == "Windows" ]];then
-      powershell.exe -Command "Compress-Archive -Path ${path} -DestinationPath ${zipPath} -CompressionLevel Optimal"
-    else
-      zip -q -b /tmp/ "$zipPath" "$path"
-    fi
-    if [[ $OS == "Mac" ]];then
-      hash=$(base64 -i "$zipPath")
-    else
-      hash=$(base64 -w 0 "$zipPath")
-    fi
+  #create tmp folder if it does not exist already
+  if [[ ! -d "$tmpDir" ]]; then
+    mkdir "$tmpDir"
   fi
 
-  # remove temporary temp file
-  rm "$zipPath"
+  for arg in "$@"; do
+   echo "$arg"
+   [[ ! -e "$arg" ]] && echo "The given path $arg does not exist." && exit
 
-  if [[ $(echo -n "$hash" | wc -m) -gt 32600 ]];then
+    # Remove trailing slash from directory
+    arg="${arg%/}"
+
+    # get absolute path and basename of file/directory
+    absolutePath=$(realpath "$arg")
+    baseName=$(basename "$absolutePath")
+    directoryPath=$(dirname "$absolutePath")
+
+    if [[ -d $absolutePath ]]; then
+      # is directory
+      ((directoryCount+=1))
+      # add basename and directory path to arrays
+      directoryBaseNamesUnix+=("$baseName")
+      directoryPathsUnix+=("$directoryPath")
+    else
+      # is file
+      ((fileCount+=1))
+      absolutePathUnix=$absolutePath
+      # append new path and separate paths with space
+      filePathsUnix+=("$absolutePathUnix")
+    fi
+
+    # Prepare paths for PowerShell on Windows
+    if [[ $OS == "Windows" ]];then
+      absolutePathPS=$(escapePSPath "$absolutePath")
+      
+      # append new path and separate paths with commas
+      pathsPS+="'${absolutePathPS}', "
+    fi
+    
+    # set fileNames on first loop
+    if [[ $index == 0 ]]; then
+      baseNameU=${baseName// /_}
+
+      # Prevent baseNameU being empty for hidden files by removing the preceding dot
+      if [[ $baseNameU == .* ]]; then
+        baseNameU=${baseNameU#.*}
+      fi
+
+      # only use trunk of basename "document.txt" -> "document"
+      baseNameTrunk=${baseNameU%.*}
+      
+      # remove all special characters
+      zipName=${baseNameTrunk//[^a-zA-Z0-9_]/}
+      
+      zipToSendAbs="${tmpDir}${zipName}_pairdrop.zip"
+      wrapperZipAbs="${tmpDir}${zipName}_pairdrop_wrapper.zip"
+
+      if [[ $OS == "Windows" ]];then
+        zipToSendAbsPS="${tmpDirPS}${zipName}_pairdrop.zip"
+        wrapperZipAbsPS="${tmpDirPS}${zipName}_pairdrop_wrapper.zip"
+      fi
+    fi
+
+    ((index+=1)) # somehow ((index++)) stops the script
+  done
+
+  # Prepare paths for PowerShell on Windows
+  if [[ $OS == "Windows" ]];then
+    # remove trailing comma
+    pathsPS=${pathsPS%??}
+  fi
+
+  echo "Preparing ${fileCount} files and ${directoryCount} directories..."
+
+  # if arguments include files only -> zip files once so files it is unzipped by sending browser
+  # if arguments include directories -> wrap first zip in a second wrapper zip so that after unzip by sending browser a zip file is sent to receiver
+  #
+  # Preferred zip structure:
+  # pairdrop "d1/d2/d3/f1" "../../d4/d5/d6/f2" "d7/" "../d8/" "f5"
+  # zip structure: pairdrop.zip
+  #                |-f1
+  #                |-f2
+  #                |-d7/
+  #                |-d8/
+  #                |-f5
+  # -> truncate (relative) paths but keep directories
+  
+  [[ -e "$zipToSendAbs" ]] && echo "Cannot overwrite $zipToSendAbs. Please remove first." && exit
+
+  if [[ $OS == "Windows" ]];then
+    # Powershell does preferred zip structure natively
+    powershell.exe -Command "Compress-Archive -Path ${pathsPS} -DestinationPath ${zipToSendAbsPS}"
+  else
+    # Workaround needed to create preferred zip structure on unix systems
+    # Create zip file with all single files by junking the path
+    if [[ $fileCount != 0 ]]; then
+      zip -q -b /tmp/ -j -0 -r "$zipToSendAbs" "${filePathsUnix[@]}"
+    fi
+
+    # Add directories recursively to zip file
+    index=0
+    while [[ $index < $directoryCount ]]; do
+      # workaround to keep directory name but junk the rest of the paths
+
+      # cd to path above directory
+      cd "${directoryPathsUnix[index]}"
+
+      # add directory to zip without junking the path
+      zip -q -b /tmp/ -0 -u -r "$zipToSendAbs" "${directoryBaseNamesUnix[index]}"
+
+      # cd back to working directory
+      cd "$workingDir"
+
+      ((index+=1)) # somehow ((index++)) stops the script
+    done
+  fi
+
+  # If directories are included send as zip
+  # -> Create additional zip wrapper which will be unzipped by the sending browser
+  if [[ "$directoryCount" != 0 ]]; then
+    echo "Bundle as ZIP file..."
+
+    # Prevent filename from being absolute zip path by "cd"ing to directory before zipping
+    zipToSendDirectory=$(dirname "$zipToSendAbs")
+    zipToSendBaseName=$(basename "$zipToSendAbs")
+
+    cd "$zipToSendDirectory"
+    
+    [[ -e "$wrapperZipAbs" ]] && echo "Cannot overwrite $wrapperZipAbs. Please remove first." && exit
+    
+    if [[ $OS == "Windows" ]];then
+      powershell.exe -Command "Compress-Archive -Path ${zipToSendBaseName} -DestinationPath ${wrapperZipAbsPS} -CompressionLevel Optimal"
+    else
+      zip -q -b /tmp/ -0 "$wrapperZipAbs" "$zipToSendBaseName"
+    fi
+    cd "$workingDir"
+
+    # remove inner zip file and set wrapper as zipToSend (do not differentiate between OS as this is done via Git Bash on Windows)
+    rm "$zipToSendAbs"
+
+    zipToSendAbs=$wrapperZipAbs
+  fi
+
+  # base64 encode zip file
+  if [[ $OS == "Mac" ]];then
+    hash=$(base64 -i "$zipToSendAbs")
+  else
+    hash=$(base64 -w 0 "$zipToSendAbs")
+  fi
+
+  # remove zip file (do not differentiate between OS as this is done via Git Bash on Windows)
+  rm "$zipToSendAbs"
+
+  if [[ $(echo -n "$hash" | wc -m) -gt 1000 ]];then
     params="base64zip=paste"
+
+    # Copy $hash to clipboard
     if [[ $OS == "Windows" || $OS == "WSL" || $OS == "WSL2" ]];then
       echo -n "$hash" | clip.exe
     elif [[ $OS == "Mac" ]];then
       echo -n "$hash" | pbcopy
+    elif [ -n "$WAYLAND_DISPLAY" ]; then
+      # Wayland
+      if ! command -v wl-copy &> /dev/null; then
+          echo -e "You need to install 'wl-copy' to send bigger filePathsUnix from cli"
+          echo "Try: sudo apt install wl-clipboard"
+          exit 1
+      fi
+      # Workaround to prevent use of Pipe which has a max letter limit
+      echo -n "$hash" > /tmp/pairdrop-cli-temp/pairdrop_hash_temp
+      wl-copy < /tmp/pairdrop-cli-temp/pairdrop_hash_temp
+      rm /tmp/pairdrop-cli-temp/pairdrop_hash_temp
     else
-      (echo -n "$hash" | xclip) || echo "You need to install xclip for sending bigger files from cli"
+      # X11
+      if ! command -v xclip &> /dev/null; then
+          echo -e "You need to install 'xclip' to send bigger filePathsUnix from cli"
+          echo "Try: sudo apt install xclip"
+          exit 1
+      fi
+      echo -n "$hash" | xclip -sel c
     fi
     hash=
   fi
 
-
   openPairDrop
   exit
 }
@@ -165,31 +323,35 @@ sendFiles()
 # Main program                                             #
 ############################################################
 ############################################################
-SCRIPTPATH="$( cd -- "$(dirname "$0")" >/dev/null 2>&1 ; pwd -P )"
+script_path="$( cd -- "$(dirname "$0")" >/dev/null 2>&1 ; pwd -P )"
 
 pushd . > '/dev/null';
-SCRIPTPATH="${BASH_SOURCE[0]:-$0}";
+script_path="${BASH_SOURCE[0]:-$0}";
 
-while [ -h "$SCRIPTPATH" ];
+while [ -h "$script_path" ];
 do
-    cd "$( dirname -- "$SCRIPTPATH"; )";
-    SCRIPTPATH="$( readlink -f -- "$SCRIPTPATH"; )";
+  cd "$( dirname -- "$script_path"; )";
+  script_path="$( readlink -f -- "$script_path"; )";
 done
 
-cd "$( dirname -- "$SCRIPTPATH"; )" > '/dev/null';
-SCRIPTPATH="$( pwd; )";
+cd "$( dirname -- "$script_path"; )" > '/dev/null';
+script_path="$( pwd; )";
 popd  > '/dev/null';
 
-CONFIGPATH="${SCRIPTPATH}/.pairdrop-cli-config"
+config_path="${script_path}/.pairdrop-cli-config"
 
-[ ! -f "$CONFIGPATH" ] &&
- specifyDomain "https://pairdrop.net/" &&
- [ ! -f "$CONFIGPATH" ] &&
- echo "Could not create config file. Add 'DOMAIN=https://pairdrop.net/' to a file called .pairdrop-cli-config in the same file as this 'pairdrop' bash file"
+# If config file does not exist, try to create it. If it fails log error message and exit
+[ ! -f "$config_path" ] &&
+  specifyDomain "https://pairdrop.net/" &&
+  [ ! -f "$config_path" ] &&
+  echo "Could not create config file. Add 'DOMAIN=https://pairdrop.net/' to a file called .pairdrop-cli-config in the same file as this 'pairdrop' bash file (${script_path})" &&
+  exit
 
-[ ! -f "$CONFIGPATH" ] || export "$(grep -v '^#' "$CONFIGPATH" | xargs)"
+# Read config variables
+export "$(grep -v '^#' "$config_path" | xargs)"
 
 setOs
+
 ############################################################
 # Process the input options. Add options as needed.        #
 ############################################################
@@ -198,24 +360,23 @@ setOs
 [[ $# -eq 0 ]] && openPairDrop && exit
 
 #  display help and exit if first argument is "--help" or more than 2 arguments are given
-[ "$1" == "--help" ] || [[ $# -gt 2 ]] && help && exit
+[ "$1" == "--help" ] && help && exit
 
 while getopts "d:ht:*" option; do
-    case $option in
-      d) # specify domain
-        specifyDomain "$2"
-        exit;;
-      t) # Send text
-        sendText
-        exit;;
-      h | ?) # display help and exit
-        help
-        exit;;
-      esac
+  case $option in
+    d) # specify domain - show help and exit if too many arguments
+      [[ $# -gt 2 ]] && help && exit
+      specifyDomain "$2"
+      exit;;
+    t) # Send text - show help and exit if too many arguments
+      [[ $# -gt 2 ]] && help && exit
+      sendText
+      exit;;
+    h | ?) # display help and exit
+      help
+      exit;;
+    esac
 done
 
 # Send file(s)
-# display help and exit if 2 arguments are given or if file does not exist
-[[ $# -eq 2 ]] || [[ ! -a $1 ]] && help && exit
-
-sendFiles "$1"
+sendFiles "$@"

pairdrop-cli/pairdrop.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+parent_path=$( cd "$(dirname "${BASH_SOURCE[0]}")" || exit ; pwd -P )
+
+cd "$parent_path" || exit
+
+./pairdrop "$@"

pairdrop-cli/send-with-pairdrop

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# Initialize an array
+lines=()
+
+# Read each line into the array
+while IFS= read -r line; do
+    lines+=("$line")
+done <<< "$NAUTILUS_SCRIPT_SELECTED_FILE_PATHS"
+
+# Get the length of the array
+length=${#lines[@]}
+
+# Remove the last entry
+unset 'lines[length-1]'
+
+pairdrop "${lines[@]}"

pairdrop-cli/send-with-pairdrop.ps1

@@ -0,0 +1,3 @@
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+& "$scriptDir\pairdrop.sh" $args

public/fonts/OpenSans/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Open Sans Project Authors (https://github.com/googlefonts/opensans)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

public/fonts/OpenSans/README.txt

@@ -0,0 +1,100 @@
+Open Sans Variable Font
+=======================
+
+This download contains Open Sans as both variable fonts and static fonts.
+
+Open Sans is a variable font with these axes:
+  wdth
+  wght
+
+This means all the styles are contained in these files:
+  OpenSans-VariableFont_wdth,wght.ttf
+  OpenSans-Italic-VariableFont_wdth,wght.ttf
+
+If your app fully supports variable fonts, you can now pick intermediate styles
+that aren’t available as static fonts. Not all apps support variable fonts, and
+in those cases you can use the static font files for Open Sans:
+  static/OpenSans_Condensed-Light.ttf
+  static/OpenSans_Condensed-Regular.ttf
+  static/OpenSans_Condensed-Medium.ttf
+  static/OpenSans_Condensed-SemiBold.ttf
+  static/OpenSans_Condensed-Bold.ttf
+  static/OpenSans_Condensed-ExtraBold.ttf
+  static/OpenSans_SemiCondensed-Light.ttf
+  static/OpenSans_SemiCondensed-Regular.ttf
+  static/OpenSans_SemiCondensed-Medium.ttf
+  static/OpenSans_SemiCondensed-SemiBold.ttf
+  static/OpenSans_SemiCondensed-Bold.ttf
+  static/OpenSans_SemiCondensed-ExtraBold.ttf
+  static/OpenSans-Light.ttf
+  static/OpenSans-Regular.ttf
+  static/OpenSans-Medium.ttf
+  static/OpenSans-SemiBold.ttf
+  static/OpenSans-Bold.ttf
+  static/OpenSans-ExtraBold.ttf
+  static/OpenSans_Condensed-LightItalic.ttf
+  static/OpenSans_Condensed-Italic.ttf
+  static/OpenSans_Condensed-MediumItalic.ttf
+  static/OpenSans_Condensed-SemiBoldItalic.ttf
+  static/OpenSans_Condensed-BoldItalic.ttf
+  static/OpenSans_Condensed-ExtraBoldItalic.ttf
+  static/OpenSans_SemiCondensed-LightItalic.ttf
+  static/OpenSans_SemiCondensed-Italic.ttf
+  static/OpenSans_SemiCondensed-MediumItalic.ttf
+  static/OpenSans_SemiCondensed-SemiBoldItalic.ttf
+  static/OpenSans_SemiCondensed-BoldItalic.ttf
+  static/OpenSans_SemiCondensed-ExtraBoldItalic.ttf
+  static/OpenSans-LightItalic.ttf
+  static/OpenSans-Italic.ttf
+  static/OpenSans-MediumItalic.ttf
+  static/OpenSans-SemiBoldItalic.ttf
+  static/OpenSans-BoldItalic.ttf
+  static/OpenSans-ExtraBoldItalic.ttf
+
+Get started
+-----------
+
+1. Install the font files you want to use
+
+2. Use your app's font picker to view the font family and all the
+available styles
+
+Learn more about variable fonts
+-------------------------------
+
+  https://developers.google.com/web/fundamentals/design-and-ux/typography/variable-fonts
+  https://variablefonts.typenetwork.com
+  https://medium.com/variable-fonts
+
+In desktop apps
+
+  https://theblog.adobe.com/can-variable-fonts-illustrator-cc
+  https://helpx.adobe.com/nz/photoshop/using/fonts.html#variable_fonts
+
+Online
+
+  https://developers.google.com/fonts/docs/getting_started
+  https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Fonts/Variable_Fonts_Guide
+  https://developer.microsoft.com/en-us/microsoft-edge/testdrive/demos/variable-fonts
+
+Installing fonts
+
+  MacOS: https://support.apple.com/en-us/HT201749
+  Linux: https://www.google.com/search?q=how+to+install+a+font+on+gnu%2Blinux
+  Windows: https://support.microsoft.com/en-us/help/314960/how-to-install-or-remove-a-font-in-windows
+
+Android Apps
+
+  https://developers.google.com/fonts/docs/android
+  https://developer.android.com/guide/topics/ui/look-and-feel/downloadable-fonts
+
+License
+-------
+Please read the full license text (OFL.txt) to understand the permissions,
+restrictions and requirements for usage, redistribution, and modification.
+
+You can use them in your products & projects – print or digital,
+commercial or otherwise.
+
+This isn't legal advice, please consider consulting a lawyer and see the full
+license for all details.

public/lang/ar.json

@@ -0,0 +1,184 @@
+{
+    "footer": {
+        "webrtc": "إذا لم يكن WebRTC متاحًا.",
+        "public-room-devices_title": "يمكن اكتشافك بواسطة الأجهزة الموجودة في هذه الغرفة العامة المستقلة عن الشبكة.",
+        "display-name_data-placeholder": "تحميل …",
+        "display-name_title": "قم بتحرير اسم جهازك بشكل دائم",
+        "traffic": "حركة المرور هي",
+        "paired-devices_title": "يمكن اكتشافك بواسطة الأجهزة المقترنة في جميع الأوقات بشكل مستقل عن الشبكة.",
+        "public-room-devices": "في الغرفة {{roomId}}",
+        "paired-devices": "بواسطة الأجهزة المقترنة",
+        "on-this-network": "على هذه الشبكة",
+        "routed": "توجيهّا من خلال الخادم",
+        "discovery": "يمكنك اكتشافك:",
+        "on-this-network_title": "يمكن للجميع اكتشافك على هذه الشبكة.",
+        "known-as": "‌أنت معروف بأنك:"
+    },
+    "notifications": {
+        "request-title": "يرغب {{name}} في نقل {{count}} {{descriptor}}",
+        "unfinished-transfers-warning": "هناك تحويلات غير مكتملة. هل أنت متأكد أنك تريد إغلاق PairDrop؟",
+        "message-received": "تم استلام الرسالة بواسطة {{name}} - انقر للفتح",
+        "rate-limit-join-key": "تم الوصول إلى الحد الأقصى. انتظر 10 ثوان وحاول مرة أخرى.",
+        "connecting": "يتصل …",
+        "pairing-key-invalidated": "المفتاح {{key}} خاطئ",
+        "pairing-key-invalid": "مُفتاح خاطئ",
+        "connected": "متصل",
+        "pairing-not-persistent": "الأجهزة المقترنة ليست ثابتة",
+        "text-content-incorrect": "محتوى النص غير صحيح",
+        "message-transfer-completed": "اكتمل نقل الرسالة",
+        "file-transfer-completed": "اكتمل نقل الملف",
+        "file-content-incorrect": "محتوى الملف غير صحيح",
+        "files-incorrect": "الملفات غير صحيحة",
+        "selected-peer-left": "مُحَدد الاجهزة المقترنة",
+        "link-received": "تم استلام الرابط بواسطة {{name}} - انقر للفتح",
+        "online": "لقد عدت متصلاً بالإنترنت",
+        "public-room-left": "الخروج من الغرفة العامة {{publicRoomId}}",
+        "copied-text": "نُسِخَ النص إلى الحافظة",
+        "display-name-random-again": "يتم إنشاء اسم العرض بشكل عشوائي مرة أخرى",
+        "display-name-changed-permanently": "يتم تغيير اسم العرض بشكل دائم",
+        "copied-to-clipboard-error": "النسخ غير ممكن. انسخ يدويًا.",
+        "pairing-success": "الأجهزة المقترنة",
+        "clipboard-content-incorrect": "محتوى الحافظة غير صحيح",
+        "display-name-changed-temporarily": "تم تغيير اسم العرض لهذه الجلسة فقط",
+        "copied-to-clipboard": "تم النسخ إلى الحافظة",
+        "offline": "انت غير متصل",
+        "pairing-tabs-error": "من المستحيل إقران علامتي تبويب متصفح الويب",
+        "public-room-id-invalid": "معرف الغرفة غير صالح",
+        "click-to-download": "إضغط للتحميل",
+        "pairing-cleared": "جميع الأجهزة غير مقترنة",
+        "notifications-enabled": "تم تمكين الإشعارات",
+        "online-requirement-pairing": "يجب أن تكون متصلاً بالإنترنت لإقران الأجهزة",
+        "ios-memory-limit": "لا يمكن إرسال ملفات إلى iOS إلا بحجم يصل إلى 200 ميجابايت مرة واحدة",
+        "online-requirement-public-room": "يجب أن تكون متصلاً بالإنترنت لإنشاء غرفة عامة",
+        "copied-text-error": "فشلت الكتابة من الحافظة. انسخ يدويًا!",
+        "download-successful": "تم تحميل {{descriptor}}",
+        "click-to-show": "اضغط للعرض",
+        "pair-url-copied-to-clipboard": "تم نسخ رابط اقتران هذا الجهاز إلى الحافظة",
+        "room-url-copied-to-clipboard": "تم نسخ رابط هذه الغرفة العامة إلى الحافظة",
+        "notifications-permissions-error": "لم يتم منح إذن الإشعارات حيث أن المستخدم أغلق نافذة السماح عدة مرات. يمكن إعادة تعيين هذا في معلومات الصفحة التي يمكن فتحها بالضغط على رمز القفل بجانب شريط عنوان صفحة الإنترنت."
+    },
+    "header": {
+        "cancel-share-mode": "تمّ",
+        "theme-auto_title": "تغيير المظهر تلقائيا من النظام",
+        "install_title": "تثبيت PairDrop",
+        "theme-dark_title": "إستخدم دائما المظهر المظلم",
+        "pair-device_title": "قم بإقران أجهزتك بشكل دائم",
+        "join-public-room_title": "انضم إلى الغرفة العامة مؤقتًا",
+        "notification_title": "تفعيل الإشعارات",
+        "edit-paired-devices_title": "عدل الأجهزة المقترنة",
+        "language-selector_title": "إختر اللغة",
+        "about_title": "حول PairDrop",
+        "about_aria-label": "افتح حول PairDrop",
+        "theme-light_title": "إستخدم دائماً المظهر الفاتح",
+        "edit-share-mode": "عدل",
+        "expand_title": "Expand header button row"
+    },
+    "instructions": {
+        "x-instructions_mobile": "انقر لإرسال الملفات أو انقر لفترة طويلة لإرسال رسالة",
+        "x-instructions-share-mode_desktop": "انقر للإرسال {{descriptor}}",
+        "activate-share-mode-and-other-files-plural": "و{{count}} ملفات أخرى",
+        "x-instructions-share-mode_mobile": "انقر للإرسال {{descriptor}}",
+        "activate-share-mode-base": "افتح PairDrop على الأجهزة الأخرى للإرسال",
+        "no-peers-subtitle": "قم بإقران الأجهزة أو ادخل إلى غرفة عامة لتتمكن من أن تكتشف على الشبكات الأخرى",
+        "activate-share-mode-shared-text": "النص المشترك",
+        "x-instructions_desktop": "انقر لإرسال الملفات أو انقر بزر الفأرة الأيمن لإرسال رسالة",
+        "no-peers-title": "افتح PairDrop على الأجهزة الأخرى لإرسال الملفات",
+        "x-instructions_data-drop-bg": "حرر لتحديد المستلم",
+        "no-peers_data-drop-bg": "حرر لتحديد المستلم",
+        "x-instructions_data-drop-peer": "قم بالتحرير لإرسالها إلى القرين",
+        "activate-share-mode-and-other-file": "وملف واحد آخر",
+        "activate-share-mode-shared-files-plural": "{{count}} ملفات مشاركة",
+        "activate-share-mode-shared-file": "الملف المُشارك",
+        "webrtc-requirement": "لتستعمل بيردروب هنا، يجب أن يكون WebRTC مفعلًا!"
+    },
+    "peer-ui": {
+        "processing": "مُعالجة …",
+        "click-to-send-share-mode": "انقر للإرسال {{descriptor}}",
+        "click-to-send": "انقر لإرسال الملفات أو انقر بزر الماوس الأيمن لإرسال رسالة",
+        "waiting": "يُرجى الإنتظار…",
+        "connection-hash": "للتحقق من أمان التشفير الشامل، قم بمقارنة رقم الأمان هذا على كلا الجهازين",
+        "preparing": "يقترن…",
+        "transferring": "جارٍ النقل…"
+    },
+    "dialogs": {
+        "base64-paste-to-send": "الصق هنا للمشاركة {{type}}",
+        "auto-accept-instructions-2": "لقبول جميع الملفات المرسلة من هذا الجهاز تلقائيًا.",
+        "receive-text-title": "تلقيت رسالة",
+        "edit-paired-devices-title": "تحرير الأجهزة المقترنة",
+        "cancel": "إلغاء",
+        "auto-accept-instructions-1": "تفعيل",
+        "pair-devices-title": "إقران الأجهزة بشكل دائم",
+        "download": "تحميل",
+        "title-file": "ملف",
+        "base64-processing": "مُعالجة…",
+        "decline": "رفض",
+        "receive-title": "تم استلام {{descriptor}}",
+        "leave": "مُغادرة",
+        "join": "انضمام",
+        "title-image-plural": "صور",
+        "send": "ارسال",
+        "base64-tap-to-paste": "انقر هنا للمشاركة {{type}}",
+        "base64-text": "نص",
+        "copy": "نسخ",
+        "file-other-description-image": "وصورة واحدة أخرى",
+        "temporary-public-room-title": "غرفة عامة مؤقتة",
+        "base64-files": "ملفات",
+        "has-sent": "ارسلت:",
+        "file-other-description-file": "وملف واحد آخر",
+        "close": "إغلاق",
+        "system-language": "لغة النظام",
+        "unpair": "إلغاء الإقتران",
+        "title-image": "صورة",
+        "file-other-description-file-plural": "و{{count}} ملفات أخرى",
+        "would-like-to-share": "ترغب في المشاركة",
+        "send-message-to": "أرسال رسالة إلى:",
+        "language-selector-title": "إختر اللُغة",
+        "pair": "إقتران",
+        "hr-or": "او",
+        "scan-qr-code": "أو مسح رمز الاستجابة السريعة.",
+        "input-key-on-this-device": "أدخل هذا المفتاح على جهاز آخر",
+        "download-again": "تحميل مرة أخرى",
+        "accept": "قبول",
+        "paired-devices-wrapper_data-empty": "لا توجد أجهزة مقترنة.",
+        "enter-key-from-another-device": "أدخل المفتاح من جهاز آخر هنا.",
+        "share": "مُشاركة",
+        "auto-accept": "قبول تلقائي",
+        "title-file-plural": "ملفات",
+        "send-message-title": "إرسال رسالة",
+        "input-room-id-on-another-device": "‌أدخل معرف الغرفة هذا على جهاز آخر",
+        "file-other-description-image-plural": "و{{count}} صور أخرى",
+        "enter-room-id-from-another-device": "أدخل معرف الغرفة من جهاز آخر للانضمام إلى الغرفة.",
+        "share-text-title": "شارك رسالة نصية",
+        "paired-device-removed": "تمت إزالة الجهاز المقترن.",
+        "message_title": "أدخل رسالة لإرسالها",
+        "message_placeholder": "النص",
+        "base64-title-files": "شارك ملفات",
+        "base64-title-text": "شارك نصًا",
+        "public-room-qr-code_title": "اضغط لنسخ رابط الغرفة العامة",
+        "approve": "قبول",
+        "share-text-subtitle": "عدل الرسالة قبل الإرسال:",
+        "share-text-checkbox": "أظهر هذه الرسالة دائمًا عند مشاركة النصوص",
+        "close-toast_title": "أغلق الإشعار",
+        "pair-devices-qr-code_title": "اضغط لنسخ رابط اقتران هذا الجهاز"
+    },
+    "about": {
+        "claim": "أسهل طريقة لنقل الملفات عبر الأجهزة",
+        "tweet_title": "غرّد حول PairDrop",
+        "close-about_aria-label": "إغلاق حول PairDrop",
+        "buy-me-a-coffee_title": "اشتري لي القهوة!",
+        "github_title": "PairDrop على جيت هاب",
+        "faq_title": "أسئلة متكررة",
+        "mastodon_title": "اكتب عن بيردروب على ماستادون",
+        "bluesky_title": "تابعنا على بلوسكاي",
+        "custom_title": "تابعنا",
+        "privacypolicy_title": "افتح سياسة الخصوصية الخاصة بنا"
+    },
+    "document-titles": {
+        "file-transfer-requested": "طلب نقل الملف",
+        "message-received-plural": "{{count}} الرسائل المستلمة",
+        "message-received": "تم إرسال الرسالة",
+        "file-received": "تم استلام الملف",
+        "file-received-plural": "{{count}} الملفات المستلمة",
+        "image-transfer-requested": "طُلب نقل الصور المطلوبة"
+    }
+}

public/lang/be.json

@@ -0,0 +1,184 @@
+{
+    "header": {
+        "about_aria-label": "Адкрыйце Аб PairDrop",
+        "about_title": "Аб PairDrop",
+        "theme-auto_title": "Аўтаматычная адаптацыя тэмы да сістэмы",
+        "theme-light_title": "Заўсёды выкарыстоўваць светлую тэму",
+        "theme-dark_title": "Заўсёды выкарыстоўваць цёмную тэму",
+        "notification_title": "Уключыць апавяшчэнні",
+        "edit-paired-devices_title": "Рэдагаваць злучаныя прылады",
+        "join-public-room_title": "Часова далучыцца да публічнага пакоя",
+        "cancel-share-mode": "Адмяніць",
+        "language-selector_title": "Задаць мову",
+        "install_title": "Усталяваць PairDrop",
+        "pair-device_title": "Злучыце свае прылады назаўжды",
+        "edit-share-mode": "Рэдагаваць",
+        "expand_title": "Разгарнуць радок кнопак"
+    },
+    "instructions": {
+        "no-peers_data-drop-bg": "Адпусціце, каб выбраць атрымальніка",
+        "no-peers-title": "Адкрыйце PairDrop на іншых прыладах, каб адправіць файлы",
+        "x-instructions_data-drop-peer": "Адпусціце, каб адправіць вузлу",
+        "x-instructions_data-drop-bg": "Адпусціце, каб выбраць атрымальніка",
+        "x-instructions-share-mode_mobile": "Дакраніцеся, каб адправіць {{descriptor}}",
+        "activate-share-mode-and-other-file": "і 1 іньшы файл",
+        "activate-share-mode-and-other-files-plural": "і {{count}} іньшых файла(ў)",
+        "activate-share-mode-shared-text": "агульны тэкст",
+        "activate-share-mode-shared-files-plural": "{{count}} агульных файлаў",
+        "webrtc-requirement": "Каб выкарыстоўваць гэты асобнік Pair Drop, WebRTC павінен быць уключаны!",
+        "no-peers-subtitle": "Злучыце прылады або ўвайдзіце ў публічны пакой, каб вас маглі выявіць з іншых сетак",
+        "x-instructions_mobile": "Дакраніцеся, каб адправіць файлы, або доўга трымайце, каб адправіць паведамленне",
+        "x-instructions-share-mode_desktop": "Націсніце, каб адправіць {{descriptor}}",
+        "x-instructions_desktop": "Націсніце, каб адправіць файлы, або націсніце правай кнопкай мышы, каб адправіць паведамленне",
+        "activate-share-mode-base": "Адкрыйце PairDrop на іншых прыладах, каб адправіць",
+        "activate-share-mode-shared-file": "агульны файл"
+    },
+    "footer": {
+        "known-as": "Вы вядомыя як:",
+        "display-name_data-placeholder": "Загрузка…",
+        "discovery": "Вас могуць выявіць:",
+        "on-this-network_title": "Вас можа знайсці кожны ў гэтай сетцы.",
+        "paired-devices": "з дапамогай злучаных прылад",
+        "public-room-devices_title": "Вас могуць выявіць прылады ў гэтай публічнай пакоі незалежна ад сеткі.",
+        "traffic": "Рух",
+        "display-name_title": "Зменіце назву сваёй прылады назаўжды",
+        "on-this-network": "у гэтай сетцы",
+        "paired-devices_title": "Злучаныя прылады заўсёды могуць вас выявіць незалежна ад сеткі.",
+        "public-room-devices": "у пакоі {{roomId}}",
+        "webrtc": ", калі WebRTC недаступны.",
+        "routed": "накіроўваецца праз сервер"
+    },
+    "dialogs": {
+        "hr-or": "АБО",
+        "cancel": "Адмяніць",
+        "pair": "Злучыць",
+        "unpair": "Разлучыць",
+        "paired-devices-wrapper_data-empty": "Няма злучаных прылад.",
+        "auto-accept": "аўтаматычнае прыняцце",
+        "close": "Закрыць",
+        "join": "Далучыцца",
+        "leave": "Пакінуць",
+        "decline": "Адмовіць",
+        "share": "Падзяліцца",
+        "copy": "Капіяваць",
+        "title-image": "Малюнак",
+        "system-language": "Мова сістэмы",
+        "public-room-qr-code_title": "Націсніце, каб скапіяваць спасылку на публічны пакой",
+        "title-file": "Файл",
+        "title-file-plural": "Файлы",
+        "message_placeholder": "Тэкст",
+        "language-selector-title": "Задаць мову",
+        "send-message-title": "Адправіць паведамленне",
+        "scan-qr-code": "або сканаваць QR-код.",
+        "enter-room-id-from-another-device": "Увядзіце ID пакоя з іншай прылады, каб далучыцца да пакоя.",
+        "edit-paired-devices-title": "Рэдагаваць злучаныя прылады",
+        "auto-accept-instructions-1": "Актываваць",
+        "auto-accept-instructions-2": ", каб аўтаматычна прымаць усе файлы, адпраўленыя з гэтай прылады.",
+        "accept": "Прыняць",
+        "download": "Спампаваць",
+        "download-again": "Спампаваць яшчэ раз",
+        "pair-devices-qr-code_title": "Націсніце, каб скапіраваць спасылку для спалучэння гэтай прылады",
+        "approve": "сцвердзіць",
+        "pair-devices-title": "Пастаяннае злучэнне прылад",
+        "enter-key-from-another-device": "Увядзіце тут ключ з іншай прылады.",
+        "temporary-public-room-title": "Часовы публічны пакой",
+        "input-room-id-on-another-device": "Увядзіце гэты ID пакоя на іншай прыладзе",
+        "paired-device-removed": "Злучаная прылада была выдалена.",
+        "would-like-to-share": "хацеў бы падзяліцца",
+        "send-message-to": "Каму:",
+        "message_title": "Устаўце паведамленне для адпраўкі",
+        "has-sent": "адправіў:",
+        "base64-processing": "Апрацоўка…",
+        "send": "Адправіць",
+        "base64-title-text": "Падзяліцца тэкстам",
+        "base64-title-files": "Падзяліцца файламі",
+        "base64-tap-to-paste": "Дакраніцеся тут, каб падзяліцца {{type}}",
+        "file-other-description-image": "і 1 іньшы малюнак",
+        "file-other-description-image-plural": "і {{count}} іншых малюнкаў",
+        "file-other-description-file-plural": "і {{count}} іншых файлаў",
+        "title-image-plural": "Малюнкі",
+        "share-text-subtitle": "Рэдагаваць паведамленне перад адпраўкай:",
+        "share-text-title": "Падзяліцца тэкставым паведамленнем",
+        "close-toast_title": "Закрыць апавяшчэнне",
+        "receive-text-title": "Паведамленне атрымана",
+        "input-key-on-this-device": "Увядзіце гэты ключ на іншай прыладзе",
+        "base64-files": "файлы",
+        "base64-text": "тэкст",
+        "base64-paste-to-send": "Устаўце сюды буфер абмену, каб падзяліцца {{type}}",
+        "file-other-description-file": "і 1 іньшы файл",
+        "receive-title": "{{descriptor}} атрымана",
+        "share-text-checkbox": "Заўсёды паказваць гэта дыялогавае акно пры абагульванні тэксту"
+    },
+    "about": {
+        "buy-me-a-coffee_title": "Купіць мне кавы!",
+        "mastodon_title": "Напішыце пра PairDrop на Mastodon",
+        "tweet_title": "Твіт пра PairDrop",
+        "github_title": "PairDrop на GitHub",
+        "custom_title": "Сачыце за намі",
+        "bluesky_title": "Сачыце за намі на BlueSky",
+        "faq_title": "Часта задаюць пытанні",
+        "close-about_aria-label": "Закрыць Аб PairDrop",
+        "claim": "Самы просты спосаб перадачы файлаў паміж прыладамі",
+        "privacypolicy_title": "Адкрыйце нашу палітыку прыватнасці"
+    },
+    "notifications": {
+        "link-received": "Спасылка атрымана {{name}} - Націсніце, каб адкрыць",
+        "message-received": "Паведамленне атрымана {{name}} - Націсніце, каб скапіяваць",
+        "click-to-download": "Націсніце, каб спампаваць",
+        "click-to-show": "Націсніце, каб паказаць",
+        "copied-text-error": "Памылка запісу ў буфер абмену. Скапіруйце ўручную!",
+        "online": "Вы зноў у сетцы",
+        "online-requirement-public-room": "Вы павінны быць падлучаныя да сеткі, каб стварыць агульны пакой",
+        "connecting": "Падключэнне…",
+        "public-room-id-invalid": "Несапраўдны ID пакоя",
+        "notifications-permissions-error": "Дазвол на апавяшчэнні быў заблакіраваны, бо карыстальнік некалькі разоў адхіляў запыт на дазвол. Гэта можна скінуць у меню \"Аб старонцы\", доступ да якой можна атрымаць, націснуўшы на значок замка побач з радком URL.",
+        "request-title": "{{name}} хоча перадаць {{count}} {{descriptor}}",
+        "copied-text": "Тэкст скапіраваны ў буфер абмену",
+        "offline": "Вы па-за сеткай",
+        "connected": "Падключана",
+        "online-requirement-pairing": "Вы павінны быць падлучаныя да сеткі для спалучэння прылад",
+        "pairing-key-invalidated": "Ключ {{key}} несапраўдны",
+        "display-name-random-again": "Адлюстраванае імя зноў згенеравалася выпадковым чынам",
+        "download-successful": "{{descriptor}} спампавана",
+        "pairing-tabs-error": "Злучэнне дзвюх укладак вэб-браўзера немагчыма",
+        "display-name-changed-permanently": "Адлюстроўванае імя было зменена назаўжды",
+        "pairing-cleared": "Усе прылады раз'яднаны",
+        "room-url-copied-to-clipboard": "Спасылка на публічны пакой скапіравана ў буфер абмену",
+        "public-room-left": "Пакінуць публічны пакой {{publicRoomId}}",
+        "text-content-incorrect": "Змест тэксту няправільны",
+        "clipboard-content-incorrect": "Змест буфера абмену няправільны",
+        "notifications-enabled": "Апавяшчэнні ўключаны",
+        "files-incorrect": "Няправільныя файлы",
+        "file-transfer-completed": "Перадача файла завершана",
+        "selected-peer-left": "Выбраны вузел выйшаў",
+        "copied-to-clipboard": "Скапіравана ў буфер абмену",
+        "pair-url-copied-to-clipboard": "Спасылка для злучэння гэтай прылады скапіравана ў буфер абмену",
+        "pairing-success": "Злучаныя прылады",
+        "copied-to-clipboard-error": "Капіраванне немагчымае. Скапіруйце ўручную.",
+        "file-content-incorrect": "Змест файла няправільны",
+        "pairing-not-persistent": "Злучаныя прылады не з'яўляюцца пастаяннымі",
+        "pairing-key-invalid": "Несапраўдны ключ",
+        "display-name-changed-temporarily": "Адлюстраванае імя зменена толькі для гэтага сеансу",
+        "ios-memory-limit": "Адначасовая адпраўка файлаў на iOS магчымая толькі да 200 МБ",
+        "message-transfer-completed": "Перадача паведамлення завершана",
+        "unfinished-transfers-warning": "Ёсць незавершаныя перадачы. Вы ўпэўнены, што хочаце закрыць PairDrop?",
+        "rate-limit-join-key": "Ліміт хуткасці дасягнуты. Пачакайце 10 секунд і паўтарыце спробу."
+    },
+    "peer-ui": {
+        "preparing": "Падрыхтоўка…",
+        "waiting": "Чаканне…",
+        "transferring": "Перадача…",
+        "processing": "Апрацоўка…",
+        "click-to-send-share-mode": "Націсніце, каб адправіць {{descriptor}}",
+        "connection-hash": "Каб праверыць бяспеку скразнога шыфравання, параўнайце гэты нумар бяспекі на абедзвюх прыладах",
+        "click-to-send": "Націсніце, каб адправіць файлы, або націсніце правай кнопкай мышы, каб адправіць паведамленне"
+    },
+    "document-titles": {
+        "file-received": "Файл атрыманы",
+        "image-transfer-requested": "Запытана перадача малюнкаў",
+        "message-received": "Паведамленне атрымана",
+        "message-received-plural": "Атрымана {{count}} паведамленняў",
+        "file-received-plural": "Атрымана {{count}} файлаў",
+        "file-transfer-requested": "Запытана перадача файла"
+    }
+}

public/lang/bg.json

@@ -0,0 +1,184 @@
+{
+    "header": {
+        "about_title": "Относно PairDrop",
+        "language-selector_title": "Задай език",
+        "about_aria-label": "Отвори Относно PairDrop",
+        "theme-auto_title": "Адаптирай темата спрямо системните настройки",
+        "theme-light_title": "Винаги използвай светла тема",
+        "notification_title": "Включи известията",
+        "pair-device_title": "Свържи устройствата си перманентно",
+        "join-public-room_title": "Присъедини се към временна публична стая",
+        "cancel-share-mode": "Отказ",
+        "expand_title": "Покажи меню",
+        "theme-dark_title": "Винаги използвай тъмна тема",
+        "install_title": "Инсталирай PairDrop",
+        "edit-paired-devices_title": "Промени свързаните устройства",
+        "edit-share-mode": "Промени"
+    },
+    "instructions": {
+        "no-peers_data-drop-bg": "Пусни, за да избереш получател",
+        "no-peers-title": "Отвори PairDrop на друго устройство, за да започнеш споделяне",
+        "no-peers-subtitle": "Свържи устройство или влез в публична стая, за да станеш откриваем за други мрежи",
+        "x-instructions_desktop": "Ляв клик, за да изпратиш файл или десен клик, за да изпратиш съобщение",
+        "x-instructions_data-drop-peer": "Пусни, за да изпратиш",
+        "x-instructions-share-mode_desktop": "Натисни, за да изпратиш {{descriptor}}",
+        "activate-share-mode-base": "Отвори PairDrop на друго устройство, за да изпратиш",
+        "activate-share-mode-and-other-file": "и още 1 файл",
+        "activate-share-mode-and-other-files-plural": "и още {{count}} файла",
+        "activate-share-mode-shared-text": "споделен текст",
+        "activate-share-mode-shared-files-plural": "{{count}} споделени файлове",
+        "x-instructions_data-drop-bg": "Пусни, за да избереш получател",
+        "activate-share-mode-shared-file": "споделен файл",
+        "x-instructions_mobile": "Докосни, за да изпратиш файл или задръж, за да изпратиш съобщение",
+        "x-instructions-share-mode_mobile": "Докосни, за да изпратиш {{descriptor}}",
+        "webrtc-requirement": "За да използвате инстанция на PairDrop, WebRTC трябва да бъде включен!"
+    },
+    "footer": {
+        "known-as": "Известни сте като:",
+        "display-name_data-placeholder": "Зареждане…",
+        "display-name_title": "Редактирайте името на вашето устройство за постоянно",
+        "discovery": "Може да бъдете открити:",
+        "on-this-network": "В тази мрежа",
+        "on-this-network_title": "Може да бъдете открити от всеки в тази мрежа.",
+        "paired-devices": "От свързани устройства",
+        "paired-devices_title": "Може да бъдете открити от свързани устройства по всяко време, независимо от мрежата.",
+        "public-room-devices": "в стая {{roomId}}",
+        "public-room-devices_title": "Може да бъдете открити от устройства в тази публична стая, независимо от мрежата.",
+        "traffic": "Трафикът е",
+        "routed": "пренасочен през сървъра",
+        "webrtc": "ако WebRTC не е наличен."
+    },
+    "dialogs": {
+        "pair-devices-title": "Свържете устройства за постоянно",
+        "input-key-on-this-device": "Въведете този ключ на друго устройство",
+        "scan-qr-code": "или сканирайте QR кода.",
+        "enter-key-from-another-device": "Въведете тук ключ от друго устройство.",
+        "input-room-id-on-another-device": "Въведете този ID за стая на друго устройство",
+        "hr-or": "ИЛИ",
+        "unpair": "Раздели",
+        "paired-device-removed": "Свързаното устройство беше премахнато.",
+        "paired-devices-wrapper_data-empty": "Няма свързани устройства.",
+        "auto-accept-instructions-1": "Активно",
+        "auto-accept": "автоматично приемане",
+        "auto-accept-instructions-2": "за автоматично приемане на всички файлове, изпратени от това устройство.",
+        "close": "Затвори",
+        "join": "Присъедини се",
+        "leave": "Напусни",
+        "would-like-to-share": "иска да сподели",
+        "has-sent": "изпрати:",
+        "share": "Сподели",
+        "download": "Изтегли",
+        "send-message-title": "Изпрати съобщение",
+        "send-message-to": "До:",
+        "message_title": "Въведете съобщението за изпращане",
+        "message_placeholder": "Текст",
+        "send": "Изпрати",
+        "receive-text-title": "Получено съобщение",
+        "copy": "Копиране",
+        "base64-title-files": "Споделяне на файлове",
+        "base64-title-text": "Споделяне на текст",
+        "base64-processing": "Обработва се…",
+        "base64-tap-to-paste": "Натиснете тук за да споделите {{type}}",
+        "base64-paste-to-send": "Поставете своя Клипборд тук за да споделите {{type}}",
+        "file-other-description-image": "и още една снимка",
+        "file-other-description-file": "и още един файл",
+        "file-other-description-image-plural": "и още {{count}} снимки",
+        "file-other-description-file-plural": "и още {{count}} файла",
+        "title-image": "снимка",
+        "title-image-plural": "Снимки",
+        "title-file-plural": "Файлове",
+        "receive-title": "{{descriptor}} Получено",
+        "download-again": "Изтегли отново",
+        "language-selector-title": "Изберете език",
+        "pair-devices-qr-code_title": "Кликнете, за да копирате линка за свързване на това устройство",
+        "approve": "одобри",
+        "share-text-title": "Сподели текстово съобщение",
+        "share-text-subtitle": "Редактирайте съобщението преди изпращане:",
+        "share-text-checkbox": "Винаги показвай този прозорец при споделяне на текст",
+        "accept": "Приеми",
+        "temporary-public-room-title": "Временна публична стая",
+        "enter-room-id-from-another-device": "Въведете ID на стая от друго устройство, за да се присъедините.",
+        "pair": "Свържи",
+        "cancel": "Отказ",
+        "edit-paired-devices-title": "Редактиране на свързани устройства",
+        "close-toast_title": "Затвори известието",
+        "decline": "Откажи",
+        "base64-text": "текст",
+        "base64-files": "файлове",
+        "title-file": "Файл",
+        "system-language": "Език на системата",
+        "public-room-qr-code_title": "Кликнете, за да копирате линка към публичната стая"
+    },
+    "about": {
+        "close-about_aria-label": "Затвори информацията за PairDrop",
+        "tweet_title": "Споделете PairDrop в X (Twitter)",
+        "mastodon_title": "Напишете за PairDrop в Mastodon",
+        "bluesky_title": "Последвайте ни в BlueSky",
+        "custom_title": "Последвайте ни",
+        "faq_title": "Често задавани въпроси",
+        "claim": "Най-лесният начин за прехвърляне на файлове между устройства",
+        "github_title": "PairDrop в GitHub",
+        "buy-me-a-coffee_title": "Купете ми кафе!",
+        "privacypolicy_title": "Отворете нашата политика за поверителност"
+    },
+    "notifications": {
+        "display-name-changed-permanently": "Името се променя постоянно",
+        "display-name-changed-temporarily": "Името се променя само за тази сесия",
+        "display-name-random-again": "Името отново е генерирано на случаен принцип",
+        "pairing-not-persistent": "Свързаните устройства не са постоянни",
+        "public-room-left": "Напуснахте публичната стая {{publicRoomId}}",
+        "copied-to-clipboard": "Копирано в клипборда",
+        "pair-url-copied-to-clipboard": "Линкът за свързване на това устройство е копиран в клипборда",
+        "room-url-copied-to-clipboard": "Линкът към публичната стая е копиран в клипборда",
+        "copied-to-clipboard-error": "Копирането не е възможно. Копирайте ръчно.",
+        "file-content-incorrect": "Съдържанието на файла е неправилно",
+        "clipboard-content-incorrect": "Съдържанието на клипборда е неправилно",
+        "link-received": "Линк, получен от {{name}} - Кликнете, за да отворите",
+        "message-received": "Съобщение, получено от {{name}} - Кликнете, за да копирате",
+        "click-to-download": "Кликнете, за да изтеглите",
+        "request-title": "{{name}} иска да прехвърли {{count}} {{descriptor}}",
+        "click-to-show": "Кликнете, за да покажете",
+        "copied-text": "Текстът е копиран в клипборда",
+        "copied-text-error": "Писането в клипборда не успя. Копирайте ръчно!",
+        "offline": "Вие сте офлайн",
+        "online": "Вие сте отново онлайн",
+        "connected": "Свързан",
+        "online-requirement-public-room": "Трябва да сте онлайн, за да създадете публична стая",
+        "files-incorrect": "Файловете са неправилни",
+        "unfinished-transfers-warning": "Има незавършени прехвърляния. Сигурни ли сте, че искате да затворите PairDrop?",
+        "selected-peer-left": "Избраният партньор напусна",
+        "pairing-tabs-error": "Свързването на два раздела в браузъра е невъзможно",
+        "pairing-success": "Устройства свързани",
+        "download-successful": "{{descriptor}} изтеглено",
+        "public-room-id-invalid": "Невалиден ID на стая",
+        "pairing-key-invalid": "Невалиден ключ",
+        "pairing-cleared": "Всички устройства са разделени",
+        "text-content-incorrect": "Текстовото съдържание е неправилно",
+        "notifications-enabled": "Известията са активирани",
+        "pairing-key-invalidated": "Ключът {{key}} е невалиден",
+        "notifications-permissions-error": "Разрешението за известия е блокирано, тъй като потребителят няколко пъти е отхвърлил подкана за разрешение. Това може да се нулира в информацията за страницата, която се достъпва чрез иконата с катинар до лентата за URL адрес.",
+        "online-requirement-pairing": "Трябва да сте онлайн, за да свържете устройства",
+        "connecting": "Свързване…",
+        "file-transfer-completed": "Прехвърлянето на файлове е завършено",
+        "rate-limit-join-key": "Достигнат е лимитът за заявки. Изчакайте 10 секунди и опитайте отново.",
+        "message-transfer-completed": "Прехвърлянето на съобщението е завършено",
+        "ios-memory-limit": "Изпращането на файлове към iOS е възможно само до 200 MB наведнъж"
+    },
+    "document-titles": {
+        "file-received": "Файлът е получен",
+        "file-received-plural": "{{count}} файла получени",
+        "file-transfer-requested": "Заявката за прехвърляне на файлове е изпратена",
+        "image-transfer-requested": "Заявката за прехвърляне на изображения е изпратена",
+        "message-received-plural": "{{count}} получени съобщения",
+        "message-received": "Получено съобщение"
+    },
+    "peer-ui": {
+        "click-to-send-share-mode": "Натисни, за да изпратиш {{descriptor}}",
+        "preparing": "Подготовка…",
+        "click-to-send": "Кликнете, за да изпратите файлове или кликнете с десен бутон, за да изпратите съобщение",
+        "connection-hash": "За да потвърдите сигурността на криптирането на връзката, сравнете този номер за сигурност с двете устройства",
+        "waiting": "Чакане…",
+        "processing": "Обработка…",
+        "transferring": "Прехвърляне…"
+    }
+}

public/lang/bn.json

@@ -0,0 +1,35 @@
+{
+    "header": {
+        "about_title": "পেয়ার ড্রপ সম্পর্কে",
+        "install_title": "পেয়ার ড্রপ ইন্সটল করুন",
+        "pair-device_title": "ডিভাইস স্থায়ী ভাবে যুক্ত করুন",
+        "cancel-share-mode": "বাতিল",
+        "theme-light_title": "সবসময় সাদা থিম ব্যাবহার",
+        "language-selector_title": "ভাষা সেট করুন",
+        "about_aria-label": "পেয়ারড্রপ সম্পর্কে",
+        "theme-auto_title": "থিমের ধরন ডিভাইস অনুযায়ী",
+        "theme-dark_title": "সবসময় কালো থিব ব্যাবহার",
+        "notification_title": "নোটিফিকেশন চালু করুন",
+        "edit-paired-devices_title": "যুক্ত ডিভাইস সম্পাদনা করুন",
+        "join-public-room_title": "সাময়িক ভাবে পাবলিক রুমে জয়েন করুন",
+        "edit-share-mode": "সম্পাদনা",
+        "expand_title": "হেডার বোতামের সারিটি বড় করুন"
+    },
+    "instructions": {
+        "activate-share-mode-and-other-file": "আর একটি ফাইল যোগ করুন",
+        "activate-share-mode-shared-file": "পাঠানো ফাইল",
+        "no-peers-subtitle": "ডিভাইস প্রদর্শিত হতে নতুন ডিভাইস যুক্ত করুন অথবা পাবলিক রুমে জয়েন দিন",
+        "no-peers-title": "ফাইল পাঠানোর জন্য অন্যান্য ডিভাইসে পেয়ারড্রপ খুলুন",
+        "x-instructions_data-drop-bg": "প্রাপক নির্বাচন করতে ছেড়ে দিন",
+        "no-peers_data-drop-bg": "প্রাপক নির্বাচন ছেড়ে দিন",
+        "x-instructions_desktop": "ফাইল পাঠাতে ক্লিক করুন অথবা মেসেজ পাঠাতে ডানে চাপুন",
+        "x-instructions_mobile": "ফাইল পাঠাতে ক্লিক করুন অথবা বেশি চেপে মেসেজ পাঠান",
+        "x-instructions_data-drop-peer": "পিয়ারকে পাঠানোর জন্য রিলিজ করুন",
+        "x-instructions-share-mode_desktop": "পাঠাতে ক্লিক করুন",
+        "x-instructions-share-mode_mobile": "পাঠাতে ক্লিক করুন",
+        "activate-share-mode-base": "অন্য ডিভাইসে পাঠাতে পেয়ারড্রপ খুলুন",
+        "activate-share-mode-and-other-files-plural": "অন্য ফাইল যোগ করুন",
+        "activate-share-mode-shared-text": "পাঠানো টেক্সট",
+        "activate-share-mode-shared-files-plural": "পাঠানো ফাইল গুলো"
+    }
+}

public/lang/ca.json

@@ -0,0 +1,184 @@
+{
+    "instructions": {
+        "x-instructions_mobile": "Toca per enviar fitxers o mantén premut per enviar un missatge",
+        "no-peers-subtitle": "Vincula dispositius o entra a una sala pública per ser detectable en altres xarxes",
+        "x-instructions_desktop": "Fes click per enviar fitxers o click dret per enviar un missatge de text",
+        "no-peers-title": "Obre PairDrop a altres dispositius per enviar arxius",
+        "x-instructions_data-drop-peer": "Allibera per enviar a un company",
+        "x-instructions_data-drop-bg": "Allibera per seleccionar recipient",
+        "no-peers_data-drop-bg": "Allibera per seleccionar destinatari",
+        "activate-share-mode-base": "Obre PairDrop a altres dispositius per enviar",
+        "activate-share-mode-shared-files-plural": "{{count}} fitxers compartits",
+        "x-instructions-share-mode_desktop": "Clica per enviar {{descriptor}}",
+        "activate-share-mode-shared-file": "fitxer compartit",
+        "activate-share-mode-and-other-file": "i 1 altre fitxer",
+        "x-instructions-share-mode_mobile": "Toca per enviar {{descriptor}}",
+        "activate-share-mode-and-other-files-plural": "i {{count}} fitxers més",
+        "activate-share-mode-shared-text": "text compartit",
+        "webrtc-requirement": "Per utilitzar aquesta instància de PairDrop cal habilitar WebRTC!"
+    },
+    "header": {
+        "theme-auto_title": "Adapta el tema al del sistema automàticament",
+        "install_title": "Instal·la PairDrop",
+        "theme-dark_title": "Utilitza sempre el mode fosc",
+        "pair-device_title": "Vincula els teus dispositius permanentment",
+        "join-public-room_title": "Uneix-te temporalment a una sala pública",
+        "notification_title": "Permet les notificacions",
+        "edit-paired-devices_title": "Edita els dispositius vinculats",
+        "edit-share-mode": "Editar",
+        "language-selector_title": "Configurar idioma",
+        "cancel-share-mode": "Cancel·lar",
+        "about_title": "Sobre PairDrop",
+        "about_aria-label": "Obre Sobre PairDrop",
+        "theme-light_title": "Utilitza sempre el mode clar",
+        "expand_title": "Expandeix la fila de botons de la capçalera"
+    },
+    "dialogs": {
+        "message_placeholder": "Text",
+        "base64-paste-to-send": "Enganxa el contingut del porta-retalls aquí per compartir {{type}}",
+        "auto-accept-instructions-2": "per acceptar automàticament tots els fitxers enviats des d'aquell dispositiu.",
+        "receive-text-title": "Missatge Rebut",
+        "edit-paired-devices-title": "Edita els Dispositius Vinculats",
+        "cancel": "Cancel·lar",
+        "auto-accept-instructions-1": "Activar",
+        "pair-devices-title": "Vincula Dispositius Permanentment",
+        "download": "Descarregar",
+        "title-file": "Fitxer",
+        "close-toast_title": "Tanca notificació",
+        "base64-processing": "Processant…",
+        "decline": "Rebutjar",
+        "receive-title": "{{descriptor}} Rebut",
+        "share-text-checkbox": "Mostra sempre aquesta finestra de diàleg en compartir text",
+        "leave": "Marxar",
+        "message_title": "Introdueix el missatge a enviar",
+        "join": "Unir-se",
+        "title-image-plural": "Imatges",
+        "send": "Enviar",
+        "base64-title-files": "Compartir Fitxers",
+        "base64-tap-to-paste": "Toca aquí per compartir {{type}}",
+        "base64-text": "text",
+        "copy": "Copiar",
+        "file-other-description-image": "i 1 altra imatge",
+        "pair-devices-qr-code_title": "Clica per copiar l'enllaç per vincular aquest dispositiu",
+        "approve": "aprovar",
+        "temporary-public-room-title": "Sala Pública Temporal",
+        "base64-files": "fitxers",
+        "paired-device-removed": "Dispositiu vinculat eliminat.",
+        "has-sent": "ha enviat:",
+        "share-text-title": "Compartir Missatge de Text",
+        "file-other-description-file": "i 1 altre fitxer",
+        "public-room-qr-code_title": "Clica per copiar l'enllaç a la sala pública",
+        "close": "Tancar",
+        "system-language": "Idioma del Sistema",
+        "share-text-subtitle": "Edita el missatge abans d'enviar:",
+        "unpair": "Desvincular",
+        "title-image": "Imatge",
+        "file-other-description-file-plural": "i {{count}} altres fitxers",
+        "would-like-to-share": "voldria compartir",
+        "base64-title-text": "Compartir Text",
+        "send-message-to": "Per a:",
+        "language-selector-title": "Establir idioma",
+        "pair": "Vincular",
+        "hr-or": "O",
+        "scan-qr-code": "o escaneja el codi QR.",
+        "input-key-on-this-device": "Introdueix aquesta clau a un altre dispositiu",
+        "download-again": "Descarregar de nou",
+        "accept": "Acceptar",
+        "paired-devices-wrapper_data-empty": "No hi ha dispositius vinculats.",
+        "enter-key-from-another-device": "Introdueix la clau d'un altre dispositiu aquí.",
+        "share": "Compartir",
+        "auto-accept": "auto-acceptar",
+        "title-file-plural": "Fitxers",
+        "send-message-title": "Enviar Missatge",
+        "input-room-id-on-another-device": "Introdueix aquest ID de sala a un altre dispositiu",
+        "file-other-description-image-plural": "i {{count}} altres imatges",
+        "enter-room-id-from-another-device": "Introdueix l'ID de sala d'un altre dispositiu per unir-t'hi."
+    },
+    "footer": {
+        "webrtc": "si WebRTC no està disponible.",
+        "public-room-devices_title": "Pots ser descobert per dispositius en aquesta sala pública independentment de la xarxa.",
+        "display-name_data-placeholder": "Carregant…",
+        "display-name_title": "Edita el nom del teu dispositiu permanentment",
+        "traffic": "El trànsit és",
+        "paired-devices_title": "Pots ser descobert per dispositius emparellats en qualsevol moment, independentment de la xarxa.",
+        "public-room-devices": "a la sala {{roomId}}",
+        "paired-devices": "per dispositius vinculats",
+        "on-this-network": "En aquesta xarxa",
+        "routed": "encaminat a través del servidor",
+        "discovery": "Pots ser descobert:",
+        "on-this-network_title": "Pots ser descobert per qualsevol usuari en aquesta xarxa.",
+        "known-as": "Ets conegut com a:"
+    },
+    "notifications": {
+        "request-title": "{{name}} voldria transferir {{count}} {{descriptor}}",
+        "unfinished-transfers-warning": "Hi ha transferències pendents. Estàs segur que vols tancar PairDrop?",
+        "message-received": "Missatge rebut per {{name}} - Fes clic per copiar",
+        "notifications-permissions-error": "El permís per notificacions ha estat bloquejat, ja que l'usuari ha refusat la sol·licitud diverses vegades. Això es pot restablir a Informació de Pàgina, a on es pot accedir clicant la icona amb el cadenat que hi ha al costat de la barra de l'URL.",
+        "rate-limit-join-key": "S'ha arribat al límit de ràtio. Espera 10 segons i torna-ho a intentar.",
+        "pair-url-copied-to-clipboard": "Enllaç per vincular aquest dispositiu copiat al porta-retalls",
+        "connecting": "Connectant…",
+        "pairing-key-invalidated": "Clau {{key}} invalidada",
+        "pairing-key-invalid": "Clau no vàlida",
+        "connected": "Connectat",
+        "pairing-not-persistent": "Els dispositius vinculats no són persistents",
+        "text-content-incorrect": "El contingut del text és incorrecte",
+        "message-transfer-completed": "Transferència de missatge completada",
+        "file-transfer-completed": "Transferència de fitxers completada",
+        "file-content-incorrect": "El contingut del fitxer és incorrecte",
+        "files-incorrect": "Els fitxers són incorrectes",
+        "selected-peer-left": "L'usuari seleccionat ha marxat",
+        "link-received": "Enllaç rebut per {{name}} - Fes clic per obrir",
+        "online": "Tornes a estar en línia",
+        "public-room-left": "Has sortit de la sala pública {{publicRoomId}}",
+        "copied-text": "Text copiat al porta-retalls",
+        "display-name-random-again": "El nom d'usuari ha estat generat novament generat aleatòriament",
+        "display-name-changed-permanently": "El nom d'usuari està canviat permanentment",
+        "copied-to-clipboard-error": "Còpia impossible. Copiar manualment.",
+        "pairing-success": "Dispositius vinculats",
+        "clipboard-content-incorrect": "El contingut del porta-retalls és incorrecte",
+        "display-name-changed-temporarily": "El nom d'usuari està canviat només per aquesta sessió",
+        "copied-to-clipboard": "Copiat al porta-retalls",
+        "offline": "No estàs en línia",
+        "pairing-tabs-error": "No es poden vincular dues pestanyes d'un navegador",
+        "public-room-id-invalid": "ID de sala no vàlid",
+        "click-to-download": "Clica per descarregar",
+        "pairing-cleared": "Tots els dispositius desvinculats",
+        "notifications-enabled": "Notificacions habilitades",
+        "online-requirement-pairing": "Has d'estar en línia per vincular dispositius",
+        "ios-memory-limit": "Tan sols és possible enviar fitxers de fins a 200 MB a iOS",
+        "online-requirement-public-room": "Cal que estiguis en línia per poder crear una sala pública",
+        "room-url-copied-to-clipboard": "Enllaç a la sala pública copiat al porta-retalls",
+        "copied-text-error": "L'escriptura al porta-retalls ha fallat. Copiar manualment!",
+        "download-successful": "{{descriptor}} descarregat",
+        "click-to-show": "Clica per mostrar"
+    },
+    "peer-ui": {
+        "processing": "Processant…",
+        "click-to-send-share-mode": "Clica per enviar {{descriptor}}",
+        "click-to-send": "Fes clic per enviar fitxers o fes clic dret per enviar un missatge",
+        "waiting": "Esperant…",
+        "connection-hash": "Per verificar la seguretat del xifratge de punta a punta, compara aquest número de seguretat en ambdós dispositius",
+        "preparing": "Preparant…",
+        "transferring": "Transferint…"
+    },
+    "about": {
+        "claim": "La manera més fàcil de compartir fitxers entre dispositius",
+        "tweet_title": "Tuiteja sobre PairDrop",
+        "close-about_aria-label": "Tanca Sobre PairDrop",
+        "buy-me-a-coffee_title": "Convida'm a un cafè!",
+        "github_title": "PairDrop a GitHub",
+        "faq_title": "Preguntes freqüents",
+        "mastodon_title": "Escriu sobre PairDrop a Mastodon",
+        "bluesky_title": "Segueix-nos a BlueSky",
+        "custom_title": "Segueix-nos",
+        "privacypolicy_title": "Obre la nostra política de privacitat"
+    },
+    "document-titles": {
+        "file-transfer-requested": "Transferència de Fitxers Sol·licitada",
+        "image-transfer-requested": "Transferència d'Imatges Sol·licitada",
+        "message-received-plural": "{{count}} Missatges Rebuts",
+        "message-received": "Missatge Rebut",
+        "file-received": "Fitxer Rebut",
+        "file-received-plural": "{{count}} Fitxers Rebuts"
+    }
+}