How felixrieseberg/windows95 works
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: emulator.tsx Emulator controller · main.ts App lifecycle · menu.ts Machine menu · index.ts SMB share setup
Components 24
Electron host
- App lifecycle
src/main/main.ts - Machine menu
src/main/menu.ts - IPC handlers
src/main/ipc.ts - App window
src/main/windows.ts - Guest web files
src/main/fileserver/fileserver.ts
Guest runtime
- Renderer app
src/renderer/app.tsx - Emulator controller
src/renderer/emulator.tsx - v86 engine
src/renderer/lib/libv86.js - Start controls
src/renderer/card-start.tsx - Machine settings
src/renderer/card-settings.tsx - Emulator info
src/renderer/emulator-info.tsx - Clipboard bridge
src/renderer/clipboard.ts
State and media
- State persistence
src/renderer/utils/get-state-path.ts - State reset
src/renderer/utils/reset-state.ts - Legacy disk recovery
src/renderer/utils/recover-legacy-disk.ts - Disk image sizing
src/utils/disk-image-size.ts - Removable media
src/renderer/sync-file-buffer.ts
Networking and sharing
- TCP relay
src/renderer/net/tcp-relay.ts - DNS shim
src/renderer/net/dns-shim.ts - TCP tracing
src/renderer/net/tcp-trace.ts - SMB share setup
src/renderer/smb/index.ts - SMB server
src/renderer/smb/server.ts - NetBIOS naming
src/renderer/smb/nbns.ts
Other components
- Desktop user
Connections 28
- Desktop user → App lifecycle: launches
src/main/main.ts - App lifecycle → App window: creates
src/main/main.ts - App lifecycle → Machine menu: sets up
src/main/main.ts - App lifecycle → IPC handlers: sets up
src/main/main.ts - App lifecycle → Guest web files: starts
src/main/main.ts - App window → Renderer app: loads
- Renderer app → Emulator controller: renders
src/renderer/app.tsx - Desktop user → Machine menu: operates
src/main/menu.ts - Machine menu → Emulator controller: sends commands
src/main/menu.ts - Emulator controller → Machine menu: reports status
src/renderer/emulator.tsx - Emulator controller → Start controls: renders
src/renderer/emulator.tsx - Emulator controller → Machine settings: renders
src/renderer/emulator.tsx - Emulator controller → Emulator info: renders
src/renderer/emulator.tsx - Emulator controller → v86 engine: starts guest
- Emulator controller → State persistence: loads and saves
src/renderer/emulator.tsx - Machine settings → State reset: requests reset
src/renderer/card-settings.tsx - State reset → State persistence: resolves path
src/renderer/utils/reset-state.ts - Emulator controller → Legacy disk recovery: recovers files
src/renderer/emulator.tsx - Legacy disk recovery → Disk image sizing: checks image size
src/renderer/utils/recover-legacy-disk.ts - Emulator controller → Disk image sizing: sizes disk
src/renderer/emulator.tsx - Emulator controller → Removable media: loads media
src/renderer/emulator.tsx - Emulator controller → TCP relay: sets up relay
src/renderer/emulator.tsx - Emulator controller → DNS shim: sets up shim
src/renderer/emulator.tsx - Emulator controller → TCP tracing: sets up tracing
src/renderer/emulator.tsx - Emulator controller → SMB share setup: sets up sharing
src/renderer/emulator.tsx - SMB share setup → SMB server: creates server
src/renderer/smb/index.ts - SMB share setup → NetBIOS naming: uses naming
src/renderer/smb/index.ts - Emulator controller → Clipboard bridge: sets up bridge
src/renderer/emulator.tsx