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

@@ -1,8 +1,8 @@
 ---
 name: Bug Report
-about: Create a report to help us improve
-title: 'Bug:/Enhancement:/Feature Request: '
-labels: ''
+about: Create a report to help us improve. Please check the FAQ first.
+title: '[Bug] '
+labels: 'bug'
 assignees: ''
 
 ---
@@ -34,12 +34,17 @@ If applicable, add screenshots to help explain your problem.
  - Browser [e.g. stock browser, safari]
  - Version [e.g. 22]
 
-**Self-Hosted**
+**Bug occurs on official PairDrop instance https://pairdrop.net/**
+No | Yes
+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
+Deployment: docker run | docker compose | npm run start:prod
+Version: v1.11.2
 
 **Additional context**
 Add any other context about the problem here.

.github/ISSUE_TEMPLATE/enhancement.md

@@ -0,0 +1,20 @@
+---
+name: Enhancement
+about: Enhancements and feature requests are always welcome. See discussions regarding central topics.
+title: '[Enhancement] '
+labels: 'enhancement'
+assignees: ''
+
+---
+
+**What problem is solved by the new feature**
+What's the motivation for this topic
+
+**Describe the feature**
+A clear and concise description of what the new feature/enhancement is.
+
+**Drafts**
+Screenshots of Draw.io graph or drawn sketch.
+
+**Additional context**
+Add any other context 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

@@ -0,0 +1,60 @@
+# 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 Docker image and push it to ghcr.io whenever a new version tag is pushed
+
+name: GHCR Image CI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push-image:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+        
+      - name: Setup qemu
+        uses: docker/setup-qemu-action@68827325e0b33c7199eb31dd4e31fbe9023e06e3 # v3.0.0
+
+      - name: Setup Docker Buildx
+        uses: docker/setup-buildx-action@f95db51fddba0c2d1ec667646a06c2ce06100226 # v3.0.0
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@343f7c4344506bcbf9b4de18042ae17996df046d # v3.0.0
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        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@4a13e500e55cf31b7a5d59a38ab2040ab0f42f56 # v5.1.0
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.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,11 +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,103 +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.
 
