How maeneko/senboost works
SenBoost is an Electron desktop wrapper for zapret that lets users select and run a platform-specific packet-filtering strategy, manage lists and preferences, and check connectivity. The main process coordinates the window, tray, IPC, and recovery; the zapret layer selects a platform engine and prepares the strategy for it. The README documents Windows, macOS, and Linux backends, plus shared strategies. Some renderer-to-main IPC wiring and unsampled subsystems are represented only where documented or left unconnected; paths identify existing implementation files.
Main entry points: zapret/index.ts Zapret coordinator · main/index.ts Main process · paths.ts Runtime paths · engine.ts Engine state
Components 29
Desktop interface
- App view
src/renderer/src/App.tsx - Zapret controls
src/renderer/src/components/ZapretCard.tsx - Settings view
src/renderer/src/components/SettingsView.tsx - List editor
src/renderer/src/components/ListEditor.tsx - Renderer hooks
src/renderer/src/hooks/useZapret.ts - Diagnostics hook
src/renderer/src/hooks/useZapretDiagnostics.ts - List hooks
src/renderer/src/hooks/useZapretLists.ts - List metadata
src/renderer/src/lib/zapretListMeta.ts
Application shell
- Main process
src/main/index.ts - IPC handlers
src/main/ipc.ts - Preload bridge
src/preload/index.ts - IPC contract
src/shared/ipc-contract.ts - Window lifecycle
src/main/window.ts - System tray
src/main/tray.ts - Autostart
src/main/app-autostart.ts - App preferences
src/main/settings.ts
Zapret control
- Zapret coordinator
src/main/zapret/index.ts - Strategy configuration
src/main/zapret/strategies.ts - User lists
src/main/zapret/lists.ts - Connectivity diagnostics
src/main/zapret/diagnostics.ts
Platform runtimes
- Engine state
src/main/zapret/engine.ts - Windows engine
src/main/zapret/engine.win32.ts - Windows service
src/main/zapret/service.win32.ts - macOS engine
src/main/zapret/engine.darwin.ts - utunws runtime
src/main/zapret/utunws.darwin.ts - Linux engine
src/main/zapret/engine.linux.ts - nfqws runtime
src/main/zapret/nfqws.linux.ts - Runtime paths
src/main/zapret/paths.ts
Other components
- User
Connections 48
- User → App view: uses
- App view → Zapret controls: renders
src/renderer/src/App.tsx - App view → Settings view: renders
src/renderer/src/App.tsx - Settings view → List editor: renders
src/renderer/src/components/SettingsView.tsx - Settings view → List hooks: uses
src/renderer/src/components/SettingsView.tsx - Settings view → List metadata: uses
src/renderer/src/components/SettingsView.tsx - List editor → List metadata: uses
src/renderer/src/components/ListEditor.tsx - Zapret controls → Renderer hooks: uses
src/renderer/src/components/ZapretCard.tsx - Zapret controls → Diagnostics hook: uses
src/renderer/src/components/ZapretCard.tsx - Renderer hooks → Preload bridge: invokes API
- Diagnostics hook → Preload bridge: invokes API
- List hooks → Preload bridge: invokes API
- Main process → IPC handlers: registers
src/main/index.ts - Main process → Window lifecycle: creates
src/main/index.ts - Main process → System tray: creates
src/main/index.ts - Main process → App preferences: loads
src/main/index.ts - Main process → Zapret coordinator: recovers
src/main/index.ts - Main process → Autostart: follows
src/main/index.ts - IPC handlers → Zapret coordinator: dispatches
src/main/ipc.ts - IPC handlers → App preferences: uses
src/main/ipc.ts - IPC handlers → IPC contract: uses types
src/main/ipc.ts - Preload bridge → IPC contract: uses types
src/preload/index.ts - System tray → Zapret coordinator: starts or stops
src/main/tray.ts - System tray → Engine state: observes status
src/main/tray.ts - Zapret coordinator → Windows engine: selects on Windows
src/main/zapret/index.ts - Zapret coordinator → macOS engine: selects on macOS
src/main/zapret/index.ts - Zapret coordinator → Linux engine: selects on Linux
src/main/zapret/index.ts - Zapret coordinator → User lists: reads and edits
src/main/zapret/index.ts - Zapret coordinator → Strategy configuration: lists strategies
src/main/zapret/index.ts - Zapret coordinator → Connectivity diagnostics: runs checks
src/main/zapret/index.ts - Zapret coordinator → Engine state: uses status API
src/main/zapret/index.ts - Engine state → App preferences: persists preferences
src/main/zapret/engine.ts - Windows engine → Engine state: extends
src/main/zapret/engine.win32.ts - Windows engine → Strategy configuration: parses marker
src/main/zapret/engine.win32.ts - Windows engine → Windows service: queries or stops
src/main/zapret/engine.win32.ts - Windows engine → Runtime paths: uses executable paths
src/main/zapret/engine.win32.ts - macOS engine → Engine state: extends
src/main/zapret/engine.darwin.ts - macOS engine → Strategy configuration: builds config
src/main/zapret/engine.darwin.ts - macOS engine → utunws runtime: starts and stops
src/main/zapret/engine.darwin.ts - macOS engine → Runtime paths: checks executable
src/main/zapret/engine.darwin.ts - Linux engine → Engine state: extends
src/main/zapret/engine.linux.ts - Linux engine → Strategy configuration: builds config
src/main/zapret/engine.linux.ts - Linux engine → nfqws runtime: starts and stops
src/main/zapret/engine.linux.ts - Linux engine → Runtime paths: uses paths
- Windows service → Runtime paths: uses service paths
src/main/zapret/service.win32.ts - utunws runtime → Runtime paths: uses paths
src/main/zapret/utunws.darwin.ts - nfqws runtime → Runtime paths: uses paths
src/main/zapret/nfqws.linux.ts - Strategy configuration → Runtime paths: resolves list and fake paths
src/main/zapret/strategies.ts