Skip to content

Latest commit

 

History

History

install

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

Table of contents

Introduction

The goal of the mmbtools-get shell script is to install:

  • the odr-mmbtools components developed by the Open Digital Radio non-profit association on a clean debian environment
  • Working configuration files that you can later customize as you see fit

Installation

Preliminary notes

We highly recommend that you install odr-mmbTools on a new debian environment, starting from the Bullseye release. Since some software components, like the audio encoders or the modulator, are CPU-intensive, we recommend you setup a lite debian environment (ie. without a GUI framework).

If you want to quickly play with the tools before installing anything on your host, we suggest you use our docker-mmbtools repository.

Steps

  1. Sign-in with your user profile
  2. Update your system:
    sudo apt-get update
    sudo apt-get upgrade -y
    
  3. Find your time zone:
    timedatectl list-timezones
    
  4. Set your time zone:
    sudo timedatectl set-timezone your_timezone
    
  5. Install the git command:
    sudo apt-get install -y git
    
  6. Clone this repository:
    # Clone the stable version of dab-scripts
    git clone https://github.com/opendigitalradio/dab-scripts.git
    
    # Or clone the development version of dab-scripts
    git clone --branch next https://github.com/opendigitalradio/dab-scripts.git
    
  7. Install the ODR-mmbTools suite and the sample configuration folder
    # Install the stable version of odr-mmbTools
    sudo bash dab-scripts/install/mmbtools-get --branch master install
    
    # Or install the development version of odr-mmbTools
    sudo bash dab-scripts/install/mmbtools-get --branch next install
    

Notes

  1. You must use the argument --odr-user with the command mmbtools-get in the following 2 cases:
    • You are not running mmbtools-get with sudo: you must thus specify the odr user profile
    • You are running mmbtools-get with sudo and you do not want your current user to be the odr user profile
  2. mmbtools-get will create the user specified with odr-user if it does not exist:
    • password: odr
    • additional groups: audio,dialout

Removal

If you wish to remove the odr-mmbTools suite and the sample configuration folder, then follow these steps:

  1. Stop all odr-mmbTools related jobs in supervisor
  2. Remove the ODR-mmbTools software suite and the configuration folder
    sudo bash dab-scripts/install/mmbtools-get remove