# lnblxj/sharethisfolder architecture

> Architecture diagram of the GitHub repository lnblxj/sharethisfolder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lnblxj/sharethisfolder
- Repository: https://github.com/lnblxj/sharethisfolder

## Overview

ShareThisFolder is a Windows folder-sharing host: the user launches it from a folder, the app serves that folder over HTTP, and the user shares a LAN or (if available) public URL. The main menu also supports copying URLs, QR codes, settings, and Explorer quick launch. Public access tries UPnP before the STUN tunnel fallback. The graph follows the sampled main, HTTP, and STUN code plus README capabilities; some subsystem links are documented rather than verified in implementation excerpts.

Main entry points: [`src/app/main.cpp`](https://github.com/lnblxj/sharethisfolder/blob/main/src/app/main.cpp) (Startup and menu), [`src/http/server.cpp`](https://github.com/lnblxj/sharethisfolder/blob/main/src/http/server.cpp) (HTTP file server), [`src/net/stun_client.cpp`](https://github.com/lnblxj/sharethisfolder/blob/main/src/net/stun_client.cpp) (STUN tunnel), [`src/net/upnp_client.cpp`](https://github.com/lnblxj/sharethisfolder/blob/main/src/net/upnp_client.cpp) (UPnP mapping)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Host app"]
  node_main["Startup and menu<br/>[main.cpp]"]
  node_console["Console UI<br/>[console.cpp]"]
  node_settings["Settings menu<br/>[settings_menu.cpp]"]
  node_localization["Localization<br/>[i18n.cpp]"]
end

subgraph group_sharing["Folder sharing"]
  node_folder[("Shared folder")]
  node_http["HTTP file server<br/>[server.cpp]"]
end

subgraph group_network["Network access"]
  node_network["IP and port discovery<br/>[network.cpp]"]
  node_upnp["UPnP mapping<br/>[upnp_client.cpp]"]
  node_stun["STUN tunnel<br/>[stun_client.cpp]"]
end

subgraph group_platform["Windows integration"]
  node_quicklaunch["Quick launch<br/>[quick_launch.cpp]"]
end

node_user(("Folder owner"))
node_windows["Windows system"]
node_browser(("Phone or browser"))
node_router["UPnP router"]
node_stunservice["STUN service"]
node_qr["QR code service"]

node_user -->|"launches"| node_main
node_main -->|"discovers addresses"| node_network
node_main -->|"starts server"| node_http
node_main -->|"shares current folder"| node_folder
node_browser -->|"requests files"| node_http
node_http -->|"reads files"| node_folder
node_main -->|"clears display"| node_console
node_main -->|"gets UI text"| node_localization
node_http -->|"gets error text"| node_localization
node_main -->|"opens settings"| node_settings
node_settings -->|"installs or removes"| node_quicklaunch
node_main -->|"handles admin command"| node_quicklaunch
node_quicklaunch -->|"configures Explorer"| node_windows
node_main -->|"downloads QR image"| node_qr
node_main -->|"tries port mapping"| node_upnp
node_upnp -.->|"maps port"| node_router
node_main -->|"starts fallback tunnel"| node_stun
node_stun -->|"discovers endpoint"| node_stunservice
node_stun -->|"maps tunnel port"| node_upnp

click node_main "https://github.com/lnblxj/sharethisfolder/blob/main/src/app/main.cpp"
click node_console "https://github.com/lnblxj/sharethisfolder/blob/main/src/app/console.cpp"
click node_settings "https://github.com/lnblxj/sharethisfolder/blob/main/src/app/settings_menu.cpp"
click node_localization "https://github.com/lnblxj/sharethisfolder/blob/main/src/util/i18n.cpp"
click node_quicklaunch "https://github.com/lnblxj/sharethisfolder/blob/main/src/app/quick_launch.cpp"
click node_http "https://github.com/lnblxj/sharethisfolder/blob/main/src/http/server.cpp"
click node_network "https://github.com/lnblxj/sharethisfolder/blob/main/src/net/network.cpp"
click node_upnp "https://github.com/lnblxj/sharethisfolder/blob/main/src/net/upnp_client.cpp"
click node_stun "https://github.com/lnblxj/sharethisfolder/blob/main/src/net/stun_client.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_console,node_settings,node_localization,node_browser toneBlue
class node_folder,node_http toneAmber
class node_network,node_upnp,node_stun,node_router toneMint
class node_quicklaunch toneRose
class node_user,node_windows,node_stunservice,node_qr toneIndigo
```

## Components

### Host app

- [Startup and menu](https://github.com/lnblxj/sharethisfolder/blob/main/src/app/main.cpp): `src/app/main.cpp`
- [Console UI](https://github.com/lnblxj/sharethisfolder/blob/main/src/app/console.cpp): `src/app/console.cpp`
- [Settings menu](https://github.com/lnblxj/sharethisfolder/blob/main/src/app/settings_menu.cpp): `src/app/settings_menu.cpp`
- [Localization](https://github.com/lnblxj/sharethisfolder/blob/main/src/util/i18n.cpp): `src/util/i18n.cpp`

### Folder sharing

- **Shared folder**
- [HTTP file server](https://github.com/lnblxj/sharethisfolder/blob/main/src/http/server.cpp): `src/http/server.cpp`

### Network access

- [IP and port discovery](https://github.com/lnblxj/sharethisfolder/blob/main/src/net/network.cpp): `src/net/network.cpp`
- [UPnP mapping](https://github.com/lnblxj/sharethisfolder/blob/main/src/net/upnp_client.cpp): `src/net/upnp_client.cpp`
- [STUN tunnel](https://github.com/lnblxj/sharethisfolder/blob/main/src/net/stun_client.cpp): `src/net/stun_client.cpp`

### Windows integration

- [Quick launch](https://github.com/lnblxj/sharethisfolder/blob/main/src/app/quick_launch.cpp): `src/app/quick_launch.cpp`

### Other components

- **Folder owner**
- **Windows system**
- **Phone or browser**
- **UPnP router**
- **STUN service**
- **QR code service**

## Connections

- Folder owner → Startup and menu: launches (evidence: `README.md`)
- Startup and menu → IP and port discovery: discovers addresses (evidence: `src/app/main.cpp`)
- Startup and menu → HTTP file server: starts server (evidence: `src/app/main.cpp`)
- Startup and menu → Shared folder: shares current folder (evidence: `src/app/main.cpp`)
- Phone or browser → HTTP file server: requests files (evidence: `README.md`)
- HTTP file server → Shared folder: reads files (evidence: `src/http/server.cpp`)
- Startup and menu → Console UI: clears display (evidence: `src/app/main.cpp`)
- Startup and menu → Localization: gets UI text (evidence: `src/app/main.cpp`)
- HTTP file server → Localization: gets error text (evidence: `src/http/server.cpp`)
- Startup and menu → Settings menu: opens settings (evidence: `src/app/main.cpp`)
- Settings menu → Quick launch: installs or removes (evidence: `src/app/settings_menu.cpp`)
- Startup and menu → Quick launch: handles admin command (evidence: `src/app/main.cpp`)
- Quick launch → Windows system: configures Explorer (evidence: `README.md`)
- Startup and menu → QR code service: downloads QR image (evidence: `src/app/main.cpp`)
- Startup and menu → UPnP mapping: tries port mapping (evidence: `src/app/main.cpp`)
- UPnP mapping → UPnP router: maps port
- Startup and menu → STUN tunnel: starts fallback tunnel (evidence: `src/app/main.cpp`)
- STUN tunnel → STUN service: discovers endpoint (evidence: `src/net/stun_client.cpp`)
- STUN tunnel → UPnP mapping: maps tunnel port (evidence: `src/net/stun_client.cpp`)
