# deeptho/neumodvb architecture

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

- Interactive diagram: https://gitdiagram.com/deeptho/neumodvb
- Repository: https://github.com/deeptho/neumodvb

## Overview

NeumoDVB is a Linux DVB receiver and TV/recording application. The documented user workflow configures frontends and LNBs, finds muxes by manual entry or scanning, discovers services, then tunes, watches, or records them. Separate capabilities include EPG collection, spectrum analysis, blindscan, positioner control, encrypted-stream viewing, and IQ constellation display. The graph combines those documented capabilities with sampled GUI, receiver, and database implementation evidence; several feature-specific implementation paths are therefore directory-level rather than verified source files.

Main entry points: [`src/receiver/receiver.h`](https://github.com/deeptho/neumodvb/blob/master/src/receiver/receiver.h) (Receiver control), [`src/receiver/active_service.cc`](https://github.com/deeptho/neumodvb/blob/master/src/receiver/active_service.cc) (Active service), [`src/receiver/scan.cc`](https://github.com/deeptho/neumodvb/blob/master/src/receiver/scan.cc) (Mux and blindscan), [`src/neumodb/neumodb.cc`](https://github.com/deeptho/neumodvb/blob/master/src/neumodb/neumodb.cc) (Database engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Desktop interface"]
  node_app["GUI application<br/>[neumodvb.py]"]
  node_lists["Configuration lists"]
  node_grid["Grid framework<br/>[neumolist.py]"]
  node_dialogs["Dialogs"]
  node_serviceui["Service list<br/>[servicelist.py]"]
end

subgraph group_receive["DVB reception"]
  node_frontend["Frontend manager<br/>[devmanager.cc]"]
  node_receiver["Receiver control<br/>[receiver.h]"]
  node_tuner["Tuner hardware<br/>[neumo-frontend.h]"]
  node_scan["Mux and blindscan<br/>[scan.cc]"]
  node_spectrum["Spectrum analysis<br/>[spectrum_algo1.cc]"]
  node_positioner["Positioner control"]
end

subgraph group_media["Program services"]
  node_service["Active service<br/>[active_service.cc]"]
  node_parser["Stream parsing<br/>[streamparser.h]"]
  node_viewer["Live viewing<br/>[neumompv.cc]"]
  node_recording["Recording<br/>[recmgr.cc]"]
  node_epg["EPG scanning<br/>[events.cc]"]
  node_encryption["Encrypted streams<br/>[active_service.cc]"]
end

subgraph group_store["Application data"]
  node_chdb[("Channel database<br/>[chdb_extra.cc]")]
  node_devdb[("Device database<br/>[devdb_extra.cc]")]
  node_epgdb[("EPG database<br/>[epgdb_extra.cc]")]
  node_recdb[("Recording database<br/>[recdb_extra.cc]")]
  node_dbui["Database UI helpers<br/>[neumodbutils.py]"]
  node_coredb[("Database engine<br/>[neumodb.cc]")]
end

node_user(("Operator"))
node_oscam["OScam"]

node_user -->|"starts"| node_app
node_app -->|"creates"| node_receiver
node_user -->|"configures"| node_lists
node_lists -.->|"sets up"| node_frontend
node_user -->|"scans muxes"| node_scan
node_user -->|"requests spectrum"| node_spectrum
node_user -->|"controls"| node_positioner
node_receiver -->|"manages"| node_frontend
node_frontend -->|"controls"| node_tuner
node_receiver -.->|"runs scans"| node_scan
node_scan -->|"discovers services"| node_chdb
node_receiver -.->|"tunes"| node_service
node_service -->|"parses streams"| node_parser
node_service -.->|"feeds playback"| node_viewer
node_service -->|"starts recording"| node_recording
node_service -->|"decrypts"| node_encryption
node_encryption -.->|"uses"| node_oscam
node_receiver -.->|"scans EPG"| node_epg
node_epg -.->|"stores listings"| node_epgdb
node_recording -.->|"stores recordings"| node_recdb
node_scan -.->|"uses device setup"| node_devdb
node_scan -.->|"stores muxes"| node_chdb
node_grid -->|"uses"| node_dbui
node_serviceui -->|"extends"| node_grid
node_serviceui -->|"writes services"| node_chdb
node_coredb -.->|"backs"| node_chdb
node_coredb -.->|"backs"| node_devdb
node_coredb -.->|"backs"| node_epgdb
node_coredb -.->|"backs"| node_recdb

click node_app "https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb.py"
click node_lists "https://github.com/deeptho/neumodvb/tree/master/gui/neumodvb"
click node_grid "https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/neumolist.py"
click node_dialogs "https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/neumo_dialogs_gui.py"
click node_frontend "https://github.com/deeptho/neumodvb/blob/master/src/receiver/devmanager.cc"
click node_receiver "https://github.com/deeptho/neumodvb/blob/master/src/receiver/receiver.h"
click node_tuner "https://github.com/deeptho/neumodvb/blob/master/src/receiver/neumo-frontend.h"
click node_scan "https://github.com/deeptho/neumodvb/blob/master/src/receiver/scan.cc"
click node_spectrum "https://github.com/deeptho/neumodvb/blob/master/src/receiver/spectrum_algo1.cc"
click node_positioner "https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/positioner_dialog.py"
click node_service "https://github.com/deeptho/neumodvb/blob/master/src/receiver/active_service.cc"
click node_parser "https://github.com/deeptho/neumodvb/blob/master/src/receiver/streamparser/streamparser.h"
click node_viewer "https://github.com/deeptho/neumodvb/blob/master/src/viewer/neumompv.cc"
click node_recording "https://github.com/deeptho/neumodvb/blob/master/src/receiver/recmgr.cc"
click node_epg "https://github.com/deeptho/neumodvb/blob/master/src/receiver/streamparser/events.cc"
click node_encryption "https://github.com/deeptho/neumodvb/blob/master/src/receiver/active_service.cc"
click node_chdb "https://github.com/deeptho/neumodvb/blob/master/src/neumodb/chdb/chdb_extra.cc"
click node_devdb "https://github.com/deeptho/neumodvb/blob/master/src/neumodb/devdb/devdb_extra.cc"
click node_epgdb "https://github.com/deeptho/neumodvb/blob/master/src/neumodb/epgdb/epgdb_extra.cc"
click node_recdb "https://github.com/deeptho/neumodvb/blob/master/src/neumodb/recdb/recdb_extra.cc"
click node_dbui "https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/neumodbutils.py"
click node_serviceui "https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/servicelist.py"
click node_coredb "https://github.com/deeptho/neumodvb/blob/master/src/neumodb/neumodb.cc"

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_app,node_lists,node_grid,node_dialogs,node_serviceui toneBlue
class node_frontend,node_receiver,node_tuner,node_scan,node_spectrum,node_positioner toneAmber
class node_service,node_parser,node_viewer,node_recording,node_epg,node_encryption toneMint
class node_chdb,node_devdb,node_epgdb,node_recdb,node_dbui,node_coredb toneRose
class node_user,node_oscam toneIndigo
```

## Components

### Desktop interface

- [GUI application](https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb.py): `gui/neumodvb.py`
- [Configuration lists](https://github.com/deeptho/neumodvb/tree/master/gui/neumodvb): `gui/neumodvb`
- [Grid framework](https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/neumolist.py): `gui/neumodvb/neumolist.py`
- [Dialogs](https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/neumo_dialogs_gui.py): `gui/neumodvb/neumo_dialogs_gui.py`
- [Service list](https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/servicelist.py): `gui/neumodvb/servicelist.py`

### DVB reception

- [Frontend manager](https://github.com/deeptho/neumodvb/blob/master/src/receiver/devmanager.cc): `src/receiver/devmanager.cc`
- [Receiver control](https://github.com/deeptho/neumodvb/blob/master/src/receiver/receiver.h): `src/receiver/receiver.h`
- [Tuner hardware](https://github.com/deeptho/neumodvb/blob/master/src/receiver/neumo-frontend.h): `src/receiver/neumo-frontend.h`
- [Mux and blindscan](https://github.com/deeptho/neumodvb/blob/master/src/receiver/scan.cc): `src/receiver/scan.cc`
- [Spectrum analysis](https://github.com/deeptho/neumodvb/blob/master/src/receiver/spectrum_algo1.cc): `src/receiver/spectrum_algo1.cc`
- [Positioner control](https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/positioner_dialog.py): `gui/neumodvb/positioner_dialog.py`

### Program services

- [Active service](https://github.com/deeptho/neumodvb/blob/master/src/receiver/active_service.cc): `src/receiver/active_service.cc`
- [Stream parsing](https://github.com/deeptho/neumodvb/blob/master/src/receiver/streamparser/streamparser.h): `src/receiver/streamparser/streamparser.h`
- [Live viewing](https://github.com/deeptho/neumodvb/blob/master/src/viewer/neumompv.cc): `src/viewer/neumompv.cc`
- [Recording](https://github.com/deeptho/neumodvb/blob/master/src/receiver/recmgr.cc): `src/receiver/recmgr.cc`
- [EPG scanning](https://github.com/deeptho/neumodvb/blob/master/src/receiver/streamparser/events.cc): `src/receiver/streamparser/events.cc`
- [Encrypted streams](https://github.com/deeptho/neumodvb/blob/master/src/receiver/active_service.cc): `src/receiver/active_service.cc`

### Application data

- [Channel database](https://github.com/deeptho/neumodvb/blob/master/src/neumodb/chdb/chdb_extra.cc): `src/neumodb/chdb/chdb_extra.cc`
- [Device database](https://github.com/deeptho/neumodvb/blob/master/src/neumodb/devdb/devdb_extra.cc): `src/neumodb/devdb/devdb_extra.cc`
- [EPG database](https://github.com/deeptho/neumodvb/blob/master/src/neumodb/epgdb/epgdb_extra.cc): `src/neumodb/epgdb/epgdb_extra.cc`
- [Recording database](https://github.com/deeptho/neumodvb/blob/master/src/neumodb/recdb/recdb_extra.cc): `src/neumodb/recdb/recdb_extra.cc`
- [Database UI helpers](https://github.com/deeptho/neumodvb/blob/master/gui/neumodvb/neumodbutils.py): `gui/neumodvb/neumodbutils.py`
- [Database engine](https://github.com/deeptho/neumodvb/blob/master/src/neumodb/neumodb.cc): `src/neumodb/neumodb.cc`

### Other components

- **Operator**
- **OScam**

## Connections

- Operator → GUI application: starts
- GUI application → Receiver control: creates (evidence: `gui/neumodvb.py`)
- Operator → Configuration lists: configures
- Configuration lists → Frontend manager: sets up
- Operator → Mux and blindscan: scans muxes
- Operator → Spectrum analysis: requests spectrum
- Operator → Positioner control: controls
- Receiver control → Frontend manager: manages (evidence: `src/receiver/receiver.h`)
- Frontend manager → Tuner hardware: controls
- Receiver control → Mux and blindscan: runs scans
- Mux and blindscan → Channel database: discovers services
- Receiver control → Active service: tunes (evidence: `src/receiver/active_service.cc`)
- Active service → Stream parsing: parses streams (evidence: `src/receiver/active_service.cc`)
- Active service → Live viewing: feeds playback
- Active service → Recording: starts recording (evidence: `src/receiver/active_service.cc`)
- Active service → Encrypted streams: decrypts (evidence: `src/receiver/active_service.cc`)
- Encrypted streams → OScam: uses
- Receiver control → EPG scanning: scans EPG
- EPG scanning → EPG database: stores listings
- Recording → Recording database: stores recordings
- Mux and blindscan → Device database: uses device setup
- Mux and blindscan → Channel database: stores muxes
- Grid framework → Database UI helpers: uses (evidence: `gui/neumodvb/neumolist.py`)
- Service list → Grid framework: extends (evidence: `gui/neumodvb/servicelist.py`)
- Service list → Channel database: writes services (evidence: `gui/neumodvb/servicelist.py`)
- Database engine → Channel database: backs
- Database engine → Device database: backs
- Database engine → EPG database: backs
- Database engine → Recording database: backs