-Send images, documents or text via peer to peer connection to devices in the same local network/Wi-Fi or to paired devices.
-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
-
-### Device Pairing
-* Pair devices via 6-digit code or QR-Code
-* Pair devices outside your local network or in complex network environment (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.
-* Paired devices will always find each other via shared secrets even after reopening the browser or the Progressive Web App
-* You will always discover devices on your local network. Paired devices are shown additionally.
-* Paired devices outside your local network that are behind a NAT are connected automatically via [Open Relay: Free WebRTC TURN Server](https://www.metered.ca/tools/openrelay/)
+* 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.
 
-### [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 they are downloaded automatically if possible.
-* Multiple files are downloaded as ZIP file
-* On iOS and Android the devices share menu is opened instead of downloading the files
-* Multiple files are transferred at once with an overall progress indicator
+#### Persistent Device Pairing
 
-### Share Files Directly From Share / Context Menu
-* [Share files directly from context menu on Windows](/docs/how-to.md#share-files-directly-from-context-menu-on-windows)
-* [Share directly from share menu on iOS](/docs/how-to.md#share-directly-from-share-menu-on-ios)
-* [Share directly from share menu on Android](/docs/how-to.md#share-directly-from-share-menu-on-android)
+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.
 
-### Other changes
-* [Paste Mode](https://github.com/RobinLinus/snapdrop/pull/534)
+#### Temporary Public Rooms
+
+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
+* 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 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 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  
+* 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))
+* [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)
+* Translations.
 
-## Screenshots
-<div align="center">
+</details>
 
-![Pairdrop Preview](/docs/pairdrop_screenshot_mobile.gif)
-
-</div>
-
-## 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/)
-
-Have any questions? Read our [FAQ](/docs/faq.md).
-
-You can [host your own instance with Docker](/docs/host-your-own.md).
-
-
-## Support the Community
-PairDrop is free and always will be. Still, we have to pay for the domain.
-
-To contribute and support me:<br>
-<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;" >
+## 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/horizontal-blue.svg" alt="Translation status" style="width: 300px" />
 </a>
 
-Thanks a lot for supporting free and open software!
+## 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
 
-To support the original Snapdrop and its creator go to [his GitHub page](https://github.com/RobinLinus/snapdrop).
+[FAQ](docs/faq.md)
 
-## How to contribute
+[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

@@ -0,0 +1,31 @@
+version: "3"
+services:
+  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:
+      - "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: unless-stopped
+    volumes:
+      - ./turnserver.conf:/etc/coturn/turnserver.conf
+      - ./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/docker-swarm-usage.md

@@ -0,0 +1,47 @@
+# Docker Swarm Usage
+
+## Healthcheck
+
+The [Docker Image](../Dockerfile) includes a health check with the following options:
+
+```
+--interval=30s
+```
+> Specifies the time interval to run the health check. \
+> In this case, the health check is performed every 30 seconds.
+<br>
+
+```
+--timeout=10s
+```
+> Specifies the amount of time to wait for a response from the \"HEALTHCHECK\" command. \
+> If the response does not arrive within 10 seconds, the health check fails.
+<br>
+
+```
+--start-period=5s
+```
+> Specifies the amount of time to wait before starting the health check process. \
+> In this case, the health check process will begin 5 seconds after the container is started.
+<br>
+
+```
+--retries=3
+```
+> Specifies the number of times Docker should retry the health check \
+> before considering the container to be unhealthy.
+<br>
+
+
+The CMD instruction is used to define the command that will be run as part of the health check. \
+In this case, the command is `wget --quiet --tries=1 --spider http://localhost:3000/ || exit 1`. \
+This command will attempt to connect to `http://localhost:3000/` \
+and if it fails it will exit with a status code of `1`. \
+If this command returns a status code other than `0`, the health check fails.
+
+Overall, this \"HEALTHCHECK\" instruction is defining a health check process \
+that runs every 30 seconds, and waits up to 10 seconds for a response, \
+begins 5 seconds after the container is started, and retries up to 3 times. \ 
+The health check attempts to connect to http://localhost:3000/ \
+and will considers the container unhealthy if unable to connect.
+

docs/faq.md

@@ -1,85 +1,275 @@
 # Frequently Asked Questions
 
-### Instructions / Discussions
-* [Video Instructions](https://www.youtube.com/watch?v=4XN02GkcHUM) (Big thanks to [TheiTeckHq](https://www.youtube.com/channel/UC_DUzWMb8gZZnAbISQjmAfQ))
-* [idownloadblog](http://www.idownloadblog.com/2015/12/29/snapdrop/)
-* [thenextweb](http://thenextweb.com/insider/2015/12/27/snapdrop-is-a-handy-web-based-replacement-for-apples-fiddly-airdrop-file-transfer-tool/)
-* [winboard](http://www.winboard.org/artikel-ratgeber/6253-dateien-vom-desktop-pc-mit-anderen-plattformen-teilen-mit-snapdrop.html)
-* [免費資源網路社群](https://free.com.tw/snapdrop/)
-* [Hackernews](https://news.ycombinator.com/front?day=2020-12-24)
-* [Reddit](https://www.reddit.com/r/Android/comments/et4qny/snapdrop_is_a_free_open_source_cross_platform/)
-* [Producthunt](https://www.producthunt.com/posts/snapdrop)
+<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;">
+    Help! I can't install the PWA!
+</summary>
 
-### Help! I can't install the PWA!
-if you are using a Chromium-based browser (Chrome, Edge, 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>
 
-<img src="pwa-install.png" alt="Example on how to install a pwa with Edge">
+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/)
 
-### Are there any shortcuts?
-Sure!
+**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>
+
+**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>
+
+<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;">
+    Shortcuts?
+</summary>
+
+<br>
+
+Available shortcuts:
 - Send a message with `CTRL + ENTER`
-- Close all send and pair dialogs by pressing `Escape`.
-- Copy a received message to clipboard with `CTRL/⌘ + C`.
-- Accept file transfer request with `Enter` and decline with `Escape`.
+- Close all "Send" and "Pair" dialogs by pressing `Esc`.
+- Copy a received message to the clipboard with `CTRL/⌘ + C`.
+- Accept file-transfer requests with `Enter` and decline with `Esc`.
+<br>
 
-### When I receive images on iOS I cannot add them directly to the gallery?
-Apparently, iOS does not allow images shared from a website to be saved to the gallery directly.
-It simply does not offer the option for images shared from a website.
+</details>
 
-iOS Shortcuts to the win:
+<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;">
+    How to save images directly to the gallery on iOS?
+</summary>
+
+<br>
+
+~~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/
 
-### Is it possible to share files directly from the context / share menu?
-Yes it finally is!
-* [Share files directly from context menu on Windows](/docs/how-to.md#share-files-directly-from-context-menu-on-windows)
-* [Share directly from share menu on iOS](/docs/how-to.md#share-directly-from-share-menu-on-ios)
-* [Share directly from share menu on Android](/docs/how-to.md#share-directly-from-share-menu-on-android)
+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` 🎉
 
-### What about the connection? Is it a P2P-connection directly from device to device or is there any third-party-server?
-It uses a P2P connection if WebRTC is supported by the browser. WebRTC needs a Signaling Server, but it is only used to establish a connection and is not involved in the file transfer.
+<br>
 
-If your devices are paired and behind a NAT, the public TURN Server from [Open Relay](https://www.metered.ca/tools/openrelay/) is used to route your files and messages.
+</details>
 
-### What about privacy? Will files be saved on third-party-servers?
-None of your files are ever sent to any server. Files are sent only between peers. PairDrop doesn't even use a database. If you are curious have a look [at the Server](https://github.com/schlagmichdoch/pairdrop/blob/master/index.js).
-WebRTC encrypts the files on transit.
+<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;">
+    Is it possible to send files or text directly from the "Context" or "Share" menu?
+</summary>
 
-If your devices are paired and behind a NAT, the public TURN Server from [Open Relay](https://www.metered.ca/tools/openrelay/) is used to route your files and messages.
+<br>
 
-### What about security? Are my files encrypted while being sent between the computers?
-Yes. Your files are sent using WebRTC, which encrypts them on transit. To ensure the connection is secure and there is no MITM, compare the security number shown under the device name on both devices. The security number is different for every connection.
+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)
 
-### Transferring many files with paired devices takes too long
-Naturally, if traffic needs to be routed through the turn server transfer speed decreases.
-As a workaround you can open a hotspot on one of your devices to bridge the connection which makes transfers much faster.
+<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;">
+    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>
+
+<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;">
+    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>
+
+<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;">
+    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.
+
+If the devices are on the same network,
+none of your files are ever sent to any server.
+
+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.
+
+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>
+
+<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;">
+    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 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,
+none of your files are ever sent to any server.
+
+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>
+
+<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;">
+    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.
+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>
+
+<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;">
+    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.
+
+You can open a hotspot on one of your devices to bridge the connection,
+which omits the need of the TURN server.
 
 - [How to open a hotspot on Windows](https://support.microsoft.com/en-us/windows/use-your-windows-pc-as-a-mobile-hotspot-c89b0fad-72d5-41e8-f7ea-406ad9036b85#WindowsVersion=Windows_11)
-- [How to open a hotspot on Mac](https://support.apple.com/guide/mac-help/share-internet-connection-mac-network-users-mchlp1540/mac)
+- [How to open a hotspot on macOS](https://support.apple.com/guide/mac-help/share-internet-connection-mac-network-users-mchlp1540/mac)
 - [Library to open a hotspot on Linux](https://github.com/lakinduakash/linux-wifi-hotspot)
 
 You can also use mobile hotspots on phones to do that. 
-Then, all data should be sent directly between devices and your data plan should not be charged.
+Then, all data should be sent directly between devices and not use your data plan.
 
-### Why don't you implement feature xyz?
-Snapdrop and PairDrop are a study in radical simplicity. The user interface is insanely simple. Features are chosen very carefully because complexity grows quadratically since every feature potentially interferes with each other feature. We focus very narrowly on a single use case: instant file transfer. 
-We are not trying to optimize for some edge-cases. We are optimizing the user flow of the average users. Don't be sad if we decline your feature request for the sake of simplicity. 
+<br>
 
-If you want to learn more about simplicity you can read [Insanely Simple: The Obsession that Drives Apple's Success](https://www.amazon.com/Insanely-Simple-Ken-Segall-audiobook/dp/B007Z9686O) or [Thinking, Fast and Slow](https://www.amazon.com/Thinking-Fast-Slow-Daniel-Kahneman/dp/0374533555).
+</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;">
+    Why don't you implement feature xyz?
+</summary>
 
-### Snapdrop and PairDrop are awesome! How can I support them? 
-* [Buy me a cover to support open source software](https://www.buymeacoffee.com/pairdrop)
+<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
+since every feature potentially interferes with each other feature.
+We focus very narrowly on a single use case: instant file transfer. 
+Not facilitating optimal edge-cases means better flow for average users.
+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;">
+    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. 
-* Do security analysis and suggestions
+* Fix bugs and create a pull request.
+* Do some security analysis and make suggestions.
+* Participate in [active discussions](https://github.com/schlagmichdoch/PairDrop/discussions)
 
+<br>
 
-### How does it work?
-[See here for Information about the Technical Implementation](/docs/technical-documentation.md)
+</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;">
+    How does it work?
+</summary>
+
+<br>
+
+[See here for info about the technical implementation](/docs/technical-documentation.md)
+
+<br>
+
+</details>
 
 [< Back](/README.md)

docs/host-your-own.md

@@ -1,66 +1,159 @@
 # Deployment Notes
+
+## TURN server for Internet Transfer
+
+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.
 
-## Deployment with Docker from Docker Hub
+### 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 and reach the docker container directly, `127.0.0.1` is specified in the run command.
+> This image is hosted by [linuxserver.io](https://linuxserver.io). For more information visit https://hub.docker.com/r/linuxserver/pairdrop
 
-### Options / Flags
-Set options by using the following flags in the `docker run` command:
-
-#### Port
-```
--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
-```
--e RATE_LIMIT=true
-```
-> Limits clients to 100 requests per 5 min
-
-#### Websocket Fallback (for VPN)
-```
--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, 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/)).
->
-> **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.
 
 <br>
 
-## Deployment with Docker with self-built image
-### Build the image
+### Docker Image from GitHub Container Registry (ghcr.io)
+
+```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
-```
-> 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 and reach 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 above.](#options--flags)
+#### Run the image
 
-## Deployment with node
+```bash
+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` 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.
+
+
+<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:
+
+```yaml
+version: "3"
+services:
+    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:
+            - "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` 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 `ports` argument.
+
+<br>
+
+## Deployment with Node.js
+
+Clone this repository and enter the folder
 
 ```bash
 git clone https://github.com/schlagmichdoch/PairDrop.git && cd PairDrop
@@ -74,90 +167,318 @@ 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 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 and reach the docker container directly.
+> 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 
+npm start -- --auto-restart
 ```
+
 > Restarts server automatically on error
 
-<br>
-
-#### Rate limiting requests
-```bash
-npm start -- --rate-limit 
-```
-> Limits clients to 100 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/)).
-> 
-> **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.
-
-<br>
-
 #### Production (autostart and rate-limit)
+
 ```bash
 npm run start:prod
 ```
 
-#### Production (autostart, rate-limit, localhost-only and websocket fallback for VPN)
+> shortcut for `RATE_LIMIT=5 npm start -- --auto-restart`
+
+#### Production (autostart, rate-limit, localhost-only)
+
 ```bash
-npm run start:prod -- --localhost-only --include-ws-fallback
+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.
+
+> 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
+
+```bash
+IPV6_LOCALIZE=4
+```
+
+> 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
+WS_FALLBACK=true
+```
+
+> 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!
+> 
+> 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",
+>   "iceServers": [
+>     {
+>       "urls": "stun:stun.l.google.com:19302"
+>     }
+>   ]
+> }
+> ```
+
+<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
+SIGNALING_SERVER="pairdrop.net"
+```
+
+> Default: `false`
+>
+> By default, clients connecting to your instance use the signaling server of your instance to connect to other devices.
+> 
+> By using `SIGNALING_SERVER`, you can host an instance that uses another signaling server.
+> 
+> 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>
+
+### Customizable buttons for the _About PairDrop_ page
+
+```bash
+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"
+```
+
+> 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.
+
+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;
@@ -191,6 +512,7 @@ server {
 ```
 
 #### Automatic http to https redirect:
+
 ```
 server {
     listen       80;
@@ -219,100 +541,169 @@ server {
 }
 ```
 
+
+<br>
+
 ### Using Apache
+
 install modules `proxy`, `proxy_http`, `mod_proxy_wstunnel`
-```shell
+
+```bash
 a2enmod proxy
 ```
-```shell
+
+```bash
 a2enmod proxy_http
 ```
-```shell
-a2enmod proxy_wstunnel
-```
 
 <br>
 
-Create a new configuration file under `/etc/apache2/sites-available` (on debian)
+Create a new configuration file under `/etc/apache2/sites-available` (on Debian)
 
 **pairdrop.conf**
-#### Allow http and https requests
-```
-<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]
+
+#### Allow HTTP and HTTPS requests
+
+```apacheconf
+<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:
-```
-<VirtualHost *:80>	
-   Redirect permanent / https://127.0.0.1:3000/
+
+#### Automatic HTTP to HTTPS redirect:
+
+```apacheconf
+<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:
-```shell
+
+Activate the new virtual host and reload Apache:
+
+```bash
 a2ensite pairdrop
 ```
-```shell
+
+```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:
-```shell
-    git clone https://github.com/schlagmichdoch/PairDrop.git
-
-    cd PairDrop
-
-    git checkout dev
-    
-    docker-compose up -d
-```
-Now point your 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
-PWAs require that the app is served under a correctly set up and trusted TLS endpoint.
+#### Setup container
+To restart the container including coturn run: \
+  `docker compose -f docker-compose-coturn.yml restart`
 
-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.
+<br>
 
-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).
+#### 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-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. \
+
+##### 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,41 +1,142 @@
 # How-To
-## Share 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 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)
-
-## Share directly from share menu on iOS
-I created an iOS shortcut to send images, files, folder, URLs or text directly from the share-menu 
+## 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>
 
-## Share directly from share menu on Android
-The [Web Share Target API](https://developer.mozilla.org/en-US/docs/Web/Manifest/share_target) is implemented but not yet tested.
-When the PWA is installed, it should register itself to the share-menu of the device automatically.
+## 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.
 
-Please test this feature and create an issue if it does not work.
+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. \
+This opens PairDrop in the default browser where you can choose the receiver.
+
+### Usage
+```bash
+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 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
+```
+
+<br>
+
+### Setup
+
+#### 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
+   ```
+
+<br>
+
+#### Windows
+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)

docs/technical-documentation.md

@@ -3,48 +3,80 @@
 
 Encryption is mandatory for WebRTC connections and completely done by the browser itself.
 
-When the peers are first connecting, a channel is created by exchanging their signaling information.
-This signaling information includes some sort of public key and is specific to the clients ip address.
-That is what the STUN Server is used for: it simply returns your public IP address as you only know your local ip address
+When the peers are first connecting, \
+a channel is created by exchanging their signaling info. \
+This signaling information includes some sort of public key \
+and is specific to the clients IP address. \
+That is what the STUN Server is used for: \
+it simply returns your public IP address \
+as you only know your local ip address \
 if behind a NAT (router).
 
-The transfer of the signaling information is done by the PairDrop / Snapdrop server using secure websockets.
-After that the channel itself is completely peer-2-peer and all information can only be decrypted by the receiver.
-When the two peers are on the same network or when they are not behind any NAT system (which they are always for classic
-Snapdrop and for not paired users on PairDrop) the files are send directly peer to peer.
+The transfer of the signaling info is done by the \
+PairDrop / Snapdrop server using secure websockets. \
+After that the channel itself is completely peer-to-peer \
+and all info can only be decrypted by the receiver. \
+When the two peers are on the same network \
+or when they are not behind any NAT system \
+(which they are always for classic \
+Snapdrop and for not paired users on PairDrop) \
+the files are send directly peer-to-peer.
 
-When a user is behind a NAT (behind a router) the contents are channeled through a TURN server.
-But again, the contents send via the channel can only be decrypted by the receiver. So a rogue TURN server could only 
-see that there is a connection, but not what is sent. Obviously, connections which are channeled through a TURN server
-are not as fast as peer to peer.
+When a user is behind a NAT (behind a router) \
+the contents are channeled through a TURN server. \
+But again, the contents send via the channel \
+can only be decrypted by the receiver. \
+So a rogue TURN server could only \
+see that there is a connection, but not what is sent. \
+Obviously, connections which are channeled through a TURN server \
+are not as fast as peer-to-peer.
 
-The selection whether a TURN server is needed or not is also done automatically by the browser. 
-It simply iterated through the configured RTC iceServers and checks what works. Only if the STUN server is not sufficient,
+The selection whether a TURN server is needed \
+or not is also done automatically by the web browser. \
+It simply iterated through the configured \
+RTC iceServers and checks what works. \
+Only if the STUN server is not sufficient, \
 the TURN server is used.
 
 ![img](https://www.wowza.com/wp-content/uploads/WeRTC-Encryption-Diagrams-01.jpg)
 _Diagram created by wowza.com_
 
-Good thing: if your device has an IPv6 address it is uniquely reachable by that address. As I understand it, when both devices are using IPv6 addresses there is no need for a TURN server in any scenario.
+Good thing: if your device has an IPv6 address \
+it is uniquely reachable by that address. \
+As I understand it, when both devices are using \
+IPv6 addresses there is no need for a TURN server in any scenario.
 
-To learn more take a look at https://www.wowza.com/blog/webrtc-encryption-and-security which gives a good insight into stun, turn and webrtc
+Learn more by reading https://www.wowza.com/blog/webrtc-encryption-and-security \
+which gives a good insight into STUN, TURN and WebRTC.
 
 
 ## Device Pairing
 
 The pairing functionality uses the [IndexedDB API](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API).
 
-It works by creating long secrets that are served by the server to the initiating and requesting pair peer,
-when the inserted key is correct. These long secrets are then saved to an indexedDB database in the browser. 
-IndexedDB is somewhat the successor of localStorage as saved data is shared between all tabs.
-It goes one step further by making the data persistent and available offline if implemented to a PWA.
+It works by creating long secrets that are served \
+by the server to the initiating and requesting pair peer, \
+when the inserted key is correct. \
+These long secrets are then saved to an \
+indexedDB database in the web browser. \
+IndexedDB is somewhat the successor of localStorage \
+as saved data is shared between all tabs. \
+It goes one step further by making the data persistent \
+and available offline if implemented to a PWA.
 
-All secrets a client has saved to its database are send to the PairDrop server. Peers with a common secret are discoverable
-to each other analog to peers with the same ip-address are discoverable to each other.
+All secrets a client has saved to its database \
+are sent to the PairDrop server. \
+Peers with a common secret are discoverable \
+to each other analog to peers with the same \
+IP address are discoverable by each other.
 
-What I really like about this approach, and the reason why I implemented it, is that devices on the same network are always
-visible regardless whether any devices are paired or not. The main user flow is never obstructed. Paired devices are simply
-shown additionally. This makes it in my idea better than the idea of using a room system as [discussed here](https://github.com/RobinLinus/snapdrop/pull/214).
+What I really like about this approach (and the reason I implemented it) \
+is that devices on the same network are always \
+visible regardless whether any devices are paired or not. \
+The main user flow is never obstructed. \
+Paired devices are simply shown additionally. \
+This makes it in my idea better than the idea of \
+using a room system as [discussed here](https://github.com/RobinLinus/snapdrop/pull/214).
 
 
 [< Back](/README.md)

index.js

@@ -1,615 +0,0 @@
-const process = require('process')
-const crypto = require('crypto')
-const {spawn} = require('child_process')
-
-// 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 express = require('express');
-const RateLimit = require('express-rate-limit');
-const http = require('http');
-
-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'));
-}
-
-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);
-}
-
-const parser = require('ua-parser-js');
-const { uniqueNamesGenerator, animals, colors } = require('unique-names-generator');
-
-class PairDropServer {
-
-    constructor() {
-        const WebSocket = require('ws');
-        this._wss = new WebSocket.Server({ server });
-        this._wss.on('connection', (socket, request) => this._onConnection(new Peer(socket, request)));
-
-        this._rooms = {};
-        this._roomSecrets = {};
-
-        console.log('PairDrop is running on port', port);
-    }
-
-    _onConnection(peer) {
-        this._joinRoom(peer);
-        peer.socket.on('message', message => this._onMessage(peer, message));
-        peer.socket.onerror = e => console.error(e);
-        this._keepAlive(peer);
-
-        // send displayName
-        this._send(peer, {
-            type: 'display-name',
-            message: {
-                displayName: peer.name.displayName,
-                deviceName: peer.name.deviceName,
-                peerId: 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':
-                sender.lastBeat = Date.now();
-                break;
-            case 'room-secrets':
-                this._onRoomSecrets(sender, message);
-                break;
-            case 'room-secret-deleted':
-                this._onRoomSecretDeleted(sender, message);
-                break;
-            case 'room-secrets-cleared':
-                this._onRoomSecretsCleared(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 'resend-peers':
-                this._notifyPeers(sender);
-                break;
-            case 'signal':
-            default:
-                this._signalAndRelay(sender, message);
-        }
-    }
-
-    _signalAndRelay(sender, message) {
-        const room = message.roomType === 'ip' ? sender.ip : message.roomSecret;
-
-        // 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._leaveRoom(sender, 'ip', '', true);
-        this._leaveAllSecretRooms(sender, true);
-        this._removeRoomKey(sender.roomKey);
-        sender.roomKey = null;
-    }
-
-    _onRoomSecrets(sender, message) {
-        const roomSecrets = message.roomSecrets.filter(roomSecret => {
-            return /^[\x00-\x7F]{64}$/.test(roomSecret);
-        })
-        this._joinSecretRooms(sender, roomSecrets);
-    }
-
-    _onRoomSecretDeleted(sender, message) {
-        this._deleteSecretRoom(sender, message.roomSecret)
-    }
-
-    _onRoomSecretsCleared(sender, message) {
-        for (let i = 0; i<message.roomSecrets.length; i++) {
-            this._deleteSecretRoom(sender, message.roomSecrets[i]);
-        }
-    }
-
-    _deleteSecretRoom(sender, roomSecret) {
-        const room = this._rooms[roomSecret];
-        if (room) {
-            for (const peerId in room) {
-                const peer = room[peerId];
-                this._leaveRoom(peer, 'secret', roomSecret);
-                this._send(peer, {
-                    type: 'secret-room-deleted',
-                    roomSecret: roomSecret,
-                });
-            }
-        }
-        this._notifyPeers(sender);
-    }
-
-    getRandomString(length) {
-        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 propability bias, so I suppose we better skip this character */
-                return r === 45 || r >= 47 && r <= 57 || r >= 64 && r <= 90 || r >= 97 && r <= 122;
-            });
-            string += String.fromCharCode.apply(String, arr);
-        }
-        return string.substring(0, length)
-    }
-
-    _onPairDeviceInitiate(sender) {
-        let roomSecret = this.getRandomString(64);
-        let roomKey = this._createRoomKey(sender, roomSecret);
-        if (sender.roomKey) this._removeRoomKey(sender.roomKey);
-        sender.roomKey = roomKey;
-        this._send(sender, {
-            type: 'pair-device-initiated',
-            roomSecret: roomSecret,
-            roomKey: roomKey
-        });
-        this._joinRoom(sender, 'secret', roomSecret);
-    }
-
-    _onPairDeviceJoin(sender, message) {
-        if (sender.roomKeyRate >= 10) {
-            this._send(sender, { type: 'pair-device-join-key-rate-limit' });
-            return;
-        }
-        sender.roomKeyRate += 1;
-        setTimeout(_ => sender.roomKeyRate -= 1, 10000);
-        if (!this._roomSecrets[message.roomKey] || sender.id === this._roomSecrets[message.roomKey].creator.id) {
-            this._send(sender, { type: 'pair-device-join-key-invalid' });
-            return;
-        }
-        const roomSecret = this._roomSecrets[message.roomKey].roomSecret;
-        const creator = this._roomSecrets[message.roomKey].creator;
-        this._removeRoomKey(message.roomKey);
-        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._joinRoom(sender, 'secret', roomSecret);
-        this._removeRoomKey(sender.roomKey);
-    }
-
-    _onPairDeviceCancel(sender) {
-        if (sender.roomKey) {
-            this._send(sender, {
-                type: 'pair-device-canceled',
-                roomKey: sender.roomKey,
-            });
-            this._removeRoomKey(sender.roomKey);
-        }
-    }
-
-    _createRoomKey(creator, roomSecret) {
-        let roomKey;
-        do {
-            // get randomInt until keyRoom not occupied
-            roomKey = crypto.randomInt(1000000, 1999999).toString().substring(1); // include numbers with leading 0s
-        } while (roomKey in this._roomSecrets)
-
-        this._roomSecrets[roomKey] = {
-            roomSecret: roomSecret,
-            creator: creator
-        }
-
-        return roomKey;
-    }
-
-    _removeRoomKey(roomKey) {
-        if (roomKey in this._roomSecrets) {
-            this._roomSecrets[roomKey].creator.roomKey = null
-            delete this._roomSecrets[roomKey];
-        }
-    }
-
-    _joinRoom(peer, roomType = 'ip', roomSecret = '') {
-        const room = roomType === 'ip' ? peer.ip : roomSecret;
-
-        // if room doesn't exist, create it
-        if (!this._rooms[room]) {
-            this._rooms[room] = {};
-        }
-
-        this._notifyPeers(peer, roomType, roomSecret);
-
-        // add peer to room
-        this._rooms[room][peer.id] = peer;
-        // add secret to peer
-        if (roomType === 'secret') {
-            peer.addRoomSecret(roomSecret);
-        }
-    }
-
-    _leaveRoom(peer, roomType = 'ip', roomSecret = '', disconnect = false) {
-        const room = roomType === 'ip' ? peer.ip : roomSecret;
-
-        if (!this._rooms[room] || !this._rooms[room][peer.id]) return;
-        this._cancelKeepAlive(this._rooms[room][peer.id]);
-
-        // delete the peer
-        delete this._rooms[room][peer.id];
-
-        if (roomType === 'ip') {
-            peer.socket.terminate();
-        }
-
-        //if room is empty, delete the room
-        if (!Object.keys(this._rooms[room]).length) {
-            delete this._rooms[room];
-        } else {
-            // notify all other peers
-            for (const otherPeerId in this._rooms[room]) {
-                const otherPeer = this._rooms[room][otherPeerId];
-                this._send(otherPeer, {
-                    type: 'peer-left',
-                    peerId: peer.id,
-                    roomType: roomType,
-                    roomSecret: roomSecret,
-                    disconnect: disconnect
-                });
-            }
-        }
-        //remove secret from peer
-        if (roomType === 'secret') {
-            peer.removeRoomSecret(roomSecret);
-        }
-    }
-
-    _notifyPeers(peer, roomType = 'ip', roomSecret = '') {
-        const room = roomType === 'ip' ? peer.ip : roomSecret;
-        if (!this._rooms[room]) return;
-
-        // notify all other peers
-        for (const otherPeerId in this._rooms[room]) {
-            if (otherPeerId === peer.id) continue;
-            const otherPeer = this._rooms[room][otherPeerId];
-            this._send(otherPeer, {
-                type: 'peer-joined',
-                peer: peer.getInfo(),
-                roomType: roomType,
-                roomSecret: roomSecret
-            });
-        }
-
-        // notify peer about the other peers
-        const otherPeers = [];
-        for (const otherPeerId in this._rooms[room]) {
-            if (otherPeerId === peer.id) continue;
-            otherPeers.push(this._rooms[room][otherPeerId].getInfo());
-        }
-
-        this._send(peer, {
-            type: 'peers',
-            peers: otherPeers,
-            roomType: roomType,
-            roomSecret: roomSecret
-        });
-    }
-
-    _joinSecretRooms(peer, roomSecrets) {
-        for (let i=0; i<roomSecrets.length; i++) {
-            this._joinRoom(peer, 'secret', roomSecrets[i])
-        }
-    }
-
-    _leaveAllSecretRooms(peer, disconnect = false) {
-        for (let i=0; i<peer.roomSecrets.length; i++) {
-            this._leaveRoom(peer, 'secret', 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 = 500;
-        if (!peer.lastBeat) {
-            peer.lastBeat = Date.now();
-        }
-        if (Date.now() - peer.lastBeat > 2 * timeout) {
-            this._leaveRoom(peer);
-            this._leaveAllSecretRooms(peer);
-            return;
-        }
-
-        this._send(peer, { type: 'ping' });
-
-        peer.timerId = setTimeout(() => this._keepAlive(peer), timeout);
-    }
-
-    _cancelKeepAlive(peer) {
-        if (peer && peer.timerId) {
-            clearTimeout(peer.timerId);
-        }
-    }
-}
-
-
-
-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);
-
-        // for keepalive
-        this.timerId = 0;
-        this.lastBeat = Date.now();
-
-        this.roomSecrets = [];
-        this.roomKey = null;
-        this.roomKeyRate = 0;
-    }
-
-    _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);
-
-        // 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) {
-        let peer_id = new URL(request.url, "http://server").searchParams.get("peer_id");
-        if (peer_id && Peer.isValidUuid(peer_id)) {
-            this.id = peer_id;
-        } 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: this.id.hashCode()
-        })
-
-        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);
-    }
-
-    addRoomSecret(roomSecret) {
-        if (!(roomSecret in this.roomSecrets)) {
-            this.roomSecrets.push(roomSecret);
-        }
-    }
-
-    removeRoomSecret(roomSecret) {
-        if (roomSecret in this.roomSecrets) {
-            delete this.roomSecrets[roomSecret];
-        }
-    }
-}
-
-Object.defineProperty(String.prototype, 'hashCode', {
-    value: function() {
-        var hash = 0, i, chr;
-        for (i = 0; i < this.length; i++) {
-            chr   = this.charCodeAt(i);
-            hash  = ((hash << 5) - hash) + chr;
-            hash |= 0; // Convert to 32bit integer
-        }
-        return hash;
-    }
-});
-
-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.0.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": "^6.7.0",
-    "ua-parser-js": "^1.0.33",
+    "express-rate-limit": "^7.1.5",
+    "ua-parser-js": "^1.0.37",
     "unique-names-generator": "^4.3.0",
-    "ws": "^8.12.0"
+    "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

@@ -0,0 +1,382 @@
+#!/bin/bash
+set -e
+
+# PairDrop version when this file was last changed
+version="v1.10.4"
+
+############################################################
+# Help                                                     #
+############################################################
+help()
+{
+   # Display Help
+   echo "Send files or text with PairDrop via command-line interface."
+   echo "Current domain: ${DOMAIN}"
+   echo
+   echo "Usage:"
+   echo -e "Open PairDrop:\t\t$(basename "$0")"
+   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()
+{
+  url="$DOMAIN"
+  if [[ -n $params ]];then
+    url="${url}?${params}"
+  fi
+  if [[ -n $hash ]];then
+    url="${url}#${hash}"
+  fi
+
+  echo "PairDrop is opening at $DOMAIN"
+  if [[ $OS == "Windows" ]];then
+    start "$url"
+  elif [[ $OS == "Mac" ]];then
+    open "$url"
+  elif [[ $OS == "WSL" || $OS == "WSL2" ]];then
+    powershell.exe /c "Start-Process ${url}"
+  else
+    xdg-open "$url" > /dev/null 2>&1
+  fi
+
+
+  exit
+
+}
+
+setOs()
+{
+  unameOut=$(uname -a)
+  case "${unameOut}" in
+      *Microsoft*)     OS="WSL";; #must be first since Windows subsystem for linux will have Linux in the name too
+      *microsoft*)     OS="WSL2";; #WARNING: My v2 uses ubuntu 20.4 at the moment slightly different name may not always work
+      Linux*)          OS="Linux";;
+      Darwin*)         OS="Mac";;
+      CYGWIN*)         OS="Cygwin";;
+      MINGW*)          OS="Windows";;
+      *Msys)           OS="Windows";;
+      *)               OS="UNKNOWN:${unameOut}"
+  esac
+}
+
+specifyDomain()
+{
+  [[ ! $1 = http* ]] || [[ ! $1 = */ ]] && echo "Incorrect format. Specify domain like https://pairdrop.net/" && exit
+  echo "DOMAIN=${1}" > "$config_path"
+  echo -e "Domain is now set to:\n$1\n"
+}
+
+sendText()
+{
+    params="base64text=hash"
+    hash=$(echo -n "${OPTARG}" | base64)
+
+    if [[ $(echo -n "$hash" | wc -m) -gt 32600 ]];then
+      params="base64text=paste"
+      if [[ $OS == "Windows" || $OS == "WSL" || $OS == "WSL2" ]];then
+        echo -n "$hash" | clip.exe
+      elif [[ $OS == "Mac" ]];then
+        echo -n "$hash" | pbcopy
+      else
+        (echo -n "$hash" | xclip) || echo "You need to install xclip for sending bigger files from cli"
+      fi
+      hash=
+    fi
+
+    openPairDrop
+    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"
+  workingDir="$(pwd)"
+  tmpDir="/tmp/pairdrop-cli-temp/"
+  tmpDirPS="\$env:TEMP/pairdrop-cli-temp/"
+  
+  index=0
+  directoryBaseNamesUnix=()
+  directoryPathsUnix=()
+  filePathsUnix=()
+  directoryCount=0
+  fileCount=0
+  pathsPS=""
+
+  #create tmp folder if it does not exist already
+  if [[ ! -d "$tmpDir" ]]; then
+    mkdir "$tmpDir"
+  fi
+
+  for arg in "$@"; do
+   echo "$arg"
+   [[ ! -e "$arg" ]] && echo "The given path $arg does not exist." && exit
+
+    # 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
+      # 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
+}
+
+############################################################
+############################################################
+# Main program                                             #
+############################################################
+############################################################
+script_path="$( cd -- "$(dirname "$0")" >/dev/null 2>&1 ; pwd -P )"
+
+pushd . > '/dev/null';
+script_path="${BASH_SOURCE[0]:-$0}";
+
+while [ -h "$script_path" ];
+do
+  cd "$( dirname -- "$script_path"; )";
+  script_path="$( readlink -f -- "$script_path"; )";
+done
+
+cd "$( dirname -- "$script_path"; )" > '/dev/null';
+script_path="$( pwd; )";
+popd  > '/dev/null';
+
+config_path="${script_path}/.pairdrop-cli-config"
+
+# 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
+
+# Read config variables
+export "$(grep -v '^#' "$config_path" | xargs)"
+
+setOs
+
+############################################################
+# Process the input options. Add options as needed.        #
+############################################################
+# Get the options
+# open PairDrop if no options are given
+[[ $# -eq 0 ]] && openPairDrop && exit
+
+#  display help and exit if first argument is "--help" or more than 2 arguments are given
+[ "$1" == "--help" ] && help && exit
+
+while getopts "d:ht:*" option; do
+  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)
+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/index.html

@@ -5,17 +5,18 @@
     <meta charset="utf-8">
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
     <!-- Web App Config -->
-    <title>PairDrop</title>
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
+    <title>PairDrop | Transfer Files Cross-Platform. No Setup, No Signup.</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="theme-color" content="#3367d6">
     <meta name="color-scheme" content="dark light">
-    <meta name="apple-mobile-web-app-capable" content="no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
     <meta name="apple-mobile-web-app-title" content="PairDrop">
     <meta name="application-name" content="PairDrop">
     <!-- Descriptions -->
     <meta name="description" content="Instantly share images, videos, PDFs, and links with people nearby. Peer2Peer and Open Source. No Setup, No Signup.">
     <meta name="keywords" content="File, Transfer, Share, Peer2Peer">
-    <meta name="author" content="RobinLinus">
+    <meta name="author" content="schlagmichdoch">
     <meta property="og:title" content="PairDrop">
     <meta property="og:type" content="article">
     <meta property="og:url" content="https://pairdrop.net/">
@@ -28,305 +29,806 @@
     <link rel="icon" sizes="96x96" href="images/favicon-96x96.png">
     <link rel="shortcut icon" href="images/favicon-96x96.png">
     <link rel="apple-touch-icon" href="images/apple-touch-icon.png">
+    <link rel="apple-touch-icon-precomposed" href="images/apple-touch-icon.png">
     <meta name="msapplication-TileImage" content="images/mstile-150x150.png">
     <link rel="fluid-icon" type="image/png" href="images/android-chrome-192x192.png">
     <meta name="twitter:image" content="images/logo_transparent_512x512.png">
     <meta property="og:image" content="images/logo_transparent_512x512.png">
     <!-- Resources -->
-    <link rel="stylesheet" type="text/css" href="styles.css">
+    <link rel="preload" href="lang/en.json" as="fetch">
+    <link rel="preload" href="fonts/OpenSans/static/OpenSans-Medium.ttf" as="font" type="font/ttf" crossorigin>
+    <link rel="stylesheet" type="text/css" href="styles/styles-main.css">
     <link rel="manifest" href="manifest.json">
 </head>
 
 <body translate="no">
-    <header class="row-reverse">
-        <a href="#about" class="icon-button" title="About PairDrop">
+    <header class="row-reverse wrap opacity-0">
+        <a href="#about" class="icon-button" data-i18n-key="header.about" data-i18n-attrs="title aria-label">
             <svg class="icon">
-                <use xlink:href="#info-outline" />
+                <use xlink:href="#info-outline"></use>
             </svg>
         </a>
-        <a id="theme" class="icon-button" title="Switch Darkmode/Lightmode" >
+        <div id="language-selector" class="icon-button" data-i18n-key="header.language-selector" data-i18n-attrs="title">
             <svg class="icon">
-                <use xlink:href="#icon-theme" />
+                <use xlink:href="#icon-language-selector"></use>
             </svg>
-        </a>
-        <a id="notification" class="icon-button" title="Enable Notifications" hidden>
+        </div>
+        <div id="theme-wrapper">
+            <div id="theme-auto" class="icon-button selected" data-i18n-key="header.theme-auto" data-i18n-attrs="title">
+                <svg class="icon">
+                    <use xlink:href="#icon-theme-auto"></use>
+                </svg>
+            </div>
+            <div>
+                <div id="theme-light" class="icon-button" data-i18n-key="header.theme-light" data-i18n-attrs="title">
+                    <svg class="icon">
+                        <use xlink:href="#icon-theme-light"></use>
+                    </svg>
+                </div>
+                <div id="theme-dark" class="icon-button" data-i18n-key="header.theme-dark" data-i18n-attrs="title">
+                    <svg class="icon">
+                        <use xlink:href="#icon-theme-dark"></use>
+                    </svg>
+                </div>
+            </div>
+        </div>
+        <div id="notification" class="icon-button" data-i18n-key="header.notification" data-i18n-attrs="title" hidden>
             <svg class="icon">
-                <use xlink:href="#notifications" />
+                <use xlink:href="#notifications"></use>
             </svg>
-        </a>
-        <a id="install" class="icon-button" title="Install PairDrop" hidden>
+        </div>
+        <div id="install" class="icon-button" data-i18n-key="header.install" data-i18n-attrs="title" hidden>
             <svg class="icon">
-                <use xlink:href="#homescreen" />
+                <use xlink:href="#homescreen"></use>
             </svg>
-        </a>
-        <a id="pair-device" class="icon-button" title="Pair Device" >
+        </div>
+        <div id="pair-device" class="icon-button" data-i18n-key="header.pair-device" data-i18n-attrs="title">
             <svg class="icon">
-                <use xlink:href="#pair-device-icon" />
+                <use xlink:href="#pair-device-icon"></use>
             </svg>
-        </a>
-        <a id="clear-pair-devices" class="icon-button" title="Clear All Paired Devices" hidden>
+        </div>
+        <div id="edit-paired-devices" class="icon-button" data-i18n-key="header.edit-paired-devices" data-i18n-attrs="title" hidden>
             <svg class="icon">
-                <use xlink:href="#clear-pair-devices-icon" />
+                <use xlink:href="#edit-pair-devices-icon"></use>
             </svg>
-        </a>
+        </div>
+        <div id="join-public-room" class="icon-button" data-i18n-key="header.join-public-room" data-i18n-attrs="title">
+            <svg class="icon">
+                <use xlink:href="#public-room-icon"></use>
+            </svg>
+        </div>
+        <div id="expand" class="icon-button" data-i18n-key="header.expand" data-i18n-attrs="title" hidden>
+            <svg class="icon">
+                <use xlink:href="#caret"></use>
+            </svg>
+        </div>
     </header>
-    <a id="cancelPasteModeBtn" class="button" close hidden>Done</a>
-    <!-- Peers -->
-    <x-peers class="center"></x-peers>
-    <x-no-peers>
-        <h2>Open PairDrop on other devices to send files</h2>
-        <div>Pair devices to be discoverable on other networks</div>
-    </x-no-peers>
-    <x-instructions desktop="Click to send files or right click to send a message" mobile="Tap to send files or long tap to send a message">
-        <p id="pasteFilename"></p>
-    </x-instructions>
+    <!-- Center -->
+    <div id="center" class="opacity-0">
+        <!-- Peers -->
+        <x-peers class="center grow-5"></x-peers>
+        <x-no-peers class="center grow fade-in no-animation-on-load" data-i18n-key="instructions.no-peers" data-i18n-attrs="data-drop-bg">
+            <h2 data-i18n-key="instructions.no-peers-title" data-i18n-attrs="text"></h2>
+            <div data-i18n-key="instructions.no-peers-subtitle" data-i18n-attrs="text"></div>
+        </x-no-peers>
+        <x-instructions class="grow fade-in" data-i18n-key="instructions.x-instructions" data-i18n-attrs="desktop mobile data-drop-peer data-drop-bg"></x-instructions>
+        <div class="shr-panel panel column" hidden>
+            <div class="row">
+                <div class="thumb center">
+                    <div class="text-thumb row" hidden>
+                        <svg>
+                            <use xlink:href="#font"></use>
+                        </svg>
+                        <svg>
+                            <use xlink:href="#i-cursor"></use>
+                        </svg>
+                    </div>
+                    <div class="file-thumb" hidden>
+                        <svg>
+                            <use xlink:href="#file"></use>
+                        </svg>
+                    </div>
+                    <div class="image-thumb" hidden></div>
+                </div>
+                <div class="share-descriptor column p-1">
+                    <span class="descriptor-item"></span>
+                    <span class="descriptor-other" hidden></span>
+                </div>
+            </div>
+            <div class="center btn-row wrap">
+                <div class="cancel-btn btn btn-small btn-rounded btn-dark text-white" data-i18n-key="header.cancel-share-mode" data-i18n-attrs="text"></div>
+                <div class="edit-btn btn btn-small btn-rounded btn-dark text-white" data-i18n-key="header.edit-share-mode" data-i18n-attrs="text" hidden></div>
+            </div>
+        </div>
+        <div id="websocket-fallback" class="text-center" hidden>
+            <span data-i18n-key="footer.traffic" data-i18n-attrs="text"></span>
+            <span data-i18n-key="footer.routed" data-i18n-attrs="text"></span>
+            <span data-i18n-key="footer.webrtc" data-i18n-attrs="text"></span>
+        </div>
+    </div>
     <!-- Footer -->
-    <footer class="column">
+    <footer class="column opacity-0">
         <svg class="icon logo">
-            <use xlink:href="#wifi-tethering" />
+            <defs>
+                <linearGradient id="primaryGradient" gradientTransform="rotate(90)">
+                    <stop offset="0%" class="start-color" />
+                    <stop offset="100%" class="stop-color" />
+                </linearGradient>
+            </defs>
+            <use xlink:href="#wifi-tethering" style="fill: url(#primaryGradient);"></use>
         </svg>
-        <div id="displayName" placeholder="&nbsp;"></div>
-        <div class="font-body2">
-            You can be discovered by everyone <span id="on-this-network">on&nbsp;this&nbsp;network</span>
-            <span id="and-by-paired-devices" hidden> and&nbsp;by&nbsp;<span id="paired-devices">paired&nbsp;devices</span></span>
+        <div class="column">
+            <div class="known-as-wrapper">
+                <span data-i18n-key="footer.known-as" data-i18n-attrs="text"></span>
+                <div id="display-name" class="badge" data-i18n-key="footer.display-name" data-i18n-attrs="data-placeholder title" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable></div>
+                <svg class="icon edit-pen">
+                    <use xlink:href="#edit-pen-icon"></use>
+                </svg>
+            </div>
+            <div class="discovery-wrapper panel border row">
+                <div class="row center">
+                    <span data-i18n-key="footer.discovery" data-i18n-attrs="text"></span>
+                </div>
+                <div class="row center wrap">
+                    <span class="badge badge-room-ip" data-i18n-key="footer.on-this-network" data-i18n-attrs="text title"></span>
+                    <span class="badge badge-room-secret pointer" data-i18n-key="footer.paired-devices" data-i18n-attrs="text title" hidden></span>
+                    <span class="badge badge-room-public-id pointer" data-i18n-key="footer.public-room-devices" data-i18n-attrs="title" hidden>in room IAIAI</span>
+                </div>
+            </div>
         </div>
     </footer>
+    <!-- Language Select Dialog -->
+    <x-dialog id="language-select-dialog">
+        <x-background class="full center">
+            <x-paper shadow="2">
+                <div class="row center p-2">
+                    <h2 class="dialog-title" data-i18n-key="dialogs.language-selector-title" data-i18n-attrs="text"></h2>
+                </div>
+                <div class="language-buttons p2">
+                    <button class="btn fw wrap">
+                        <span data-i18n-key="dialogs.system-language" data-i18n-attrs="text"></span>
+                    </button>
+                    <button class="btn fw wrap" value="ar">
+                        <span lang="ar" dir="rtl">العربية</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Arabic)</span>
+                    </button>
+                    <button class="btn fw wrap" value="be">
+                        <span lang="be">беларуская</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Belarusian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="nb">
+                        <span lang="nb">Bokmål</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Norwegian Bokmål)</span>
+                    </button>
+                    <button class="btn fw wrap" value="bg">
+                        <span lang="bg">български</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Bulgarian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="ca">
+                        <span lang="ca">Català</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Catalan)</span>
+                    </button>
+                    <button class="btn fw wrap" value="cs">
+                        <span lang="cs">Čeština</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Czech)</span>
+                    </button>
+                    <button class="btn fw wrap" value="da">
+                        <span lang="da">Dansk</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Danish)</span>
+                    </button>
+                    <button class="btn fw wrap" value="de">
+                        <span lang="de">Deutsch</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(German)</span>
+                    </button>
+                    <button class="btn fw wrap" value="en">
+                        <span lang="en">English</span>
+                    </button>
+                    <button class="btn fw wrap" value="es">
+                        <span lang="es">Español</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Spanish)</span>
+                    </button>
+                    <button class="btn fw wrap" value="et">
+                        <span lang="et">Eesti</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Estonian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="eu">
+                        <span lang="eu">Euskara</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Basque)</span>
+                    </button>
+                    <button class="btn fw wrap" value="fa">
+                        <span lang="fa" dir="rtl">فارسی</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Persian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="fr">
+                        <span lang="fr">Français</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(French)</span>
+                    </button>
+                    <button class="btn fw wrap" value="id">
+                        <span lang="id">Bahasa Indonesia</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Indonesian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="it">
+                        <span lang="it">Italiano</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Italian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="he">
+                        <span lang="he" dir="rtl">עִבְרִית</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Hebrew)</span>
+                    </button>
+                    <button class="btn fw wrap" value="kn">
+                        <span lang="kn">ಕನ್ನಡ</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Kannada)</span>
+                    </button>
+                    <button class="btn fw wrap" value="hu">
+                        <span lang="hu">Magyar</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Hungarian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="nl">
+                        <span lang="nl">Nederlands</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Dutch)</span>
+                    </button>
+                    <button class="btn fw wrap" value="nn">
+                        <span lang="nn">Norsk</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Norwegian Nynorsk)</span>
+                    </button>
+                    <button class="btn fw wrap" value="pl">
+                        <span lang="pl">Polski</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Polish)</span>
+                    </button>
+                    <button class="btn fw wrap" value="pt-BR">
+                        <span lang="pt-BR">Português do Brasil</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Brazilian Portuguese)</span>
+                    </button>
+                    <button class="btn fw wrap" value="ro">
+                        <span lang="ro">Română</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Romanian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="ru">
+                        <span lang="ru">Русский язык</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Russian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="sk">
+                        <span lang="sk">Slovenčina</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Slovak)</span>
+                    </button>
+                    <button class="btn fw wrap" value="ta">
+                        <span lang="ta">தமிழ்</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Tamil)</span>
+                    </button>
+                    <button class="btn fw wrap" value="tr">
+                        <span lang="tr">Türkçe</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Turkish)</span>
+                    </button>
+                    <button class="btn fw wrap" value="uk">
+                        <span lang="uk">Українська</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Ukrainian)</span>
+                    </button>
+                    <button class="btn fw wrap" value="zh-CN">
+                        <span lang="zh-CN">汉语</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Simplified Chinese)</span>
+                    </button>
+                    <button class="btn fw wrap" value="zh-HK">
+                        <span lang="zh-HK">中文</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Hant Script)</span>
+                    </button>
+                    <button class="btn fw wrap" value="zh-TW">
+                        <span lang="zh-TW">漢語</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Traditional Chinese)</span>
+                    </button>
+                    <button class="btn fw wrap" value="ja">
+                        <span lang="ja">日本語</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Japanese)</span>
+                    </button>
+                    <button class="btn fw wrap" value="ko">
+                        <span lang="ko">한국어</span>
+                        <span>&nbsp;&nbsp;-&nbsp;&nbsp;</span>
+                        <span>(Korean)</span>
+                    </button>
+                </div>
+                <div class="center row-reverse btn-row wrap">
+                    <button class="btn btn-rounded btn-grey" type="button" data-i18n-key="dialogs.close" data-i18n-attrs="text" close></button>
+                </div>
+            </x-paper>
+        </x-background>
+    </x-dialog>
     <!-- Pair Device Dialog -->
-    <x-dialog id="pairDeviceDialog">
+    <x-dialog id="pair-device-dialog">
         <form action="#">
             <x-background class="full center text-center">
                 <x-paper shadow="2">
-                    <h2 class="center">Pair Devices</h2>
-                    <div class="center" id="roomKeyQrCode"></div>
-                    <h1 class="center" id="roomKey">000 000</h1>
-                    <div id="pairInstructions" class="font-subheading center text-center">Input this key on another device<br>or scan the QR-Code.</div>
-                    <hr>
-                    <div id="keyInputContainer">
-                        <input type="tel" id="char0" class="textarea center"  maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" autofocus contenteditable placeholder="" disabled>
-                        <input type="tel" id="char1" class="textarea center"  maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder="" disabled>
-                        <input type="tel" id="char2" class="textarea center"  maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder="" disabled>
-                        <input type="tel" id="char3" class="textarea center"  maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder="" disabled>
-                        <input type="tel" id="char4" class="textarea center"  maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder="" disabled>
-                        <input type="tel" id="char5" class="textarea center"  maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder="" disabled>
+                    <div class="row center p-2">
+                        <h2 class="dialog-title" data-i18n-key="dialogs.pair-devices-title" data-i18n-attrs="text"></h2>
                     </div>
-                    <div class="font-subheading center text-center">Enter key from another device to continue.</div>
-                    <div class="row-reverse space-between">
-                        <button class="button" type="submit" disabled>Pair</button>
-                        <div class="separator"></div>
-                        <a class="button" close>Cancel</a>
+                    <div class="row center p-2">
+                        <div class="column">
+                            <div class="center key-qr-code pointer" data-i18n-key="dialogs.pair-devices-qr-code" data-i18n-attrs="title"></div>
+                            <h1 class="center key" dir="ltr">000 000</h1>
+                            <p class="center text-center key-instructions">
+                                <span class="font-subheading" data-i18n-key="dialogs.input-key-on-this-device" data-i18n-attrs="text"></span>
+                                <span class="font-subheading" data-i18n-key="dialogs.scan-qr-code" data-i18n-attrs="text"></span>
+                            </p>
+                        </div>
+                    </div>
+                    <div class="hr-note">
+                        <hr>
+                        <div>
+                            <span data-i18n-key="dialogs.hr-or" data-i18n-attrs="text"></span>
+                        </div>
+                    </div>
+                    <div class="row center p-2">
+                        <div class="column fw">
+                            <div class="input-key-container six-chars" dir="ltr">
+                                <input type="tel" class="textarea center" aria-label="pair-key-char-1" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" autofocus contenteditable placeholder disabled>
+                                <input type="tel" class="textarea center" aria-label="pair-key-char-2" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                                <input type="tel" class="textarea center" aria-label="pair-key-char-3" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                                <input type="tel" class="textarea center" aria-label="pair-key-char-4" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                                <input type="tel" class="textarea center" aria-label="pair-key-char-5" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                                <input type="tel" class="textarea center" aria-label="pair-key-char-6" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                            </div>
+                            <p class="font-subheading center text-center" data-i18n-key="dialogs.enter-key-from-another-device" data-i18n-attrs="text"></p>
+                        </div>
+                    </div>
+                    <div class="btn-row row-reverse wrap">
+                        <button class="btn btn-rounded btn-grey" type="submit" data-i18n-key="dialogs.pair" data-i18n-attrs="text" disabled></button>
+                        <button class="btn btn-rounded btn-grey" type="button" data-i18n-key="dialogs.cancel" data-i18n-attrs="text" close></button>
                     </div>
                 </x-paper>
             </x-background>
         </form>
     </x-dialog>
-    <!-- Clear Devices Dialog -->
-    <x-dialog id="clearDevicesDialog">
+    <!-- Edit Paired Devices Dialog -->
+    <x-dialog id="edit-paired-devices-dialog">
         <form action="#">
             <x-background class="full center text-center">
                 <x-paper shadow="2">
-                    <h2 class="center">Unpair Devices</h2>
-                    <div class="font-subheading center text-center">Are you sure to unpair all devices?</div>
-                    <div class="row-reverse space-between">
-                        <button class="button" type="submit">Unpair Devices</button>
-                        <a class="button" close>Cancel</a>
+                    <div class="row center p-2">
+                        <h2 class="dialog-title" data-i18n-key="dialogs.edit-paired-devices-title" data-i18n-attrs="text"></h2>
+                    </div>
+                    <div class="paired-devices-wrapper" data-i18n-key="dialogs.paired-devices-wrapper" data-i18n-attrs="data-empty"></div>
+                    <div class="row center p-2">
+                        <div class="font-subheading">
+                            <span data-i18n-key="dialogs.auto-accept-instructions-1" data-i18n-attrs="text"></span>
+                            <u data-i18n-key="dialogs.auto-accept" data-i18n-attrs="text"></u>
+                            <span data-i18n-key="dialogs.auto-accept-instructions-2" data-i18n-attrs="text"></span>
+                        </div>
+                    </div>
+                    <div class="center row-reverse btn-row wrap">
+                        <button class="btn btn-rounded btn-grey" type="button" data-i18n-key="dialogs.close" data-i18n-attrs="text" close></button>
+                    </div>
+                </x-paper>
+            </x-background>
+        </form>
+    </x-dialog>
+    <!-- Public Room Dialog -->
+    <x-dialog id="public-room-dialog">
+        <form action="#">
+            <x-background class="full center text-center">
+                <x-paper shadow="2">
+                    <div class="row center p-2">
+                        <h2 class="dialog-title" data-i18n-key="dialogs.temporary-public-room-title" data-i18n-attrs="text"></h2>
+                    </div>
+                    <div class="row center p-2">
+                        <div class="column">
+                            <div class="center key-qr-code pointer" data-i18n-key="dialogs.public-room-qr-code" data-i18n-attrs="title"></div>
+                            <h1 class="center key" dir="ltr"></h1>
+                            <p class="center text-center key-instructions">
+                                <span class="font-subheading" data-i18n-key="dialogs.input-room-id-on-another-device" data-i18n-attrs="text"></span>
+                                <span class="font-subheading" data-i18n-key="dialogs.scan-qr-code" data-i18n-attrs="text"></span>
+                            </p>
+                        </div>
+                    </div>
+                    <div class="hr-note">
+                        <hr>
+                        <div>
+                            <span data-i18n-key="dialogs.hr-or" data-i18n-attrs="text"></span>
+                        </div>
+                    </div>
+                    <div class="row center p-2">
+                        <div class="column fw">
+                            <div class="input-key-container" dir="ltr">
+                                <input type="text" class="textarea center" aria-label="room-id-char-1" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" autofocus contenteditable placeholder disabled>
+                                <input type="text" class="textarea center" aria-label="room-id-char-2" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                                <input type="text" class="textarea center" aria-label="room-id-char-3" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                                <input type="text" class="textarea center" aria-label="room-id-char-4" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                                <input type="text" class="textarea center" aria-label="room-id-char-5" maxlength="1" autocorrect="off" autocomplete="off" autocapitalize="none" spellcheck="false" contenteditable placeholder disabled>
+                            </div>
+                            <p class="font-subheading center text-center" data-i18n-key="dialogs.enter-room-id-from-another-device" data-i18n-attrs="text"></p>
+                        </div>
+                    </div>
+                    <div class="center row-reverse btn-row wrap">
+                        <div class="row-reverse wrap grow-2">
+                            <button class="btn btn-rounded btn-grey" type="submit" data-i18n-key="dialogs.join" data-i18n-attrs="text" disabled></button>
+                            <button class="btn btn-rounded btn-grey leave-room" type="button" data-i18n-key="dialogs.leave" data-i18n-attrs="text"></button>
+                        </div>
+                        <button class="btn btn-rounded btn-grey" type="button" data-i18n-key="dialogs.close" data-i18n-attrs="text" close></button>
                     </div>
                 </x-paper>
             </x-background>
         </form>
     </x-dialog>
     <!-- Receive Request Dialog -->
-    <x-dialog id="receiveRequestDialog">
+    <x-dialog id="receive-request-dialog">
         <x-background class="full center">
             <x-paper shadow="2">
-                <h2 class="center">PairDrop</h2>
-                <div class="text-center file-description">
-                    <div>
-                        <span id="requestingPeerDisplayName"></span>
-                        <span>would like to share</span>
-                    </div>
-                    <div class="row" id="fileName">
-                        <span id="fileStem"></span>
-                        <span id="fileExtension"></span>
-                    </div>
-                    <div class="row">
-                        <span id="fileOther"></span>
+                <div class="row center p-2">
+                    <h2 class="dialog-title"></h2>
+                </div>
+                <div class="row center p-2">
+                    <div class="column center file-description">
+                        <div>
+                            <span class="display-name badge"></span>
+                            <span data-i18n-key="dialogs.would-like-to-share" data-i18n-attrs="text"></span>
+                        </div>
+                        <div class="row file-name">
+                            <span class="file-stem"></span>
+                            <span class="file-extension"></span>
+                        </div>
+                        <div class="row file-other">
+                        </div>
+                        <div class="row font-body2 file-size"></div>
                     </div>
                 </div>
-                <div class="font-body2 text-center file-size"></div>
                 <div class="center file-preview"></div>
-                <div class="row-reverse space-between">
-                    <button class="button" id="acceptRequest" title="ENTER" autofocus>Accept</button>
-                    <div class="separator"></div>
-                    <button class="button" id="declineRequest" title="ESCAPE">Decline</button>
+                <div class="row-reverse center btn-row wrap">
+                    <button id="accept-request" class="btn btn-rounded btn-grey" title="ENTER" data-i18n-key="dialogs.accept" data-i18n-attrs="text" autofocus disabled></button>
+                    <button id="decline-request" class="btn btn-rounded btn-grey" title="ESCAPE" data-i18n-key="dialogs.decline" data-i18n-attrs="text"></button>
                 </div>
             </x-paper>
         </x-background>
     </x-dialog>
     <!-- Receive File Dialog -->
-    <x-dialog id="receiveFileDialog">
+    <x-dialog id="receive-file-dialog">
         <x-background class="full center">
             <x-paper shadow="2">
-                <h2 class="center" id="receiveTitle"></h2>
-                <div class="text-center file-description"></div>
-                <div class="font-body2 text-center file-size"></div>
+                <div class="row center p-2">
+                    <h2 class="dialog-title"></h2>
+                </div>
+                <div class="row center p-2">
+                    <div class="column center file-description">
+                        <div>
+                            <span class="display-name badge"></span>
+                            <span data-i18n-key="dialogs.has-sent" data-i18n-attrs="text"></span>
+                        </div>
+                        <div class="row file-name">
+                            <span class="file-stem"></span>
+                            <span class="file-extension"></span>
+                        </div>
+                        <div class="row file-other">
+                        </div>
+                        <div class="row font-body2 file-size"></div>
+                    </div>
+                </div>
                 <div class="center file-preview"></div>
-                <div class="row-reverse space-between">
-                    <a class="button" id="shareOrDownload" autofocus></a>
-                    <div class="separator"></div>
-                    <button class="button" close>Close</button>
+                <div class="row-reverse center btn-row wrap">
+                    <button id="share-btn" class="btn btn-rounded btn-grey" data-i18n-key="dialogs.share" data-i18n-attrs="text" hidden></button>
+                    <button id="download-btn" class="btn btn-rounded btn-grey" data-i18n-key="dialogs.download" data-i18n-attrs="text" autofocus disabled></button>
+                    <button class="btn btn-rounded btn-grey" data-i18n-key="dialogs.close" data-i18n-attrs="text" close></button>
                 </div>
             </x-paper>
         </x-background>
     </x-dialog>
     <!-- Send Text Dialog -->
-    <x-dialog id="sendTextDialog">
+    <x-dialog id="send-text-dialog">
         <form action="#">
             <x-background class="full center">
                 <x-paper shadow="2">
-                    <h2>PairDrop - Send a Message</h2>
-                    <div id="textInput" class="textarea" role="textbox" placeholder="Send a message" autocapitalize="none" spellcheck="false" autofocus contenteditable></div>
-                    <div class="row-reverse">
-                        <button class="button" type="submit" title="STR + ENTER" disabled close>Send</button>
-                        <div class="separator"></div>
-                        <a class="button" title="ESCAPE" close>Cancel</a>
+                    <div class="row center p-2">
+                        <h2 class="dialog-title" data-i18n-key="dialogs.send-message-title" data-i18n-attrs="text"></h2>
+                    </div>
+                    <div class="row center p-2 display-name-wrapper">
+                        <div class="column">
+                            <div class="text-center">
+                                <span data-i18n-key="dialogs.send-message-to" data-i18n-attrs="text"></span>
+                                <span class="display-name badge"></span>
+                            </div>
+                        </div>
+                    </div>
+                    <div class="row p-2">
+                        <div class="column fw">
+                            <div class="fw textarea" role="textbox" data-i18n-key="dialogs.message" data-i18n-attrs="title placeholder" autofocus contenteditable></div>
+                        </div>
+                    </div>
+                    <div class="btn-row row-reverse wrap">
+                        <button class="btn btn-rounded btn-grey" type="submit" title="CTRL/⌘ + ENTER" data-i18n-key="dialogs.send" data-i18n-attrs="text" disabled></button>
+                        <button class="btn btn-rounded btn-grey" type="button" title="ESCAPE" data-i18n-key="dialogs.cancel" data-i18n-attrs="text" close></button>
                     </div>
                 </x-paper>
             </x-background>
         </form>
     </x-dialog>
     <!-- Receive Text Dialog -->
-    <x-dialog id="receiveTextDialog">
+    <x-dialog id="receive-text-dialog">
         <x-background class="full center">
             <x-paper shadow="2">
-                <h2>PairDrop - Message Received</h2>
-                <div id="receiveTextDescriptionContainer">
-                    <span id="receiveTextPeerDisplayName"></span>
-                    <span>sent the following message:</span>
+                <div class="row center p-2">
+                    <h2 class="dialog-title" class="text-center" data-i18n-key="dialogs.receive-text-title" data-i18n-attrs="text"></h2>
                 </div>
-                <div class="row-separator"></div>
-                <div id="text"></div>
-                <div class="row-reverse">
-                    <button class="button" id="copy" title="CTRL/⌘ + C">Copy</button>
-                    <div class="separator"></div>
-                    <button class="button" id="close" title="ESCAPE">Close</button>
+                <div class="row center p-2 display-name-wrapper">
+                    <div class="text-center">
+                        <span class="display-name badge"></span>
+                        <span data-i18n-key="dialogs.has-sent" data-i18n-attrs="text"></span>
+                    </div>
+                </div>
+                <div class="row center p-2">
+                    <div class="column fw">
+                        <div id="text" class="textarea"></div>
+                    </div>
+                </div>
+                <div class="row-reverse center btn-row wrap">
+                    <button id="copy" class="btn btn-rounded btn-grey" title="CTRL/⌘ + C" data-i18n-key="dialogs.copy" data-i18n-attrs="text"></button>
+                    <button id="close" class="btn btn-rounded btn-grey" title="ESCAPE" data-i18n-key="dialogs.close" data-i18n-attrs="text"></button>
                 </div>
             </x-paper>
         </x-background>
     </x-dialog>
-    <!-- base64ZipDialog Dialog -->
-    <x-dialog id="base64ZipDialog">
+    <!-- Share Text Dialog -->
+    <x-dialog id="share-text-dialog">
         <x-background class="full center">
             <x-paper shadow="2">
-                <button class="button center" id="base64ZipPasteBtn" title="Paste">Tap here to paste files</button>
-                <button class="button center" close>Close</button>
+                <div class="row center p-2">
+                    <h2 class="dialog-title" data-i18n-key="dialogs.share-text-title" data-i18n-attrs="text"></h2>
+                </div>
+                <div class="row center p-2 pb-0">
+                    <div class="column">
+                        <div class="text-center">
+                            <span data-i18n-key="dialogs.share-text-subtitle" data-i18n-attrs="text"></span>
+                        </div>
+                    </div>
+                </div>
+                <div class="row p-2">
+                    <div class="column fw">
+                        <div class="fw textarea" role="textbox" data-i18n-key="dialogs.message" data-i18n-attrs="title placeholder" contenteditable></div>
+                    </div>
+                </div>
+                <div class="row p-2 center">
+                    <span class="mx-1" data-i18n-key="dialogs.share-text-checkbox" data-i18n-attrs="text"></span>
+                    <label class="pointer switch mx-1">
+                        <input type="checkbox">
+                        <div class="slider round"></div>
+                    </label>
+                </div>
+                <div class="btn-row row-reverse wrap">
+                    <button class="btn btn-rounded btn-grey" type="submit" title="CTRL/⌘ + ENTER" data-i18n-key="dialogs.approve" data-i18n-attrs="text" autofocus disabled></button>
+                </div>
+            </x-paper>
+        </x-background>
+    </x-dialog>
+    <!-- base64 Paste Dialog -->
+    <x-dialog id="base64-paste-dialog">
+        <x-background class="full center">
+            <x-paper shadow="2">
+                <div class="row center p-2">
+                    <h2 class="dialog-title"></h2>
+                </div>
+                <div class="row p-2">
+                    <button class="btn btn-rounded btn-grey center" id="base64-paste-btn" title="Paste"></button>
+                    <div class="textarea" title="CMD/⌘ + V" contenteditable hidden></div>
+                </div>
+                <div class="row-reverse center btn-row wrap">
+                    <button class="btn btn-rounded btn-grey" data-i18n-key="dialogs.close" data-i18n-attrs="text" close></button>
+                </div>
             </x-paper>
         </x-background>
     </x-dialog>
     <!-- Toast -->
     <div class="toast-container full center">
-        <x-toast class="row" shadow="1" id="toast"></x-toast>
+        <x-toast id="toast" shadow="1">
+            <span class="center text-center"></span>
+            <div class="icon-button" data-i18n-key="dialogs.close-toast" data-i18n-attrs="title">
+                <svg class="icon">
+                    <use xlink:href="#close-icon"></use>
+                </svg>
+            </div>
+        </x-toast>
     </div>
     <!-- About Page -->
     <x-about id="about" class="full center column">
-        <section class="center column fade-in">
-            <header class="row-reverse">
-                <a href="#" class="close icon-button">
-                    <svg class="icon">
-                        <use xlink:href="#close-icon" />
-                    </svg>
-                </a>
-            </header>
+        <header class="row-reverse">
+            <a href="#" class="close icon-button" data-i18n-key="about.close-about" data-i18n-attrs="aria-label">
+                <svg class="icon">
+                    <use xlink:href="#close-icon"></use>
+                </svg>
+            </a>
+        </header>
+        <section class="center column">
             <svg class="icon logo">
-                <use xlink:href="#wifi-tethering" />
+                <use xlink:href="#wifi-tethering"></use>
             </svg>
-            <h1>PairDrop</h1>
-            <div class="font-subheading">The easiest way to transfer files across devices</div>
+            <div class="title-wrapper" dir="ltr">
+                <h1>PairDrop</h1>
+                <div class="font-subheading">v1.11.2</div>
+            </div>
+            <div class="font-subheading" data-i18n-key="about.claim" data-i18n-attrs="text"></div>
             <div class="row">
-                <a class="icon-button" target="_blank" href="https://github.com/schlagmichdoch/pairdrop" title="PairDrop on Github" rel="noreferrer">
+                <a class="icon-button" target="_blank" href="https://github.com/schlagmichdoch/pairdrop" rel="noreferrer" data-i18n-key="about.github" data-i18n-attrs="title">
                     <svg class="icon">
-                        <use xlink:href="#github" />
+                        <use xlink:href="#github"></use>
                     </svg>
                 </a>
-                <a class="icon-button" target="_blank" href="https://www.buymeacoffee.com/pairdrop" title="Buy me a coffee!" rel="noreferrer">
+                <a class="icon-button" id="donation-btn" target="_blank" href="https://www.buymeacoffee.com/pairdrop" rel="noreferrer" data-i18n-key="about.buy-me-a-coffee" data-i18n-attrs="title">
                     <svg class="icon">
-                        <use xlink:href="#monetarization" />
+                        <use xlink:href="#donation"></use>
                     </svg>
                 </a>
-                <a class="icon-button" target="_blank" href="https://twitter.com/intent/tweet?text=https%3A%2F%2Fpairdrop.net%20by%20https%3A%2F%2Fgithub.com%2Fschlagmichdoch%2F&" title="Tweet about PairDrop" rel="noreferrer">
+                <a class="icon-button" id="x-twitter-btn" target="_blank" href="https://x.com/intent/tweet?text=https%3A%2F%2Fpairdrop.net%20by%20https%3A%2F%2Fgithub.com%2Fschlagmichdoch%2F&amp;" rel="noreferrer" data-i18n-key="about.tweet" data-i18n-attrs="title">
                     <svg class="icon">
-                        <use xlink:href="#twitter" />
+                        <use xlink:href="#x-twitter"></use>
                     </svg>
                 </a>
-                <a class="icon-button" target="_blank" href="https://github.com/schlagmichdoch/pairdrop/blob/master/docs/faq.md" title="Frequently asked questions" rel="noreferrer">
+                <a class="icon-button" id="mastodon-btn" target="_blank" rel="noreferrer" data-i18n-key="about.mastodon" data-i18n-attrs="title" hidden>
                     <svg class="icon">
-                        <use xlink:href="#help-outline" />
+                        <use xlink:href="#mastodon"></use>
+                    </svg>
+                </a>
+                <a class="icon-button" id="bluesky-btn" target="_blank" rel="noreferrer" data-i18n-key="about.bluesky" data-i18n-attrs="title" hidden>
+                    <svg class="icon">
+                        <use xlink:href="#bluesky"></use>
+                    </svg>
+                </a>
+                <a class="icon-button" id="custom-btn" target="_blank" rel="noreferrer" data-i18n-key="about.custom" data-i18n-attrs="title" hidden>
+                    <svg class="icon">
+                        <use xlink:href="#custom"></use>
+                    </svg>
+                </a>
+                <a class="icon-button" id="privacypolicy-btn" target="_blank" rel="noreferrer" data-i18n-key="about.privacypolicy" data-i18n-attrs="title" hidden>
+                    <svg class="icon">
+                        <use xlink:href="#privacypolicy"></use>
+                    </svg>
+                </a>
+                <a class="icon-button" target="_blank" href="https://github.com/schlagmichdoch/pairdrop/blob/master/docs/faq.md" rel="noreferrer" data-i18n-key="about.faq" data-i18n-attrs="title">
+                    <svg class="icon">
+                        <use xlink:href="#help-outline"></use>
                     </svg>
                 </a>
             </div>
         </section>
         <x-background></x-background>
     </x-about>
+    <canvas class="circles opacity-0"></canvas>
     <!-- SVG Icon Library -->
     <svg style="display: none;">
-        <symbol id=wifi-tethering viewBox="0 0 24 24">
+        <symbol id="wifi-tethering" viewBox="0 0 24 24">
             <path d="M12 11c-1.1 0-2 .9-2 2s.9 2 2 2 2-.9 2-2-.9-2-2-2zm6 2c0-3.31-2.69-6-6-6s-6 2.69-6 6c0 2.22 1.21 4.15 3 5.19l1-1.74c-1.19-.7-2-1.97-2-3.45 0-2.21 1.79-4 4-4s4 1.79 4 4c0 1.48-.81 2.75-2 3.45l1 1.74c1.79-1.04 3-2.97 3-5.19zM12 3C6.48 3 2 7.48 2 13c0 3.7 2.01 6.92 4.99 8.65l1-1.73C5.61 18.53 4 15.96 4 13c0-4.42 3.58-8 8-8s8 3.58 8 8c0 2.96-1.61 5.53-4 6.92l1 1.73c2.99-1.73 5-4.95 5-8.65 0-5.52-4.48-10-10-10z"></path>
         </symbol>
-        <symbol id=desktop-mac viewBox="0 0 24 24">
+        <symbol id="desktop-mac" viewBox="0 0 24 24">
             <path d="M21 2H3c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h7l-2 3v1h8v-1l-2-3h7c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 12H3V4h18v10z"></path>
         </symbol>
-        <symbol id=phone-iphone viewBox="0 0 24 24">
+        <symbol id="phone-iphone" viewBox="0 0 24 24">
             <path d="M15.5 1h-8C6.12 1 5 2.12 5 3.5v17C5 21.88 6.12 23 7.5 23h8c1.38 0 2.5-1.12 2.5-2.5v-17C18 2.12 16.88 1 15.5 1zm-4 21c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm4.5-4H7V4h9v14z"></path>
         </symbol>
-        <symbol id=tablet-mac viewBox="0 0 24 24">
+        <symbol id="tablet-mac" viewBox="0 0 24 24">
             <path d="M18.5 0h-14C3.12 0 2 1.12 2 2.5v19C2 22.88 3.12 24 4.5 24h14c1.38 0 2.5-1.12 2.5-2.5v-19C21 1.12 19.88 0 18.5 0zm-7 23c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm7.5-4H4V3h15v16z"></path>
         </symbol>
-        <symbol id=info-outline viewBox="0 0 24 24">
+        <symbol id="info-outline" viewBox="0 0 24 24">
             <path d="M11 17h2v-6h-2v6zm1-15C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8zM11 9h2V7h-2v2z"></path>
         </symbol>
-        <symbol id=close-icon viewBox="0 0 24 24">
+        <symbol id="close-icon" viewBox="0 0 24 24">
             <path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"></path>
         </symbol>
-        <symbol id=help-outline viewBox="0 0 24 24">
+        <symbol id="help-outline" viewBox="0 0 24 24">
             <path d="M11 18h2v-2h-2v2zm1-16C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8zm0-14c-2.21 0-4 1.79-4 4h2c0-1.1.9-2 2-2s2 .9 2 2c0 2-3 1.75-3 5h2c0-2.25 3-2.5 3-5 0-2.21-1.79-4-4-4z"></path>
         </symbol>
-        <symbol id="twitter">
-            <path d="M23.954 4.569c-.885.389-1.83.654-2.825.775 1.014-.611 1.794-1.574 2.163-2.723-.951.555-2.005.959-3.127 1.184-.896-.959-2.173-1.559-3.591-1.559-2.717 0-4.92 2.203-4.92 4.917 0 .39.045.765.127 1.124C7.691 8.094 4.066 6.13 1.64 3.161c-.427.722-.666 1.561-.666 2.475 0 1.71.87 3.213 2.188 4.096-.807-.026-1.566-.248-2.228-.616v.061c0 2.385 1.693 4.374 3.946 4.827-.413.111-.849.171-1.296.171-.314 0-.615-.03-.916-.086.631 1.953 2.445 3.377 4.604 3.417-1.68 1.319-3.809 2.105-6.102 2.105-.39 0-.779-.023-1.17-.067 2.189 1.394 4.768 2.209 7.557 2.209 9.054 0 13.999-7.496 13.999-13.986 0-.209 0-.42-.015-.63.961-.689 1.8-1.56 2.46-2.548l-.047-.02z" />
+        <symbol id="x-twitter">
+            <path d="M17.996,2.219l3.265,0l-7.13,8.148l8.388,11.088l-6.566,0l-5.147,-6.723l-5.882,6.723l-3.269,0l7.625,-8.716l-8.041,-10.52l6.733,0l4.647,6.146l5.377,-6.146Zm-1.146,17.285l1.808,-0l-11.671,-15.435l-1.942,0l11.805,15.435Z"></path>
         </symbol>
         <symbol id="github">
-            <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
+            <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"></path>
+        </symbol>
+        <symbol id="notifications">
+            <path d="M12 22c1.1 0 2-.9 2-2h-4c0 1.1.89 2 2 2zm6-6v-5c0-3.07-1.64-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68C7.63 5.36 6 7.92 6 11v5l-2 2v1h16v-1l-2-2z"></path>
         </symbol>
-        <g id="notifications">
-            <path d="M12 22c1.1 0 2-.9 2-2h-4c0 1.1.89 2 2 2zm6-6v-5c0-3.07-1.64-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68C7.63 5.36 6 7.92 6 11v5l-2 2v1h16v-1l-2-2z" />
-        </g>
         <symbol id="homescreen">
-            <path fill="none" d="M0 0h24v24H0V0z" />
-            <path d="M18 1.01L8 1c-1.1 0-2 .9-2 2v3h2V5h10v14H8v-1H6v3c0 1.1.9 2 2 2h10c1.1 0 2-.9 2-2V3c0-1.1-.9-1.99-2-1.99zM10 15h2V8H5v2h3.59L3 15.59 4.41 17 10 11.41z" />
-            <path fill="none" d="M0 0h24v24H0V0z" />
+            <path fill="none" d="M0 0h24v24H0V0z"></path>
+            <path d="M18 1.01L8 1c-1.1 0-2 .9-2 2v3h2V5h10v14H8v-1H6v3c0 1.1.9 2 2 2h10c1.1 0 2-.9 2-2V3c0-1.1-.9-1.99-2-1.99zM10 15h2V8H5v2h3.59L3 15.59 4.41 17 10 11.41z"></path>
+            <path fill="none" d="M0 0h24v24H0V0z"></path>
         </symbol>
-        <symbol id="monetarization">
-            <path d="M0 0h24v24H0z" fill="none" />
-            <path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1.41 16.09V20h-2.67v-1.93c-1.71-.36-3.16-1.46-3.27-3.4h1.96c.1 1.05.82 1.87 2.65 1.87 1.96 0 2.4-.98 2.4-1.59 0-.83-.44-1.61-2.67-2.14-2.48-.6-4.18-1.62-4.18-3.67 0-1.72 1.39-2.84 3.11-3.21V4h2.67v1.95c1.86.45 2.79 1.86 2.85 3.39H14.3c-.05-1.11-.64-1.87-2.22-1.87-1.5 0-2.4.68-2.4 1.64 0 .84.65 1.39 2.67 1.91s4.18 1.39 4.18 3.91c-.01 1.83-1.38 2.83-3.12 3.16z" />
+        <symbol id="donation">
+            <path d="M0 0h24v24H0z" fill="none"></path>
+            <path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1.41 16.09V20h-2.67v-1.93c-1.71-.36-3.16-1.46-3.27-3.4h1.96c.1 1.05.82 1.87 2.65 1.87 1.96 0 2.4-.98 2.4-1.59 0-.83-.44-1.61-2.67-2.14-2.48-.6-4.18-1.62-4.18-3.67 0-1.72 1.39-2.84 3.11-3.21V4h2.67v1.95c1.86.45 2.79 1.86 2.85 3.39H14.3c-.05-1.11-.64-1.87-2.22-1.87-1.5 0-2.4.68-2.4 1.64 0 .84.65 1.39 2.67 1.91s4.18 1.39 4.18 3.91c-.01 1.83-1.38 2.83-3.12 3.16z"></path>
         </symbol>
-        <symbol id="icon-theme" viewBox="0 0 24 24">
-         <rect fill="none" height="24" width="24"/><path d="M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36c-0.98,1.37-2.58,2.26-4.4,2.26 c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"/>
+        <symbol id="icon-theme-auto" viewBox="-54 -54 620 620">
+            <!--! Font Awesome Pro 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
+            <path d="M448 256c0-106-86-192-192-192V448c106 0 192-86 192-192zM0 256a256 256 0 1 1 512 0A256 256 0 1 1 0 256z"></path>
+        </symbol>
+        <symbol id="icon-theme-light" viewBox="-54 -54 620 620">
+            <!--! Font Awesome Pro 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
+            <path d="M361.5 1.2c5 2.1 8.6 6.6 9.6 11.9L391 121l107.9 19.8c5.3 1 9.8 4.6 11.9 9.6s1.5 10.7-1.6 15.2L446.9 256l62.3 90.3c3.1 4.5 3.7 10.2 1.6 15.2s-6.6 8.6-11.9 9.6L391 391 371.1 498.9c-1 5.3-4.6 9.8-9.6 11.9s-10.7 1.5-15.2-1.6L256 446.9l-90.3 62.3c-4.5 3.1-10.2 3.7-15.2 1.6s-8.6-6.6-9.6-11.9L121 391 13.1 371.1c-5.3-1-9.8-4.6-11.9-9.6s-1.5-10.7 1.6-15.2L65.1 256 2.8 165.7c-3.1-4.5-3.7-10.2-1.6-15.2s6.6-8.6 11.9-9.6L121 121 140.9 13.1c1-5.3 4.6-9.8 9.6-11.9s10.7-1.5 15.2 1.6L256 65.1 346.3 2.8c4.5-3.1 10.2-3.7 15.2-1.6zM160 256a96 96 0 1 1 192 0 96 96 0 1 1 -192 0zm224 0a128 128 0 1 0 -256 0 128 128 0 1 0 256 0z"></path>
+        </symbol>
+        <symbol id="icon-theme-dark" viewBox="0 0 24 24">
+            <rect fill="none" height="24" width="24"></rect><path d="M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36c-0.98,1.37-2.58,2.26-4.4,2.26 c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path>
         </symbol>
         <symbol id="pair-device-icon" viewBox="0 0 640 512">
             <!--! Font Awesome Pro 6.2.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2022 Fonticons, Inc. -->
-            <path d="M579.8 267.7c56.5-56.5 56.5-148 0-204.5c-50-50-128.8-56.5-186.3-15.4l-1.6 1.1c-14.4 10.3-17.7 30.3-7.4 44.6s30.3 17.7 44.6 7.4l1.6-1.1c32.1-22.9 76-19.3 103.8 8.6c31.5 31.5 31.5 82.5 0 114L422.3 334.8c-31.5 31.5-82.5 31.5-114 0c-27.9-27.9-31.5-71.8-8.6-103.8l1.1-1.6c10.3-14.4 6.9-34.4-7.4-44.6s-34.4-6.9-44.6 7.4l-1.1 1.6C206.5 251.2 213 330 263 380c56.5 56.5 148 56.5 204.5 0L579.8 267.7zM60.2 244.3c-56.5 56.5-56.5 148 0 204.5c50 50 128.8 56.5 186.3 15.4l1.6-1.1c14.4-10.3 17.7-30.3 7.4-44.6s-30.3-17.7-44.6-7.4l-1.6 1.1c-32.1 22.9-76 19.3-103.8-8.6C74 372 74 321 105.5 289.5L217.7 177.2c31.5-31.5 82.5-31.5 114 0c27.9 27.9 31.5 71.8 8.6 103.9l-1.1 1.6c-10.3 14.4-6.9 34.4 7.4 44.6s34.4 6.9 44.6-7.4l1.1-1.6C433.5 260.8 427 182 377 132c-56.5-56.5-148-56.5-204.5 0L60.2 244.3z"/>
+            <path d="M579.8 267.7c56.5-56.5 56.5-148 0-204.5c-50-50-128.8-56.5-186.3-15.4l-1.6 1.1c-14.4 10.3-17.7 30.3-7.4 44.6s30.3 17.7 44.6 7.4l1.6-1.1c32.1-22.9 76-19.3 103.8 8.6c31.5 31.5 31.5 82.5 0 114L422.3 334.8c-31.5 31.5-82.5 31.5-114 0c-27.9-27.9-31.5-71.8-8.6-103.8l1.1-1.6c10.3-14.4 6.9-34.4-7.4-44.6s-34.4-6.9-44.6 7.4l-1.1 1.6C206.5 251.2 213 330 263 380c56.5 56.5 148 56.5 204.5 0L579.8 267.7zM60.2 244.3c-56.5 56.5-56.5 148 0 204.5c50 50 128.8 56.5 186.3 15.4l1.6-1.1c14.4-10.3 17.7-30.3 7.4-44.6s-30.3-17.7-44.6-7.4l-1.6 1.1c-32.1 22.9-76 19.3-103.8-8.6C74 372 74 321 105.5 289.5L217.7 177.2c31.5-31.5 82.5-31.5 114 0c27.9 27.9 31.5 71.8 8.6 103.9l-1.1 1.6c-10.3 14.4-6.9 34.4 7.4 44.6s34.4 6.9 44.6-7.4l1.1-1.6C433.5 260.8 427 182 377 132c-56.5-56.5-148-56.5-204.5 0L60.2 244.3z"></path>
         </symbol>
-        <symbol id="clear-pair-devices-icon" viewBox="0 0 640 512">
-            <!--! Font Awesome Pro 6.2.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2022 Fonticons, Inc. -->
-            <path d="M38.8 5.1C28.4-3.1 13.3-1.2 5.1 9.2S-1.2 34.7 9.2 42.9l592 464c10.4 8.2 25.5 6.3 33.7-4.1s6.3-25.5-4.1-33.7L489.3 358.2l90.5-90.5c56.5-56.5 56.5-148 0-204.5c-50-50-128.8-56.5-186.3-15.4l-1.6 1.1c-14.4 10.3-17.7 30.3-7.4 44.6s30.3 17.7 44.6 7.4l1.6-1.1c32.1-22.9 76-19.3 103.8 8.6c31.5 31.5 31.5 82.5 0 114l-96 96-31.9-25C430.9 239.6 420.1 175.1 377 132c-52.2-52.3-134.5-56.2-191.3-11.7L38.8 5.1zM239 162c30.1-14.9 67.7-9.9 92.8 15.3c20 20 27.5 48.3 21.7 74.5L239 162zM406.6 416.4L220.9 270c-2.1 39.8 12.2 80.1 42.2 110c38.9 38.9 94.4 51 143.6 36.3zm-290-228.5L60.2 244.3c-56.5 56.5-56.5 148 0 204.5c50 50 128.8 56.5 186.3 15.4l1.6-1.1c14.4-10.3 17.7-30.3 7.4-44.6s-30.3-17.7-44.6-7.4l-1.6 1.1c-32.1 22.9-76 19.3-103.8-8.6C74 372 74 321 105.5 289.5l61.8-61.8-50.6-39.9z"/>
+        <symbol id="edit-pair-devices-icon" viewBox="-159 25 640 512">
+            <!--! Font Awesome Pro 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
+            <!--! edited by @schlagmichdoch -->
+            <path d="M218,155.4c-56.5-56.5-148-56.5-204.5,0L-98.8,267.7c-56.5,56.5-56.5,148,0,204.5c50,50,128.8,56.5,186.3,15.4l1.6-1.1 c14.4-10.3,17.7-30.3,7.4-44.6s-30.3-17.7-44.6-7.4l-1.6,1.1c-32.1,22.9-76,19.3-103.8-8.6c-31.5-31.6-31.5-82.6,0-114.1L58.7,200.6 c31.5-31.5,82.5-31.5,114,0c15.8,15.8,23.8,36.7,23.6,57.6c7.9-8.3,18.9-13,30.6-13c4.5,0,8.9,0.7,13.2,2l17.4,5.5 c0.9-0.5,1.8-1,2.7-1.5C258.7,216.2,244.4,181.8,218,155.4z M420.8,86.6c-50-50-128.8-56.5-186.3-15.4l-1.6,1.1 c-14.4,10.3-17.7,30.3-7.4,44.6s30.3,17.7,44.6,7.4l1.6-1.1c32.1-22.9,76-19.3,103.8,8.6c25.8,25.8,30.5,64.7,14,95.2 c0.7,2,1.3,4,1.8,6.1l3.9,17.9c1.1,0.6,2.1,1.2,3.2,1.8l17.4-5.5c4.3-1.4,8.7-2,13.1-2c7.3,0,14.3,1.8,20.5,5.2 C474.7,196.8,465.1,130.9,420.8,86.6z M140.7,254.4l1.1-1.6c10.3-14.4,6.9-34.4-7.4-44.6s-34.4-6.9-44.6,7.4l-1.1,1.6 C47.5,274.6,54,353.4,104,403.4c18.7,18.7,41.2,31.2,65,37.5c-1.4-3.1-2.6-6.2-3.8-9.3c-6-16.4-1.5-34.6,11.6-46.4l7.2-6.6 c-12.7-3.6-24.7-10.5-34.8-20.5C121.4,330.3,117.8,286.4,140.7,254.4z"></path>
+            <path d="M458.9,407.4l-24.3-22.1c0.6-4.7,1-9.4,1-14.2s-0.3-9.6-1-14.2l24.3-22.1c3.9-3.5,5.4-8.9,3.6-13.8v-0.1 c-2.5-6.7-5.4-13.1-8.9-19.2l-2.6-4.5c-3.7-6.2-7.8-12-12.4-17.5c-3.3-4-8.8-5.4-13.7-3.8l-31.2,9.9c-7.5-5.8-15.8-10.6-24.7-14.2 l-7-32c-1.1-5.1-5-9.1-10.2-10c-7.7-1.3-15.7-2-23.8-2s-16.1,0.7-23.8,2c-5.2,0.9-9.1,4.9-10.2,10l-7,32 c-8.9,3.7-17.2,8.5-24.7,14.2l-31.2-9.9c-4.9-1.6-10.4-0.2-13.7,3.8c-4.5,5.5-8.7,11.3-12.4,17.5l-2.6,4.5 c-3.4,6.2-6.4,12.6-8.9,19.2c-1.8,4.9-0.3,10.3,3.6,13.8l24.3,22.1c-0.6,4.7-1,9.4-1,14.2s0.3,9.6,1,14.3L197,407.5 c-3.9,3.5-5.4,8.9-3.6,13.8c2.5,6.7,5.4,13.1,8.9,19.2l2.6,4.5c3.7,6.2,7.8,12,12.4,17.5c3.3,4,8.8,5.4,13.7,3.8l31.2-10 c7.5,5.8,15.8,10.6,24.7,14.2l7,32c1.1,5.1,5,9.1,10.2,10c7.7,1.3,15.7,2,23.8,2c8.1,0,16.1-0.7,23.8-2c5.2-0.8,9.1-4.9,10.2-10 l7-32c8.9-3.6,17.2-8.5,24.7-14.2l31.2,9.9c4.9,1.6,10.4,0.2,13.7-3.8c4.5-5.5,8.7-11.3,12.4-17.5l2.6-4.5 c3.4-6.2,6.4-12.6,8.9-19.2C464.2,416.3,462.7,410.9,458.9,407.4z M328,415.9c-24.8,0-44.9-20.1-44.9-44.8 c0-24.8,20.1-44.8,44.9-44.8s44.8,20.1,44.8,44.8C372.8,395.9,352.7,415.9,328,415.9z"></path>
+        </symbol>
+        <symbol id="edit-pen-icon" viewBox="0 0 512 512">
+            <!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
+            <path d="M362.7 19.3L314.3 67.7 444.3 197.7l48.4-48.4c25-25 25-65.5 0-90.5L453.3 19.3c-25-25-65.5-25-90.5 0zm-71 71L58.6 323.5c-10.4 10.4-18 23.3-22.2 37.4L1 481.2C-1.5 489.7 .8 498.8 7 505s15.3 8.5 23.7 6.1l120.3-35.4c14.1-4.2 27-11.8 37.4-22.2L421.7 220.3 291.7 90.3z"></path>
+        </symbol>
+        <symbol id="public-room-icon" viewBox="0 0 640 512">
+            <!--! Font Awesome Pro 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
+            <path d="M0 24C0 10.7 10.7 0 24 0H616c13.3 0 24 10.7 24 24s-10.7 24-24 24H24C10.7 48 0 37.3 0 24zM0 488c0-13.3 10.7-24 24-24H616c13.3 0 24 10.7 24 24s-10.7 24-24 24H24c-13.3 0-24-10.7-24-24zM83.2 160a64 64 0 1 1 128 0 64 64 0 1 1 -128 0zM32 320c0-35.3 28.7-64 64-64h96c12.2 0 23.7 3.4 33.4 9.4c-37.2 15.1-65.6 47.2-75.8 86.6H64c-17.7 0-32-14.3-32-32zm461.6 32c-10.3-40.1-39.6-72.6-77.7-87.4c9.4-5.5 20.4-8.6 32.1-8.6h96c35.3 0 64 28.7 64 64c0 17.7-14.3 32-32 32H493.6zM391.2 290.4c32.1 7.4 58.1 30.9 68.9 61.6c3.5 10 5.5 20.8 5.5 32c0 17.7-14.3 32-32 32h-224c-17.7 0-32-14.3-32-32c0-11.2 1.9-22 5.5-32c10.5-29.7 35.3-52.8 66.1-60.9c7.8-2.1 16-3.1 24.5-3.1h96c7.4 0 14.7 .8 21.6 2.4zm44-130.4a64 64 0 1 1 128 0 64 64 0 1 1 -128 0zM321.6 96a80 80 0 1 1 0 160 80 80 0 1 1 0-160z"></path>
+        </symbol>
+        <symbol id="icon-language-selector" viewBox="0 0 640 512">
+            <!--! Font Awesome Free 6.4.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. -->
+            <path d="M0 128C0 92.7 28.7 64 64 64H256h48 16H576c35.3 0 64 28.7 64 64V384c0 35.3-28.7 64-64 64H320 304 256 64c-35.3 0-64-28.7-64-64V128zm320 0V384H576V128H320zM178.3 175.9c-3.2-7.2-10.4-11.9-18.3-11.9s-15.1 4.7-18.3 11.9l-64 144c-4.5 10.1 .1 21.9 10.2 26.4s21.9-.1 26.4-10.2l8.9-20.1h73.6l8.9 20.1c4.5 10.1 16.3 14.6 26.4 10.2s14.6-16.3 10.2-26.4l-64-144zM160 233.2L179 276H141l19-42.8zM448 164c11 0 20 9 20 20v4h44 16c11 0 20 9 20 20s-9 20-20 20h-2l-1.6 4.5c-8.9 24.4-22.4 46.6-39.6 65.4c.9 .6 1.8 1.1 2.7 1.6l18.9 11.3c9.5 5.7 12.5 18 6.9 27.4s-18 12.5-27.4 6.9l-18.9-11.3c-4.5-2.7-8.8-5.5-13.1-8.5c-10.6 7.5-21.9 14-34 19.4l-3.6 1.6c-10.1 4.5-21.9-.1-26.4-10.2s.1-21.9 10.2-26.4l3.6-1.6c6.4-2.9 12.6-6.1 18.5-9.8l-12.2-12.2c-7.8-7.8-7.8-20.5 0-28.3s20.5-7.8 28.3 0l14.6 14.6 .5 .5c12.4-13.1 22.5-28.3 29.8-45H448 376c-11 0-20-9-20-20s9-20 20-20h52v-4c0-11 9-20 20-20z"></path>
+        </symbol>
+        <symbol id="i-cursor" viewBox="-180 0 640 512">
+            <!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2023 Fonticons, Inc.-->
+            <path d="M.1 29.3C-1.4 47 11.7 62.4 29.3 63.9l8 .7C70.5 67.3 96 95 96 128.3V224H64c-17.7 0-32 14.3-32 32s14.3 32 32 32H96v95.7c0 33.3-25.5 61-58.7 63.8l-8 .7C11.7 449.6-1.4 465 .1 482.7s16.9 30.7 34.5 29.2l8-.7c34.1-2.8 64.2-18.9 85.4-42.9c21.2 24 51.2 40.1 85.4 42.9l8 .7c17.6 1.5 33.1-11.6 34.5-29.2s-11.6-33.1-29.2-34.5l-8-.7C185.5 444.7 160 417 160 383.7V288h32c17.7 0 32-14.3 32-32s-14.3-32-32-32H160V128.3c0-33.3 25.5-61 58.7-63.8l8-.7c17.6-1.5 30.7-16.9 29.2-34.5S239-1.4 221.3 .1l-8 .7C179.2 3.6 149.2 19.7 128 43.7c-21.2-24-51.2-40-85.4-42.9l-8-.7C17-1.4 1.6 11.7 .1 29.3z"></path>
+        </symbol>
+        <symbol id="font" viewBox="-100 0 640 512">
+            <!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2023 Fonticons, Inc.-->
+            <path d="M254 52.8C249.3 40.3 237.3 32 224 32s-25.3 8.3-30 20.8L57.8 416H32c-17.7 0-32 14.3-32 32s14.3 32 32 32h96c17.7 0 32-14.3 32-32s-14.3-32-32-32h-1.8l18-48H303.8l18 48H320c-17.7 0-32 14.3-32 32s14.3 32 32 32h96c17.7 0 32-14.3 32-32s-14.3-32-32-32H390.2L254 52.8zM279.8 304H168.2L224 155.1 279.8 304z"></path>
+        </symbol>
+        <symbol id="file" viewBox="-130 0 650 530">
+            <!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2023 Fonticons, Inc.-->
+            <path d="M320 464c8.8 0 16-7.2 16-16V160H256c-17.7 0-32-14.3-32-32V48H64c-8.8 0-16 7.2-16 16V448c0 8.8 7.2 16 16 16H320zM0 64C0 28.7 28.7 0 64 0H229.5c17 0 33.3 6.7 45.3 18.7l90.5 90.5c12 12 18.7 28.3 18.7 45.3V448c0 35.3-28.7 64-64 64H64c-35.3 0-64-28.7-64-64V64z"></path>
+        </symbol>
+        <symbol id="caret" viewBox="0 0 320 512">
+            <!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2023 Fonticons, Inc.-->
+            <path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9s-16.6-19.8-29.6-19.8L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"></path>
+        </symbol>
+        <symbol id="mastodon" viewBox="0 0 448 512">
+            <!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2023 Fonticons, Inc.-->
+            <path d="M433 179.1c0-97.2-63.7-125.7-63.7-125.7-62.5-28.7-228.6-28.4-290.5 0 0 0-63.7 28.5-63.7 125.7 0 115.7-6.6 259.4 105.6 289.1 40.5 10.7 75.3 13 103.3 11.4 50.8-2.8 79.3-18.1 79.3-18.1l-1.7-36.9s-36.3 11.4-77.1 10.1c-40.4-1.4-83-4.4-89.6-54a102.5 102.5 0 0 1 -.9-13.9c85.6 20.9 158.7 9.1 178.8 6.7 56.1-6.7 105-41.3 111.2-72.9 9.8-49.8 9-121.5 9-121.5zm-75.1 125.2h-46.6v-114.2c0-49.7-64-51.6-64 6.9v62.5h-46.3V197c0-58.5-64-56.6-64-6.9v114.2H90.2c0-122.1-5.2-147.9 18.4-175 25.9-28.9 79.8-30.8 103.8 6.1l11.6 19.5 11.6-19.5c24.1-37.1 78.1-34.8 103.8-6.1 23.7 27.3 18.4 53 18.4 175z"></path>
+        </symbol>
+        <symbol id="bluesky" viewBox="0 0 512 512">
+            <!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.-->
+            <path d="M111.8 62.2C170.2 105.9 233 194.7 256 242.4c23-47.6 85.8-136.4 144.2-180.2c42.1-31.6 110.3-56 110.3 21.8c0 15.5-8.9 130.5-14.1 149.2C478.2 298 412 314.6 353.1 304.5c102.9 17.5 129.1 75.5 72.5 133.5c-107.4 110.2-154.3-27.6-166.3-62.9l0 0c-1.7-4.9-2.6-7.8-3.3-7.8s-1.6 3-3.3 7.8l0 0c-12 35.3-59 173.1-166.3 62.9c-56.5-58-30.4-116 72.5-133.5C100 314.6 33.8 298 15.7 233.1C10.4 214.4 1.5 99.4 1.5 83.9c0-77.8 68.2-53.4 110.3-21.8z"/>
+        </symbol>
+        <symbol id="custom" viewBox="0 0 512 512">
+            <!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2023 Fonticons, Inc.-->
+            <path d="M418.4 157.9c35.3-8.3 61.6-40 61.6-77.9c0-44.2-35.8-80-80-80c-43.4 0-78.7 34.5-80 77.5L136.2 151.1C121.7 136.8 101.9 128 80 128c-44.2 0-80 35.8-80 80s35.8 80 80 80c12.2 0 23.8-2.7 34.1-7.6L259.7 407.8c-2.4 7.6-3.7 15.8-3.7 24.2c0 44.2 35.8 80 80 80s80-35.8 80-80c0-27.7-14-52.1-35.4-66.4l37.8-207.7zM156.3 232.2c2.2-6.9 3.5-14.2 3.7-21.7l183.8-73.5c3.6 3.5 7.4 6.7 11.6 9.5L317.6 354.1c-5.5 1.3-10.8 3.1-15.8 5.5L156.3 232.2z"></path>
+        </symbol>
+        <symbol id="privacypolicy" viewBox="0 0 512 512">
+            <!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2023 Fonticons, Inc.-->
+            <path d="M256 0c4.6 0 9.2 1 13.4 2.9L457.7 82.8c22 9.3 38.4 31 38.3 57.2c-.5 99.2-41.3 280.7-213.6 363.2c-16.7 8-36.1 8-52.8 0C57.3 420.7 16.5 239.2 16 140c-.1-26.2 16.3-47.9 38.3-57.2L242.7 2.9C246.8 1 251.4 0 256 0zm0 66.8V444.8C394 378 431.1 230.1 432 141.4L256 66.8l0 0z"></path>
         </symbol>
     </svg>
     <!-- Scripts -->
-    <script src="scripts/util.js"></script>
-    <script src="scripts/network.js"></script>
-    <script src="scripts/ui.js"></script>
-    <script src="scripts/theme.js" async></script>
-    <script src="scripts/qrcode.js" async></script>
-    <script src="scripts/zip.min.js" async></script>
-    <script src="scripts/NoSleep.min.js" async></script>
+    <script src="scripts/localization.js" defer></script>
+    <script src="scripts/persistent-storage.js" defer></script>
+    <script src="scripts/ui-main.js" defer></script>
+    <script src="scripts/main.js" defer></script>
     <!-- Sounds -->
     <audio id="blop" autobuffer="true">
         <source src="sounds/blop.mp3" type="audio/mpeg">
@@ -340,3 +842,4 @@
         </x-noscript>
     </noscript>
 </body>
+</html>

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": "Запытана перадача файла"
+    }
+}