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>