README: remove refs to demo client

The demo client isn't really fit for purpose, so stop encouraging people to use
it.
This commit is contained in:
Richard van der Hoff 2016-12-02 11:18:31 +00:00
parent f8c45d428c
commit bb3d0c270d

View file

@ -67,17 +67,6 @@ hosted by someone else (e.g. matrix.org) - there is no single point of control
or mandatory service provider in Matrix, unlike WhatsApp, Facebook, Hangouts, or mandatory service provider in Matrix, unlike WhatsApp, Facebook, Hangouts,
etc. etc.
Synapse ships with two basic demo Matrix clients: webclient (a basic group chat
web client demo implemented in AngularJS) and cmdclient (a basic Python
command line utility which lets you easily see what the JSON APIs are up to).
Meanwhile, iOS and Android SDKs and clients are available from:
- https://github.com/matrix-org/matrix-ios-sdk
- https://github.com/matrix-org/matrix-ios-kit
- https://github.com/matrix-org/matrix-ios-console
- https://github.com/matrix-org/matrix-android-sdk
We'd like to invite you to join #matrix:matrix.org (via We'd like to invite you to join #matrix:matrix.org (via
https://matrix.org/docs/projects/try-matrix-now), run a homeserver, take a look https://matrix.org/docs/projects/try-matrix-now), run a homeserver, take a look
at the Matrix spec at https://matrix.org/docs/spec and API docs at at the Matrix spec at https://matrix.org/docs/spec and API docs at
@ -209,39 +198,36 @@ run (e.g. ``~/.synapse``), and::
synctl start synctl start
Running The Demo Web Client Connecting to Synapse from a client
=========================== ===================================
The homeserver runs a web client by default at https://localhost:8448/. The easiest way to try out your new Synapse installation is by connecting to it
from a web client. We recommend the one at http://riot.im/app. You will need to
specify a "Custom server" when you log on or register: set this to
``https://localhost:8448`` - remember to specify the port (``:8448``) unless
you changed the configuration. (Leave the identity server as the default - see
`Identity servers`_.)
If this is the first time you have used the client from that browser (it uses If all goes well you should at least be able to log in, create a room, and
HTML5 local storage to remember its config), you will need to log in to your start sending messages.
account. If you don't yet have an account, because you've just started the
homeserver for the first time, then you'll need to register one.
Registering A New Account (The homeserver runs a web client by default at https://localhost:8448/, though
------------------------- as of the time of writing it is somewhat outdated and not really recommended -
https://github.com/matrix-org/synapse/issues/1527).
Your new user name will be formed partly from the hostname your server is Registering a new user from a client
running as, and partly from a localpart you specify when you create the ------------------------------------
account. Your name will take the form of::
Your new user name will be formed partly from the ``server_name`` (see
`Configuring synapse`_), and partly from a localpart you specify when you
create the account. Your name will take the form of::
@localpart:my.domain.here @localpart:my.domain.here
(pronounced "at localpart on my dot domain dot here")
Specify your desired localpart in the topmost box of the "Register for an (pronounced "at localpart on my dot domain dot here").
account" form, and click the "Register" button. Hostnames can contain ports if
required due to lack of SRV records (e.g. @matthew:localhost:8448 on an
internal synapse sandbox running on localhost).
If registration fails, you may need to enable it in the homeserver (see As when logging in, you will need to specify a "Custom server". Specify your
`Synapse Installation`_ above) desired ``localpart`` in the 'User name' box.
Logging In To An Existing Account
---------------------------------
Just enter the ``@localpart:my.domain.here`` Matrix user ID and password into
the form and click the Login button.
Security Note Security Note