A simple stateless privacy-protecting URL redirecting service for Matrix
Matrix.to is a simple url redirection service for the Matrix.org ecosystem which lets users share links to matrix entities without being tied to a specific app. Stylistically it serves as a landing page for rooms and communities.
You can use the badge image we've put up at https://matrix.to/img/matrix-badge.svg, and use it in a link like this:
You can use this Markdown:
md [![Chat on Matrix](https://matrix.to/img/matrix-badge.svg)](https://matrix.to/#/#matrix.to:matrix.org)
Or this HTML:
to show the badge.
Anyone is welcome to host their own version of the Matrix.to app - Matrix.to is not a single point of failure on the Matrix ecosystem; if the matrix.to deployment ever failed, users could trivially copy the room/user/message details out of the URLs and follow them manually, or change the hostname to point at an alternative deployment of the service. The Matrix.to service could also be hosted in an immutable/signed environment such as IPFS to further increase its availability and avoid tampering.
The matrix.to URL scheme is
| Entity type: | Example URL | |--------------|-------------------------------------------------------------------| | Rooms: | https://matrix.to/#/#matrix:matrix.org | | Rooms by ID: | https://matrix.to/#/!cURbafjkfsMDVwdRDQ:matrix.org | | Users: | https://matrix.to/#/@matthew:matrix.org | | Messages: | https://matrix.to/#/#matrix:matrix.org/$1448831580433WbpiJ:jki.re |
The #/ component is mandatory and exists to avoid leaking the target URL to the server hosting matrix.to.
Note that linking to rooms by ID should only be used for rooms to which the target user has been invited: these links cannot be assumed to work for all visitors.
(Technically the # and @ in the URL fragment should probably be escaped, but in practice for legibility we bend the rules and include it verbatim)
git clone https://github.com/matrix-org/matrix.to