OpenMOS Media Object Server

An implementation of Media Object Server using MOS Protocol 4.0 with TCP socket communication. The project will aim at compliance with Profile 7.

Note

The MOS protocol specification requires TCP socket connections (default port 10540). At initial stages, message attributes differ from the protocol specification due to practical reasons.

Implementation status:

• Core
• MongoDB Data Repository
• Sentry Observability
• TCP Socket Server
• Profile 0 - Basic Communication
• Profile 1 - Basic Object Based Workflow
• Profile 2 - Basic Running Order / Content List Workflow
• Profile 3 - Advanced Object Based Workflow
• Profile 4 - Advanced RO/Content List Workflow
• Profile 5 - Item Control
• Profile 6 - MOS Redirection
• Profile 7 - MOS RO/Content List Modification

Architecture

OpenMOS implements the MOS protocol using:

• TCP Socket Server: Maintains persistent connections with MOS clients (NCS systems)
• MongoDB: Stores running orders, stories, items, and MOS objects
• Sentry: Provides error tracking and performance monitoring

The server handles multiple concurrent client connections, processes MOS XML messages, and manages the lifecycle of running orders and their associated content.

Experimental Features

As an experimental feature, the Profile 5 roCtrl will be implemented in a way that it can support IoT device control using MQTT protocol. An example use case is the red light control. In the future this could be expanded to actual machine controls with protocols like Ember+ (https://github.com/Lawo/ember-plus) or VDCP.

More Information

For more information about the MOS protocol, see https://www.mosprotocol.com

This project is not affiliated with MOS Group and will use the word compliance according to the requirements set by the MOS Group.

Logging system utilizes Sentry observability layer. Developer subscription is available for free at https://www.sentry.io

When the maturity level reaches early beta, the project shall make available a Docker image. Dependencies are to be kept as minimal as possible, using frameworks that are still maintained and active.

Configuration

Configuration file:

app:
    name: OpenMOS
    version: 1.0.0
    environment: development
server:
    host: 0.0.0.0
    port: 10540
    readtimeout: 5s
    writetimeout: 5s
    shutdowntimeout: 30s
mongo:
    uri: "mongodb+srv://localhost"
    database: openmosdb01
    timeout: 10s
mos:
    id: mos01.station.com
    heartbeatinterval: 30s
    clienttimeout: 2m0s
logging:
    level: info
sentry:
    dsn: ""
    environment: development
    debug: false
    attachstacktrace: true
    samplerate: 1
    tracessamplerate: 0.2

Generate default configuration file:

./openmos --generate-config=config.yaml

Running OpenMOS

# With default configuration search
./openmos

# With specific configuration file
./openmos --config=/path/to/config.yaml

# Generate default configuration
./openmos --generate-config=config.yaml

Building from Source

cd src
go build -o openmos

Requirements

• Go 1.24.1 or later
• MongoDB 4.4 or later
• Network access on port 10540 (default MOS port)

License

See LICENSE file for details.