Usage:
  matrix-commander-rs [OPTIONS]

Welcome to "matrix-commander", a Matrix CLI client. ─── On first run use
--login to log in, to authenticate. On second run we suggest to use --verify to
get verified. Emoji verification is built-in which can be used to verify
devices. On further runs this program implements a simple Matrix CLI client
that can send messages, verify devices, operate on rooms, etc. ───
─── This project is currently only a vision. The Python package
"matrix-commander" exists. The vision is to have a compatible program in Rust.
I cannot do it myself, but I can coordinate and merge your pull requests. Have
a look at the repo "https://github.com/8go/matrix-commander-rs/". Please help!
Please contribute code to make this vision a reality, and to one day have a
functional "matrix-commander" crate. Safe!

Optional arguments:
  -h,--help             Show this help message and exit
  --contribute          Please contribute.
  -v,--version          Print version number.
  -d,--debug            Overwrite the default log level. If not used, then the
                        default log level set with environment variable
                        'RUST_LOG' will be used. If used, log level will be set
                        to 'DEBUG' and debugging information will be printed.
                        '-d' is a shortcut for '--log-level DEBUG'. See also
                        '--log-level'. '-d' takes precedence over
                        '--log-level'. Additionally, have a look also at the
                        option '--verbose'.
  --log-level LOG_LEVEL Set the log level by overwriting the default log level.
                        If not used, then the default log level set with
                        environment variable 'RUST_LOG' will be used. Possible
                        values are 'DEBUG', 'INFO', 'WARN', and 'ERROR'. See
                        also '--debug' and '--verbose'.
  --verbose             Set the verbosity level. If not used, then verbosity
                        will be set to low. If used once, verbosity will be
                        high. If used more than once, verbosity will be very
                        high. Verbosity only affects the debug information. So,
                        if '--debug' is not used then '--verbose' will be
                        ignored.
  --login LOGIN         Login to and authenticate with the Matrix homeserver.
                        This requires exactly one argument, the login method.
                        Currently two choices are offered: 'password' and
                        'sso'. Provide one of these methods. If you have chosen
                        'password', you will authenticate through your account
                        password. You can optionally provide these additional
                        arguments: --homeserver to specify the Matrix
                        homeserver, --user-login to specify the log in user id,
                        --password to specify the password, --device to specify
                        a device name, --room-default to specify a default room
                        for sending/listening. If you have chosen 'sso', you
                        will authenticate through Single Sign-On. A web-browser
                        will be started and you authenticate on the webpage.
                        You can optionally provide these additional arguments:
                        --homeserver to specify the Matrix homeserver,
                        --user-login to specify the log in user id, --device to
                        specify a device name, --room-default to specify a
                        default room for sending/listening. See all the extra
                        arguments for further explanations. ----- SSO (Single
                        Sign-On) starts a web browser and connects the user to
                        a web page on the server for login. SSO will only work
                        if the server supports it and if there is access to a
                        browser. So, don't use SSO on headless homeservers
                        where there is no browser installed or accessible.
  --verify              Perform verification. By default, no verification is
                        performed. Verification is done via Emojis. If
                        verification is desired, run this program in the
                        foreground (not as a service) and without a pipe. While
                        verification is optional it is highly recommended, and
                        it is recommended to be done right after (or together
                        with) the --login action. Verification is always
                        interactive, i.e. it required keyboard input.
                        Verification questions will be printed on stdout and
                        the user has to respond via the keyboard to accept or
                        reject verification. Once verification is complete, the
                        program may be run as a service. Verification is best
                        done as follows: Perform a cross-device verification,
                        that means, perform a verification between two devices
                        of the *same* user. For that, open (e.g.) Element in a
                        browser, make sure Element is using the same user
                        account as the matrix-commander user (specified with
                        --user-login at --login). Now in the Element webpage go
                        to the room that is the matrix-commander default room
                        (specified with --room-default at --login). OK, in the
                        web-browser you are now the same user and in the same
                        room as matrix-commander. Now click the round 'i' 'Room
                        Info' icon, then click 'People', click the appropriate
                        user (the matrix-commander user), click red 'Not
                        Trusted' text which indicated an untrusted device, then
                        click the square 'Interactively verify by Emoji' button
                        (one of 3 button choices). At this point both web-page
                        and matrix-commander in terminal show a set of emoji
                        icons and names. Compare them visually. Confirm on both
                        sides (Yes, They Match, Got it), finally click OK. You
                        should see a green shield and also see that the
                        matrix-commander device is now green and verified in
                        the webpage. In the terminal you should see a text
                        message indicating success. You should now be verified
                        across all devices and across all users.
  -m,--message MESSAGE  Send this message. Message data must not be binary
                        data, it must be text. Input piped via stdin can
                        additionally be specified with the special character
                        '-'. If you want to feed a text message into the
                        program via a pipe, via stdin, then specify the special
                        character '-'. If '-' is specified as message, then the
                        program will read the message from stdin. If your
                        message is literally '-' then use '\-' as message in
                        the argument. In some shells this needs to be escaped
                        requiring a '\-'. If you want to read the message from
                        the keyboard use '-' and do not pipe anything into
                        stdin, then a message will be requested and read from
                        the keyboard. Keyboard input is limited to one line.
  --logout LOGOUT       Logout this or all devices from the Matrix homeserver.
                        This requires exactly one argument. Two choices are
                        offered: 'me' and 'all'. Provide one of these choices.
                        If you choose 'me', only the one device
                        matrix-commander is currently using will be logged out.
                        If you choose 'all', all devices of the user used by
                        matrix-commander will be logged out. While --logout
                        neither removes the credentials nor the store, the
                        logout action removes the device and makes the
                        access-token stored in the credentials invalid. Hence,
                        after a --logout, one must manually remove creditials
                        and store, and then perform a new --login to use
                        matrix-commander again. You can perfectly use
                        matrix-commander without ever logging out. --logout is
                        a cleanup if you have decided not to use this (or all)
                        device(s) ever again.
  --homeserver HOMESERVER
                        Specify a homeserver for use by certain actions. It is
                        an optional argument. By default --homeserver is
                        ignored and not used. It is used by '--login' action.
                        If not provided for --login the user will be queried
                        via keyboard.
  --user-login USER_LOGIN
                        Optional argument to specify the user for --login. This
                        gives the otion to specify the user id for login. For
                        '--login sso' the --user-login is not needed as user id
                        can be obtained from server via SSO. For '--login
                        password', if not provided it will be queried via
                        keyboard. A full user id like '@john:example.com', a
                        partial user name like '@john', and a short user name
                        like 'john' can be given. --user-login is only used by
                        --login and ignored by all other actions.
  --password PASSWORD   Specify a password for use by certain actions. It is an
                        optional argument. By default --password is ignored and
                        not used. It is used by '--login password' and
                        '--delete-device' actions. If not provided for --login
                        the user will be queried via keyboard.
  --device DEVICE       Specify a device name, for use by certain actions. It
                        is an optional argument. By default --device is ignored
                        and not used. It is used by '--login' action. If not
                        provided for --login the user will be queried via
                        keyboard. If you want the default value specify ''.
                        Multiple devices (with different device id) may have
                        the same device name. In short, the same device name
                        can be assigned to multiple different devices if
                        desired.
  --room-default ROOM_DEFAULT
                        Optionally specify a room as the default room for
                        future actions. If not specified for --login, it will
                        be queried via the keyboard. --login stores the
                        specified room as default room in your credentials
                        file. This option is only used in combination with
                        --login. A default room is needed. Specify a valid room
                        either with --room-default or provide it via keyboard.
  --devices             Print the list of devices. All device of this account
                        will be printed, one device per line.
  --timeout TIMEOUT     Set the timeout of the calls to the Matrix server. By
                        default they are set to 60 seconds. Specify the timeout
                        in seconds. Use 0 for infinite timeout.
  --markdown            There are 3 message formats for '--message'. Plain
                        text, MarkDown, and Code. By default, if no command
                        line options are specified, 'plain text' will be used.
                        Use '--markdown' or '--code' to set the format to
                        MarkDown or Code respectively. '--markdown' allows
                        sending of text formatted in MarkDown language.
                        '--code' allows sending of text as a Code block.
  --code                There are 3 message formats for '--message'. Plain
                        text, MarkDown, and Code. By default, if no command
                        line options are specified, 'plain text' will be used.
                        Use '--markdown' or '--code' to set the format to
                        MarkDown or Code respectively. '--markdown' allows
                        sending of text formatted in MarkDown language.
                        '--code' allows sending of text as a Code block.
  -r,--room ROOM        Optionally specify a room by room id. '--room' is used
                        by by various options like '--message'. If no '--room'
                        is provided the default room from the credentials file
                        will be used. If a room is provided in the '--room'
                        argument, then it will be used instead of the one from
                        the credentials file. The user must have access to the
                        specified room in order to send messages there or
                        listen on the room. Messages cannot be sent to
                        arbitrary rooms. When specifying the room id some
                        shells require the exclamation mark to be escaped with
                        a backslash.
  -f,--file FILE        Send this file (e.g. PDF, DOC, MP4). First files are
                        sent, then text messages are sent.
  --notice              There are 3 message types for '--message'. Text,
                        Notice, and Emote. By default, if no command line
                        options are specified, 'Text' will be used. Use
                        '--notice' or '--emote' to set the type to Notice or
                        Emote respectively. '--notice' allows sending of text
                        as a notice. '--emote' allows sending of text as an
                        emote.
  --emote               There are 3 message types for '--message'. Text,
                        Notice, and Emote. By default, if no command line
                        options are specified, 'Text' will be used. Use
                        '--notice' or '--emote' to set the type to Notice or
                        Emote respectively. '--notice' allows sending of text
                        as a notice. '--emote' allows sending of text as an
                        emote.
  --sync SYNC           This option decides on whether the program synchronizes
                        the state with the server before a 'send' action.
                        Currently two choices are offered: 'Full' and 'Off'.
                        Provide one of these choices. The default is 'Full'. If
                        you want to use the default, then there is no need to
                        use this option. If you have chosen 'Full', the full
                        state, all state events will be synchronized between
                        this program and the server before a 'send'. If you
                        have chosen 'Off', synchronization will be skipped
                        entirely before the 'send' which will improve
                        performance.