# gypsy-server/gypsyv0 architecture

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

- Interactive diagram: https://gitdiagram.com/gypsy-server/gypsyv0
- Repository: https://github.com/gypsy-server/gypsyv0

## Overview

This is ESP8266 firmware for a standalone Wi-Fi file viewer backed by an SPI SD card. The documented workflow is to flash the firmware, obtain its IP from the Serial Monitor, and open that address in a browser; users can browse and view files, including audio and video, and upload files. The repository provides no source excerpts, so the diagram uses the single firmware file for its functional components and relies on README statements for relationships; internal call structure is not verified.

Main entry points: [`src/gypsy.ino`](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino) (File browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Device setup"]
end

subgraph group_firmware["File viewer"]
  node_esp["ESP8266 firmware<br/>[gypsy.ino]"]
  node_web["Local web interface<br/>[gypsy.ino]"]
  node_browse["File browsing<br/>[gypsy.ino]"]
  node_upload["File upload<br/>[gypsy.ino]"]
end

subgraph group_storage["Storage and media"]
  node_sd[("SD card<br/>[gypsy.ino]")]
  node_audio["Audio playback<br/>[gypsy.ino]"]
  node_video["Video viewing<br/>[gypsy.ino]"]
end

node_operator(("Device operator"))
node_browser["Web browser"]
node_serial["Serial Monitor"]

node_operator -->|"checks IP"| node_serial
node_operator -->|"opens address"| node_browser
node_browser -->|"accesses over Wi-Fi"| node_web
node_esp -->|"reports IP"| node_serial
node_web -->|"offers browsing"| node_browse
node_browse -->|"reads files"| node_sd
node_upload -->|"stores files"| node_sd
node_web -->|"supports upload"| node_upload
node_browse -->|"opens audio"| node_audio
node_browse -->|"opens video"| node_video

click node_esp "https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino"
click node_web "https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino"
click node_browse "https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino"
click node_upload "https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino"
click node_sd "https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino"
click node_audio "https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino"
click node_video "https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino"

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_esp,node_web,node_browse,node_upload toneAmber
class node_sd,node_audio,node_video toneMint
class node_operator,node_serial toneIndigo
class node_browser toneBlue
```

## Components

### File viewer

- [ESP8266 firmware](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino): `src/gypsy.ino`
- [Local web interface](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino): `src/gypsy.ino`
- [File browsing](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino): `src/gypsy.ino`
- [File upload](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino): `src/gypsy.ino`

### Storage and media

- [SD card](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino): `src/gypsy.ino`
- [Audio playback](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino): `src/gypsy.ino`
- [Video viewing](https://github.com/gypsy-server/gypsyv0/blob/main/src/gypsy.ino): `src/gypsy.ino`

### Other components

- **Device operator**
- **Web browser**
- **Serial Monitor**

## Connections

- Device operator → Serial Monitor: checks IP (evidence: `README.md`)
- Device operator → Web browser: opens address (evidence: `README.md`)
- Web browser → Local web interface: accesses over Wi-Fi (evidence: `README.md`)
- ESP8266 firmware → Serial Monitor: reports IP (evidence: `README.md`)
- Local web interface → File browsing: offers browsing (evidence: `README.md`)
- File browsing → SD card: reads files (evidence: `README.md`)
- File upload → SD card: stores files (evidence: `README.md`)
- Local web interface → File upload: supports upload (evidence: `README.md`)
- File browsing → Audio playback: opens audio (evidence: `README.md`)
- File browsing → Video viewing: opens video (evidence: `README.md`)
