NAME

matrixtool directory - Look up room alias to room ID entries

SYNOPSIS

   $ matrixtool directory '#matrix:matrix.org'

DESCRIPTION

This command queries the room directory service on a homeserver to map a room alias name into a room ID. As this is a fully public API that does not need an access token, this command is separate from matrixtool client.

OPTIONS

The following additional options are recognised

--servers, -s

Include a list of candidate servers in the output.

EXAMPLES

For example, resolving a room alias into a room ID:

   $ matrixtool directory '#matrix:matrix.org'
   room_id: !cURbafjkfsMDVwdRDQ:matrix.org

Additionally a list of join candidate servers can also be printed:

   room_id: !cURbafjkfsMDVwdRDQ:matrix.org
   candidate servers:
     matrix.org
     ...

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>