Reference

supysonic-cli-user(1)

Supysonic user management commands

NAME

supysonic-cli-user - Supysonic user management commands

SYNOPSIS

supysonic-cli user --help

supysonic-cli user list

supysonic-cli user add <user> [--password <password>] [--email <email>]

supysonic-cli user delete <user>

supysonic-cli user changepass <user> [--password <password>]

supysonic-cli user setroles [--admin | --noadmin] [--jukebox | --nojukebox] <user>

supysonic-cli user rename <user> <newname>

DESCRIPTION

The supysonic-cli user subcommand manages users, allowing to list them, add a new user, delete an existing user, and change their password or roles.

ARGUMENTS

list

List all the users.

add <user> [--password <password>] [--email <email>]

Add a new user named <user>. Will prompt for a password if it isn't given with the --password option.

delete <user>

Delete the user <user>.

changepass <user> [--password <password>]

Change the password of user <user>. Will prompt for the new password if not provided.

setroles [--admin | --noadmin] [--jukebox | --nojukebox] <user>

Give or remove rights to user <user>.

rename <user> <newname>

Rename the user <user> to <newname>.

OPTIONS

-h, --help

Shows help and exits. Depending on where this option appears it will either list the available commands or display help for a specific command.

-p <password>, --password <password>

Specify the user's password upon creation.

-e <email>, --email <email>

Specify the user's email.

The next options relate to user roles. They work in pairs, one option granting a right while the other revokes it; obviously options of the same pair are mutually exclusive.

The long options are named with the matching right, prefix it with a no to revoke the right. For short options, the upper case letter grants the right while the lower case letter revokes it. Short options might be combined into a single one such as -aJ to both revoke the admin right and grant the jukebox one.

-A, --admin

Grant admin rights.

-a, --noadmin

Revoke admin rights.

-J, --jukebox

Grant jukebox rights.

-j, --nojukebox

Revoke jukebox rights.

EXAMPLES

To add a new admin user named MyUserName having password MyAwesomePassword:

$ supysonic-cli user add MyUserName -p MyAwesomePassword
$ supysonic-cli user setroles -A MyUserName

SEE ALSO

supysonic-cli (1), supysonic-cli-folder (1), supysonic-server (1), supysonic-daemon (1)

AUTHOR

Louis-Philippe Véronneau, Alban Féron

COPYRIGHT

2013-2023, Alban Féron

History

--admin since Debian 12 (Bookworm); --email since Debian 12 (Bookworm); --help since Debian 12 (Bookworm); --jukebox since Debian 12 (Bookworm); --noadmin since Debian 12 (Bookworm); --nojukebox since Debian 12 (Bookworm); --password since Debian 12 (Bookworm); -A since Debian 12 (Bookworm); -J since Debian 12 (Bookworm); -a since Debian 12 (Bookworm); -e since Debian 12 (Bookworm); -h since Debian 12 (Bookworm); -j since Debian 12 (Bookworm); -p since Debian 12 (Bookworm).