Users management#

Access to anything in Radiotomate requires authentication. As an administrator you can give access to other people, but we want to keep access checks simple for you, and for developpers. Radiotomate only understand broad roles, described below. Therefore:

Radiotomate assumes that you trust people to whom you're giving accounts.

It will not let you define detailed permissions like "this person can upload only one sound per week in this cart", or "this person can stream live, but only from 11:00 to 11:30". Our years-long experience shows that it works as long as users act as members of the same community, where rules are collectively discussed, understood and enforced. We insist on this beforehand because we know some radios need to enforce permissions in the software.

In future versions Radiotomate will keep track explicitely of who did what, so if something goes wrong you'd be able to read the audit log to investigate.

Roles#

Users can have roles that will determine what they can see and do in the application. They can have multiple roles, among the following.

Admin#

Can do everything, in perticular edit settings and user accounts.

Stream#

Can takeover programs by sending a live stream. The username and password must be provided by the steaming application.

Carts#

Can edit carts and the sounds they contain.

Auto-DJ#

Can add/modify/delete music library and auto-DJ's schedule.

Live#

Enables actions on the "Live" page: skip the current sound (in the future: change current metadata)

not_audio#

When the radio outputs to a sound card and you want to use the interface on the Radiotomate server, assign this role to disable players in the interface. Player will be replaced by a 🔇 so browsing the interface will not interfere with the sound stream.

Manage from the Web interface#

Administrators have access to a Users tab giving access to the users list and the user creation form. From there they can also change their roles and passwords.

Manage from the command-line#

On the command line, radiotomate users provide sub-commands that allow you to manage users. This is perticularly handy if you need to reset an administrator's account. As always, use the --help option to have an up-to-date documentation:

radiotomate users --help
Usage: radiotomate users [OPTIONS] COMMAND [ARGS]...

Users management commands

Options:
--help  Show this message and exit.

Commands:
add    Create a radiotomate user account
mod    Change the password of a radiotomate user
roles  List role identifiers, that can be used with --role
rm     Remove a radiotomate user account