# felixrieseberg/windows95 architecture

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

- Interactive diagram: https://gitdiagram.com/felixrieseberg/windows95
- Repository: https://github.com/felixrieseberg/windows95

## Overview

windows95 is an Electron desktop app that runs a Windows 95 guest in the v86 emulator. The main workflow is launching the app, presenting start/settings controls, starting or restoring the virtual machine, and saving its state; users can also recover files from legacy state and exchange files through removable media or a read-only SMB share. Main-process menus and IPC control renderer actions, while the renderer owns the guest runtime and its networking adapters. Edges reflect shown calls, imports listed in the source index, or README claims; some unsampled subsystem internals are represented at their supported directory paths.

Main entry points: [`src/renderer/emulator.tsx`](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/emulator.tsx) (Emulator controller), [`src/main/main.ts`](https://github.com/felixrieseberg/windows95/blob/main/src/main/main.ts) (App lifecycle), [`src/main/menu.ts`](https://github.com/felixrieseberg/windows95/blob/main/src/main/menu.ts) (Machine menu), [`src/renderer/smb/index.ts`](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/smb/index.ts) (SMB share setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Electron host"]
  node_main["App lifecycle<br/>[main.ts]"]
  node_menu["Machine menu<br/>[menu.ts]"]
  node_ipc["IPC handlers<br/>[ipc.ts]"]
  node_window["App window<br/>[windows.ts]"]
  node_fileserver["Guest web files<br/>[fileserver.ts]"]
end

subgraph group_guest["Guest runtime"]
  node_app["Renderer app<br/>[app.tsx]"]
  node_emulator["Emulator controller<br/>[emulator.tsx]"]
  node_v86["v86 engine<br/>[libv86.js]"]
  node_start["Start controls<br/>[card-start.tsx]"]
  node_settings["Machine settings<br/>[card-settings.tsx]"]
  node_info["Emulator info<br/>[emulator-info.tsx]"]
  node_clipboard["Clipboard bridge<br/>[clipboard.ts]"]
end

subgraph group_storage["State and media"]
  node_state["State persistence<br/>[get-state-path.ts]"]
  node_reset["State reset<br/>[reset-state.ts]"]
  node_recovery["Legacy disk recovery"]
  node_disk["Disk image sizing<br/>[disk-image-size.ts]"]
  node_media["Removable media"]
end

subgraph group_network["Networking and sharing"]
  node_tcp["TCP relay<br/>[tcp-relay.ts]"]
  node_dns["DNS shim<br/>[dns-shim.ts]"]
  node_trace["TCP tracing<br/>[tcp-trace.ts]"]
  node_smb["SMB share setup<br/>[index.ts]"]
  node_smbserver["SMB server<br/>[server.ts]"]
  node_nbns["NetBIOS naming<br/>[nbns.ts]"]
end

node_user(("Desktop user"))

node_user -->|"launches"| node_main
node_main -->|"creates"| node_window
node_main -->|"sets up"| node_menu
node_main -->|"sets up"| node_ipc
node_main -->|"starts"| node_fileserver
node_window -.->|"loads"| node_app
node_app -->|"renders"| node_emulator
node_user -->|"operates"| node_menu
node_menu -->|"sends commands"| node_emulator
node_emulator -->|"reports status"| node_menu
node_emulator -->|"renders"| node_start
node_emulator -->|"renders"| node_settings
node_emulator -->|"renders"| node_info
node_emulator -.->|"starts guest"| node_v86
node_emulator -->|"loads and saves"| node_state
node_settings -->|"requests reset"| node_reset
node_reset -->|"resolves path"| node_state
node_emulator -->|"recovers files"| node_recovery
node_recovery -->|"checks image size"| node_disk
node_emulator -->|"sizes disk"| node_disk
node_emulator -->|"loads media"| node_media
node_emulator -->|"sets up relay"| node_tcp
node_emulator -->|"sets up shim"| node_dns
node_emulator -->|"sets up tracing"| node_trace
node_emulator -->|"sets up sharing"| node_smb
node_smb -->|"creates server"| node_smbserver
node_smb -->|"uses naming"| node_nbns
node_emulator -->|"sets up bridge"| node_clipboard

click node_main "https://github.com/felixrieseberg/windows95/blob/main/src/main/main.ts"
click node_menu "https://github.com/felixrieseberg/windows95/blob/main/src/main/menu.ts"
click node_ipc "https://github.com/felixrieseberg/windows95/blob/main/src/main/ipc.ts"
click node_window "https://github.com/felixrieseberg/windows95/blob/main/src/main/windows.ts"
click node_fileserver "https://github.com/felixrieseberg/windows95/blob/main/src/main/fileserver/fileserver.ts"
click node_app "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/app.tsx"
click node_emulator "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/emulator.tsx"
click node_v86 "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/lib/libv86.js"
click node_start "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/card-start.tsx"
click node_settings "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/card-settings.tsx"
click node_info "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/emulator-info.tsx"
click node_state "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/utils/get-state-path.ts"
click node_reset "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/utils/reset-state.ts"
click node_recovery "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/utils/recover-legacy-disk.ts"
click node_disk "https://github.com/felixrieseberg/windows95/blob/main/src/utils/disk-image-size.ts"
click node_media "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/sync-file-buffer.ts"
click node_tcp "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/net/tcp-relay.ts"
click node_dns "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/net/dns-shim.ts"
click node_trace "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/net/tcp-trace.ts"
click node_smb "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/smb/index.ts"
click node_smbserver "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/smb/server.ts"
click node_nbns "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/smb/nbns.ts"
click node_clipboard "https://github.com/felixrieseberg/windows95/blob/main/src/renderer/clipboard.ts"

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_menu,node_ipc,node_window,node_fileserver,node_user toneBlue
class node_app,node_emulator,node_v86,node_start,node_settings,node_info,node_clipboard toneAmber
class node_state,node_reset,node_recovery,node_disk,node_media toneMint
class node_tcp,node_dns,node_trace,node_smb,node_smbserver,node_nbns toneRose
```

## Components

### Electron host

- [App lifecycle](https://github.com/felixrieseberg/windows95/blob/main/src/main/main.ts): `src/main/main.ts`
- [Machine menu](https://github.com/felixrieseberg/windows95/blob/main/src/main/menu.ts): `src/main/menu.ts`
- [IPC handlers](https://github.com/felixrieseberg/windows95/blob/main/src/main/ipc.ts): `src/main/ipc.ts`
- [App window](https://github.com/felixrieseberg/windows95/blob/main/src/main/windows.ts): `src/main/windows.ts`
- [Guest web files](https://github.com/felixrieseberg/windows95/blob/main/src/main/fileserver/fileserver.ts): `src/main/fileserver/fileserver.ts`

### Guest runtime

- [Renderer app](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/app.tsx): `src/renderer/app.tsx`
- [Emulator controller](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/emulator.tsx): `src/renderer/emulator.tsx`
- [v86 engine](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/lib/libv86.js): `src/renderer/lib/libv86.js`
- [Start controls](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/card-start.tsx): `src/renderer/card-start.tsx`
- [Machine settings](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/card-settings.tsx): `src/renderer/card-settings.tsx`
- [Emulator info](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/emulator-info.tsx): `src/renderer/emulator-info.tsx`
- [Clipboard bridge](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/clipboard.ts): `src/renderer/clipboard.ts`

### State and media

- [State persistence](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/utils/get-state-path.ts): `src/renderer/utils/get-state-path.ts`
- [State reset](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/utils/reset-state.ts): `src/renderer/utils/reset-state.ts`
- [Legacy disk recovery](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/utils/recover-legacy-disk.ts): `src/renderer/utils/recover-legacy-disk.ts`
- [Disk image sizing](https://github.com/felixrieseberg/windows95/blob/main/src/utils/disk-image-size.ts): `src/utils/disk-image-size.ts`
- [Removable media](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/sync-file-buffer.ts): `src/renderer/sync-file-buffer.ts`

### Networking and sharing

- [TCP relay](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/net/tcp-relay.ts): `src/renderer/net/tcp-relay.ts`
- [DNS shim](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/net/dns-shim.ts): `src/renderer/net/dns-shim.ts`
- [TCP tracing](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/net/tcp-trace.ts): `src/renderer/net/tcp-trace.ts`
- [SMB share setup](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/smb/index.ts): `src/renderer/smb/index.ts`
- [SMB server](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/smb/server.ts): `src/renderer/smb/server.ts`
- [NetBIOS naming](https://github.com/felixrieseberg/windows95/blob/main/src/renderer/smb/nbns.ts): `src/renderer/smb/nbns.ts`

### Other components

- **Desktop user**

## Connections

- Desktop user → App lifecycle: launches (evidence: `src/main/main.ts`)
- App lifecycle → App window: creates (evidence: `src/main/main.ts`)
- App lifecycle → Machine menu: sets up (evidence: `src/main/main.ts`)
- App lifecycle → IPC handlers: sets up (evidence: `src/main/main.ts`)
- App lifecycle → Guest web files: starts (evidence: `src/main/main.ts`)
- App window → Renderer app: loads
- Renderer app → Emulator controller: renders (evidence: `src/renderer/app.tsx`)
- Desktop user → Machine menu: operates (evidence: `src/main/menu.ts`)
- Machine menu → Emulator controller: sends commands (evidence: `src/main/menu.ts`)
- Emulator controller → Machine menu: reports status (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → Start controls: renders (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → Machine settings: renders (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → Emulator info: renders (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → v86 engine: starts guest
- Emulator controller → State persistence: loads and saves (evidence: `src/renderer/emulator.tsx`)
- Machine settings → State reset: requests reset (evidence: `src/renderer/card-settings.tsx`)
- State reset → State persistence: resolves path (evidence: `src/renderer/utils/reset-state.ts`)
- Emulator controller → Legacy disk recovery: recovers files (evidence: `src/renderer/emulator.tsx`)
- Legacy disk recovery → Disk image sizing: checks image size (evidence: `src/renderer/utils/recover-legacy-disk.ts`)
- Emulator controller → Disk image sizing: sizes disk (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → Removable media: loads media (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → TCP relay: sets up relay (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → DNS shim: sets up shim (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → TCP tracing: sets up tracing (evidence: `src/renderer/emulator.tsx`)
- Emulator controller → SMB share setup: sets up sharing (evidence: `src/renderer/emulator.tsx`)
- SMB share setup → SMB server: creates server (evidence: `src/renderer/smb/index.ts`)
- SMB share setup → NetBIOS naming: uses naming (evidence: `src/renderer/smb/index.ts`)
- Emulator controller → Clipboard bridge: sets up bridge (evidence: `src/renderer/emulator.tsx`)
