# ODR-EncoderManager

**Repository Path**: talent518/ODR-EncoderManager

## Basic Information

- **Project Name**: ODR-EncoderManager
- **Description**: Opendigitalradio Encoder Manager
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://www.opendigitalradio.org/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-28
- **Last Updated**: 2025-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: dab-broadcasting, odr-mmbtools, DAB, broadcasting

## README

# ODR-EncoderManager
OpenDigitalRadio Encoder Manager is a tools to run and configure ODR Encoder easly with a WebGUI.

# Note about version V5.0.1

**Bug fixes**

  * use yaml.safe_load instead yaml.load to avoid crash on recent python version

# Note about version V5.0.0
**Requirement**

  * ODR-AudioEnc v3.0.0
  * ODR-SourceCompanion v1.0.0
  * ODR-PadEnc v3.0.0

**New Feature / Change**

  * Add odr-padenc raw-slides option
  * Add additional supervisor option by encoder (only via editing config file at this time)
  * Display ODR tools version
  * ODR-padenc socket support
  * Change supervisor stderr logging
  * Communication between odr-audioenc/odr-sourcecompanion use socket instead fifo

**Bug fixes**

  * Solve issue with SNMP request on AVT with last firmware (ClockSource)


# INSTALLATION

  * (root) Install requirement (debian/stretch) : `apt install python3-cherrypy3 python3-jinja2 python3-serial python3-yaml supervisor python3-pysnmp4`
  * (root) Add odr user : `adduser odr`
  * (root) Add odr user to dialout group : `usermod -a -G dialout odr`
  * (root) Add odr user to audio group : `usermod -a -G audio odr`
  * (user) Got to odr user home : `cd /home/odr/`
  * (user) Clone git repository : `git clone https://github.com/YoannQueret/ODR-EncoderManager.git`
  * (user) Rename sample config : `mv /home/odr/ODR-EncoderManager/config.json.sample /home/odr/ODR-EncoderManager/config.json`
  * (root) Make the symlink: `ln -s /home/odr/ODR-EncoderManager/supervisor-encoder.conf /etc/supervisor/conf.d/odr-encoder.conf`
  * (root) Make the symlink: `ln -s /home/odr/ODR-EncoderManager/supervisor-gui.conf /etc/supervisor/conf.d/odr-gui.conf`
  * (root) Edit `/etc/supervisor/supervisord.conf` and add this section :
```
[inet_http_server]
port = 8900
username = user ; Auth username
password = pass ; Auth password
```
  * (root) Restart supervisor : `/etc/init.d/supervisor restart`
  * (root) Start WEB server : `supervisorctl reread; supervisorctl update ODR-encoderManager`
  * Go to : `http://<ip_address>:8080`
  * Login with user `joe` and password `secret` 



# CONFIGURATION
  * You can edit global configuration, in particular path in this files :
    * config.json
    * supervisor-gui.conf
  * If you want to change supervisor XMLRPC login/password, you need to edit `/etc/supervisor/supervisord.conf` and `config.json` files


# How to set DLS / DL+ / SLS
**Set DLS / DL+ for all encoder**
To set a text metadata used for DLS, use http GET or POST on the Encoder Manager API from your automation software.
> http://{ip}:8080/api/setDLS?dls={artist}-{title}

As an alternative DLS+ tags are automatically activated if you use artist & title parameters:
> http://{ip}:8080/api/setDLS?artist={artist}&title={title}

Many radio automation software can send this information to Encoder Manager API by using a call of this type (for example)
> http://{ip}:8080/api/setDLS?dls=%%artist%% - %%title%%

%%artist%% - %%title%% should be replaced with the expression expected from your radio automation software.

At each events on your playlist (when a track start) the radio automation software will send via this url the appropriate metadata to Encoder Manager API. It will be reflected on the DAB signal.

**Set DLS / DL+ for specific encoder (from version V4.0.0)**
If you want to update DLS / DL+ for a specific encoder, you need to find the uniq_id on Encoder > Manage page under Information button
> http://{ip}:8080/api/setDLS?dls={artist}-{title}&uniq_id={00000000-0000-0000-0000-000000000000}

**Set SLS for all encoder**
To send slide used for SLS, use http POST on the Encoder Manager API.
> curl -X POST -F 'slide_file=@"live.jpg"' http://{ip}:8080/api/setSLS

**Set SLS for specific encoder**
If you want to update SLS for a specific encoder, you need to find the uniq_id on Encoder > Manage page under Information button
> curl -X POST -F 'uniq_id={00000000-0000-0000-0000-000000000000}' -F 'slide_file=@"{file.jpg}"' http://{ip}:8080/api/setSLS

# ADVANCED
  * To use the reboot api (/api/reboot), you need to allow odr user to run shutdown command by adding the line bellow at the end of /etc/sudoers file :
```
odr     ALL=(ALL) NOPASSWD: /sbin/shutdown
```