diff --git a/README.md b/README.md index fe0df4e..2a66d19 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # hcra HamClock Remote Access - access HamClock remotely -This is currently in early development. +See the client and server READMEs for more information. ## Client The client is in the `client` directory. diff --git a/client/README.md b/client/README.md new file mode 100644 index 0000000..d2594eb --- /dev/null +++ b/client/README.md @@ -0,0 +1,19 @@ +# HCRA Client + +This is the client for HCRA. It connects to a running instance of HCRA Server +(see `../server`). + +## Installation + +Just use your favorite static-site Web server. You may, optionally, delete +this file, but it shouldn't hurt anything to leave it. + +## Usage + +Enter the server URL (starts with `ws://` or `wss://`) and password, then +click Start. + +## Mobile + +This should work on mobile devices. Use landscape orientation for best +results. diff --git a/server/README.md b/server/README.md index fc1a530..635eb1a 100644 --- a/server/README.md +++ b/server/README.md @@ -43,6 +43,21 @@ HamClock's built-in port 8080 service, or it can use X11. The X11 method is highly recommended when it can be used, because it does not occasionally freeze when HamClock is on certain screens like the port 8080 backend does. +### Port 8080 + +The Port 8080 backend just requires a running instance of 800x480 HamClock. + +### X11 + +The X11 backend requires 800x480 HamClock to be running on Xvfb at a +resolution of `800x480x24`. + +For example: + + Xvfb :1 -screen 0 800x480x24 + +Replace :1 with the desired display number. + ## `conf.txt` The server will not work without a `conf.txt` file. This file is a @@ -57,7 +72,8 @@ Use `x11` for the X11 backend, or `port8080` for the port 8080 backend. ### `display` -X11 display to use, such as `:1`. Has no effect with the `port8080` backend. +X11 display to use, such as `:1`. Must be the same as the one used for Xvfb +and HamClock. Has no effect with the `port8080` backend. ### `password_argon2`