# 0xjavlonbeck/trasmetto architecture

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

- Interactive diagram: https://gitdiagram.com/0xjavlonbeck/trasmetto
- Repository: https://github.com/0xjavlonbeck/trasmetto

## Overview

Trasmetto transfers files over HTTP in server and client modes. The server workflow is configured at the CLI, exposes file listings and downloads, accepts uploads, and offers optional archive, browser-management, authentication, and audit features. The client downloads or uploads to a remote server. The graph preserves the README’s major capabilities; several server subsystems are included from documented features and the source index, but their internal call relationships are omitted where excerpts do not establish them.

Main entry points: [`internal/server/server.go`](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/server.go) (Server and routes), [`cmd/trasmetto/main.go`](https://github.com/0xjavlonbeck/trasmetto/blob/main/cmd/trasmetto/main.go) (CLI entry point), [`internal/server/handlers.go`](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/handlers.go) (Browse and download), [`internal/client/download.go`](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/download.go) (Client transfers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and configuration"]
  node_cli["CLI entry point<br/>[main.go]"]
  node_config["Options and validation<br/>[config.go]"]
end

subgraph group_server["HTTP server"]
  node_servercore["Server and routes<br/>[server.go]"]
  node_handlers["Browse and download<br/>[handlers.go]"]
  node_filesystem["Filesystem access<br/>[filesystem.go]"]
  node_upload["Server uploads<br/>[upload.go]"]
  node_archive["ZIP downloads<br/>[archive.go]"]
  node_fileset["Fixed file sets<br/>[fileset.go]"]
  node_manage["Folder management<br/>[manage.go]"]
end

subgraph group_browser["Browser interface"]
  node_webui["Browser interactions<br/>[app.js]"]
  node_render["Page rendering<br/>[render.go]"]
  node_assets["Embedded web assets<br/>[assets.go]"]
end

subgraph group_client["Transfer client"]
  node_clientxfer["Client transfers<br/>[download.go]"]
  node_clientupload["Client uploads<br/>[upload.go]"]
  node_progress["Download progress<br/>[progress.go]"]
  node_httpclient["HTTP client setup<br/>[http.go]"]
end

subgraph group_operations["Security and operations"]
  node_auth["Authentication<br/>[auth.go]"]
  node_logging["Request logging<br/>[logging.go]"]
  node_eventlog["JSON event log<br/>[eventlog.go]"]
  node_throttle["Download limiting<br/>[throttle.go]"]
  node_netutil["TLS certificates<br/>[netutil.go]"]
end

node_user(("User"))
node_remote(("Remote HTTP server"))

node_user -->|"runs"| node_cli
node_cli -->|"parses options"| node_config
node_cli -->|"opens and configures"| node_eventlog
node_cli -->|"generates TLS"| node_netutil
node_cli -.->|"runs client mode"| node_clientxfer
node_cli -.->|"starts server mode"| node_servercore
node_user -->|"uses browser UI"| node_webui
node_webui -.->|"requests pages and actions"| node_servercore
node_servercore -->|"routes requests"| node_handlers
node_handlers -->|"dispatches POST"| node_upload
node_handlers -->|"resolves and lists files"| node_filesystem
node_handlers -->|"renders listings"| node_render
node_servercore -->|"registers archive route"| node_archive
node_servercore -->|"registers management route"| node_manage
node_servercore -->|"serves fixed-file mode"| node_fileset
node_clientxfer -->|"downloads over HTTP"| node_remote
node_clientupload -.->|"uploads over HTTP"| node_remote
node_clientxfer -->|"reports progress"| node_progress
node_clientxfer -->|"uses HTTP transport"| node_httpclient
node_auth -.->|"guards requests"| node_servercore
node_logging -.->|"records events"| node_eventlog
node_throttle -.->|"limits downloads"| node_handlers
node_assets -.->|"provides interface assets"| node_webui

click node_cli "https://github.com/0xjavlonbeck/trasmetto/blob/main/cmd/trasmetto/main.go"
click node_config "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/config/config.go"
click node_clientxfer "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/download.go"
click node_clientupload "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/upload.go"
click node_progress "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/progress.go"
click node_httpclient "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/http.go"
click node_servercore "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/server.go"
click node_handlers "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/handlers.go"
click node_filesystem "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/filesystem.go"
click node_upload "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/upload.go"
click node_archive "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/archive.go"
click node_fileset "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/fileset.go"
click node_manage "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/manage.go"
click node_webui "https://github.com/0xjavlonbeck/trasmetto/blob/main/static/js/app.js"
click node_render "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/render.go"
click node_assets "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/assets.go"
click node_auth "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/auth.go"
click node_logging "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/logging.go"
click node_eventlog "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/eventlog.go"
click node_throttle "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/throttle.go"
click node_netutil "https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/netutil/netutil.go"

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_cli,node_config,node_user toneBlue
class node_servercore,node_handlers,node_filesystem,node_upload,node_archive,node_fileset,node_manage toneAmber
class node_webui,node_render,node_assets,node_remote toneMint
class node_clientxfer,node_clientupload,node_progress,node_httpclient toneRose
class node_auth,node_logging,node_eventlog,node_throttle,node_netutil toneIndigo
```

## Components

### CLI and configuration

- [CLI entry point](https://github.com/0xjavlonbeck/trasmetto/blob/main/cmd/trasmetto/main.go): `cmd/trasmetto/main.go`
- [Options and validation](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/config/config.go): `internal/config/config.go`

### HTTP server

- [Server and routes](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/server.go): `internal/server/server.go`
- [Browse and download](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/handlers.go): `internal/server/handlers.go`
- [Filesystem access](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/filesystem.go): `internal/server/filesystem.go`
- [Server uploads](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/upload.go): `internal/server/upload.go`
- [ZIP downloads](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/archive.go): `internal/server/archive.go`
- [Fixed file sets](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/fileset.go): `internal/server/fileset.go`
- [Folder management](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/manage.go): `internal/server/manage.go`

### Browser interface

- [Browser interactions](https://github.com/0xjavlonbeck/trasmetto/blob/main/static/js/app.js): `static/js/app.js`
- [Page rendering](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/render.go): `internal/server/render.go`
- [Embedded web assets](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/assets.go): `internal/server/assets.go`

### Transfer client

- [Client transfers](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/download.go): `internal/client/download.go`
- [Client uploads](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/upload.go): `internal/client/upload.go`
- [Download progress](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/progress.go): `internal/client/progress.go`
- [HTTP client setup](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/client/http.go): `internal/client/http.go`

### Security and operations

- [Authentication](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/auth.go): `internal/server/auth.go`
- [Request logging](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/logging.go): `internal/server/logging.go`
- [JSON event log](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/eventlog.go): `internal/server/eventlog.go`
- [Download limiting](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/server/throttle.go): `internal/server/throttle.go`
- [TLS certificates](https://github.com/0xjavlonbeck/trasmetto/blob/main/internal/netutil/netutil.go): `internal/netutil/netutil.go`

### Other components

- **User**
- **Remote HTTP server**

## Connections

- User → CLI entry point: runs (evidence: `README.md`)
- CLI entry point → Options and validation: parses options (evidence: `cmd/trasmetto/main.go`)
- CLI entry point → JSON event log: opens and configures (evidence: `cmd/trasmetto/main.go`)
- CLI entry point → TLS certificates: generates TLS (evidence: `cmd/trasmetto/main.go`)
- CLI entry point → Client transfers: runs client mode
- CLI entry point → Server and routes: starts server mode
- User → Browser interactions: uses browser UI (evidence: `README.md`)
- Browser interactions → Server and routes: requests pages and actions
- Server and routes → Browse and download: routes requests (evidence: `internal/server/server.go`)
- Browse and download → Server uploads: dispatches POST (evidence: `internal/server/handlers.go`)
- Browse and download → Filesystem access: resolves and lists files (evidence: `internal/server/handlers.go`)
- Browse and download → Page rendering: renders listings (evidence: `internal/server/handlers.go`)
- Server and routes → ZIP downloads: registers archive route (evidence: `internal/server/server.go`)
- Server and routes → Folder management: registers management route (evidence: `internal/server/server.go`)
- Server and routes → Fixed file sets: serves fixed-file mode (evidence: `internal/server/server.go`)
- Client transfers → Remote HTTP server: downloads over HTTP (evidence: `internal/client/download.go`)
- Client uploads → Remote HTTP server: uploads over HTTP
- Client transfers → Download progress: reports progress (evidence: `internal/client/download.go`)
- Client transfers → HTTP client setup: uses HTTP transport (evidence: `internal/client/download.go`)
- Authentication → Server and routes: guards requests
- Request logging → JSON event log: records events
- Download limiting → Browse and download: limits downloads
- Embedded web assets → Browser interactions: provides interface assets
