evanugarte/my-arcam-remote

A remote for Arcam products using Svelte, Python and the arcam_fmj library.

my-arcam-remote

A remote for Arcam products using Svelte, Python and the arcam_fmj library.

Running the App

Step 1: Obtain Device IP Address

1. Ensure your arcam device is connected to your network via ethernet cable.
2. Obtain the device's IP address following the steps on this document on page 16 on the rightmost section.

Step 2: Create .env file with ARCAM_IP entry

create a .env file in the project directory with the contents below. Ensure the ip address matches the value you got from step 1.

ARCAM_IP=192.168.1.1

Step 3: Run the application with docker-compose

1. Make sure docker-compose is installed.
2. From the my-arcam-remote directory run docker-compose up.
3. The website should be accessible at http://localhost after building.

Example Screenshot

The website has a simple UI for both the browser and the phone:

my-arcam-remote's Issues

Intermittent SSE Timeout

it seems like when we are on the page for too long, the SSEs no longer work.

updating the nginx file to resolve this.

Related to #28

Add Server Sent Events for Arcam updates

When anyone changes the state of the amplifier from the website, we should broadcast this change to anyone else connected.

Update Arcam volume range

60 is not the max.

Add option to scan for Arcam device on local network

On startup, if the given HOST_IP (found on docker-compose.yml:9) isn't responding, we should be able to try our best to scan for the Arcam device if it may be something different.

Simple algo

1. Boot server
2. ping HOST_IP, make sure a normal query works
3. If it doesn't, scan the range of IP addresses using the subnet mask to find a device with ports 80 and 50000 open.
4. Try normal ping, if it works use it, else keep searching
5. Error out if we cannot find a host

Disable double-tap zoom on mobile browsers

So that clicking volume quickly doesn't alter the website's view. Basically this stackoverflow post.

Update UI when revisiting tab

If the webpage is focused on again, run the health check again. That way if the state is updated sometime in between the updates are reflected.

example https://stackoverflow.com/a/1760268

Fix SSEs with Nginx

Should be fixed by this stackoverflow answer.

Rapidly clicking volume up/down inconsistent

Say volume is 30. this happens when we click the volume up/down too fast:

*click* *click* *click*

31
33
32

It has to do with trying to handle async events sequentially. We could have the server keep state of the volume. Or look around to see if there are examples of handling this

Add Server to Take Arcam Commands

We need a server in flask to server static HTML content and accept GET and POST requests for controlling the device.

GET  "/"
GET  "/<path:path>"
GET  "/api/health-check"
POST "/api/mute"
POST "/api/power"
POST "/api/volume"
POST "/api/source"

All post requests set the related field with the query parameter value. The values will be active high, meaning
GET /api/power?value=1 will turn the device on and 0 will turn it off.

Make icons change color with dark mode

if a user uses dark reader the icons don't uniformly change color, let's fix with likely css rules so the extension can properly pick it up

Containerize Website

With a bridge network so we can access the device outside of the container runtime.

Add website to control Arcam device

Should have inputs to interface with all of the APIs defined in #1. Plan to use Svelte and serve the build files over the flask server.

Replace font awesome icons

Use meteor-icon-kit over font awesome. we will store the icons locally so the arcam app will not need a connection to the internet anymore for icons to work. the license for these new icons is MIT so we can steal it to our hearts content

Disable inputs while awaiting health check response

sometimes pressing buttons in this transitional state causes the command to be sent to the device. this will prevent interaction while we haven't gotten the state of the Arcam device in the frontend.

Add Custom Metrics

For Prometheus like amplifier latency, commands per hour and volume levels over time.

Add Monitoring

Prometheus/Grafana.

subdomain nginx https://www.reddit.com/r/nginx/comments/b9jsj1/hosting_apps_under_different_subdomains/ek57z1x/?utm_source=share&utm_medium=ios_app&utm_name=iossmf&context=3

Use new arcam_fmj branch to handle device queries

more details tomorrow