supysonic/docs/cli.md

# Command line interface

The command-line interface (often abbreviated CLI) is an interface allowing
administration operations without the use of the web interface. It can either
be run in interactive mode (`supysonic-cli`) or to issue a single command
(`supysonic-cli <arguments>`).

If ran without arguments, `supysonic-cli` will open an interactive prompt. You
can use the command line tool to do a few things:

## Help commands

Whenever you are lost

```
Usage:
    supysonic-cli help
    supysonic-cli help user
    supysonic-cli help folder

Arguments:
    user                        Display the help message for the user command
    folder                      Display the help message for the folder command
```

## User management commands

```
Usage:
    supysonic-cli user add <user> [-p <password>] [-e <email>]
    supysonic-cli user delete <user>
    supysonic-cli user changepass <user> <password>
    supysonic-cli user list
    supysonic-cli user setroles [-a|-A] [-j|-J] <user>

Arguments:
    add                         Add a new user
    delete                      Delete the user
    changepass                  Change the user's password
    list                        List all the users
    setroles                    Give or remove rights to the user

Options:
  -p --password <password>      Specify the user's password
  -e --email <email>            Specify the user's email
  -a --noadmin                  Revoke admin rights
  -A --admin                    Grant admin rights
  -j --nojukebox                Revoke jukebox rights
  -J --jukebox                  Grant jukebox rights
```

## Folder management commands

```
Usage:
    supysonic-cli folder add <name> <path>
    supysonic-cli folder delete <name>
    supysonic-cli folder list
    supysonic-cli folder scan [-f] [--background | --foreground] [<name>...]

Arguments:
    add                         Add a new folder
    delete                      Delete a folder
    list                        List all the folders
    scan                        Scan all or specified folders

Options:
  -f --force                    Force scan of already known files even if they
                                haven't changed
  --background                  Scan in the background. Requires the daemon to
                                be running.
  --foreground                  Scan in the foreground, blocking the process
                                while the scan is running
```