Settings

Every variable the screen's service reads, and every route it exposes: the full reference, alongside the chapters that explain them one by one.

The environment variables

Set in /etc/ecran-atelier.env (Installing the screen chapter), in mode 600: they win over the ones in the systemd unit.

Variable	Default	Role
`ADRESSE`	`:8099`	Where the service listens.
`MUSIC_ASSISTANT`	`http://127.0.0.1:8095`	Music Assistant's API.
`MUSIC_ASSISTANT_JETON`	(empty)	The access token: required since Music Assistant 2.10.
`METEO`	`50.85,4.35`	The weather location: “lat,lon”, or the name of a town.
`VISUALISEUR_DECALAGE_MS`	`0`	The lag between the sound and the spectrum: your speaker's latency (Installing the screen chapter).
`ADRESSE_MACHINES`	`:8098`	Where the machines' services (`ecran-agent`) connect: set and empty, the port stays closed.
`JETONS_MACHINES`	(empty)	“Name=token;Other name=other token”, one token per machine; empty, the machines' port stays closed.

Always set METEO to your own town or coordinates. The service's internal default isn't meant to be used in practice: leaving it aside shows weather that isn't yours.

The routes

“Reserved to the screen” means: the service only answers calls coming from the host machine itself; seen from the network, it answers 403.

Route	Role
`GET /`	The page, full screen.
`POST /etat`	gproj — or any other tool — pushes the window state here (Projects chapter).
`GET /flux`	The event stream the page opens: it's notified the moment the state changes, rather than re-polling `/` every five seconds.
`POST /musique`	A music key: play, pause, previous, next, volume, or starting a favorite. Reserved to the screen.
`GET /visualiseur`	The token and address of the MilkDrop relay, for the spectrum. Reserved to the screen.
`POST /touche`	A press on a machine key. Reserved to the screen.
`GET /icone/<empreinte>.png`	A machine key's icon, immutable.
TCP `8098`	The machines' services (`ecran-agent`) connect here.
`GET /essai/trames`	One second of real frames, for `/?essai=spectre`.
`GET /api/vue`	The same content as the page, in JSON: for diagnosing without looking at the screen.
`GET /sante`	Whether the service answers: `{"etat":"ok"}`.