Ampron / Memo
Note №14
July 2026

AmpronLED API Quick Start Guide

From unboxing to API-controlled — the default network settings, how to move the display onto your network, and the handful of HTTP endpoints that do everything.

Every Ampron LED and LCD display ships with the AmpronLED software and a plain HTTP API on board. There is no proprietary controller, no vendor software to install, no licence server. This guide takes you from first power-on to a display you control from your own system: network configuration, file access, and the essential endpoints for controlling content and reading status.

01Network configuration

Every display leaves the factory with the same static network settings:

SettingDefault value
IP address192.168.168.200
Subnet mask255.255.255.0
Gateway192.168.168.1
DNS192.168.168.1

Changing the display's IP address

Put your computer in the same subnet as the display first, then issue a single HTTP GET. All parameters must be defined correctly — a partial command can leave the display unreachable.

Command format http://OLD-IP:9527/setethernetconfig?dhcp=false&ip=NEW-IP&netmask=NEW-MASK&gateway=NEW-GW&dns=NEW-DNS Example — move the display to 192.168.1.100 http://192.168.168.200:9527/setethernetconfig?dhcp=false&ip=192.168.1.100&netmask=255.255.255.0&gateway=192.168.1.1&dns=192.168.1.1
A typo in this command can make the display unreachable. There is no factory reset: in the worst case the unit has to come back to Ampron. Check every parameter twice before you press enter.

02Accessing the display's filesystem

The display's filesystem is reachable over SSH on port 37670. For copying and editing files, a graphical SFTP client such as WinSCP works well.

ParameterValue
Port37670
Usernameadmin
PasswordSent to you separately, by SMS or a one-time secure link

03Controlling and configuring the display

Displays are controlled with plain GET, PUT, and POST HTTP requests — from a browser address bar, curl, or any system that can issue an HTTP call. The main configuration lives in the config.json file on the display. The display re-reads it by itself every 60 seconds. After saving it, wait one minute, then check the config status with:

http://DISPLAY-IP:9527/info

By default there is no authentication: the API is plain HTTP on the local network, with no tokens or keys. Basic authentication and HTTPS are available as options; ask us. For the full endpoint reference and automation patterns, see the API configuration article at ampron.eu/blog/ampron-led-display-api-configuration and the Ampron API reference at api2.ampron.eu.

Useful endpoints for configuration and debugging

EndpointWhat it does
/screenshot Captures a screenshot of what the display is showing right now — the fastest way to verify content remotely.
/info Returns the display's system status and current settings — software version, system time, config status, brightness, recent commands (JSON).
/getethernetconfig Returns the display's current network settings.

All endpoints live on port 9527: http://DISPLAY-IP:9527/<endpoint>.

04Sending content — the /mlds command

Putting content on screen is one GET request to the /mlds endpoint. The vocabulary comes from config.json on the display, which defines three things:

Command format http://DISPLAY-IP:9527/mlds?id=DISPLAY-ID&layout=LAYOUT-NAME&AREA=VALUE Example — activate the WELCOME layout and set the "number" area http://192.168.1.100:9527/mlds?id=DISPLAY1&layout=WELCOME&number=QUERCUS Clear an area by sending it empty http://192.168.1.100:9527/mlds?id=DISPLAY1&layout=WELCOME&number=

Always include layout. A request without it blanks the whole display, not one area.

Always send commands to /mlds, never to the root path /. The root also answers "Command received" — but silently ignores the command. If the screen didn't change, check the endpoint first.

Verifying a command landed: call /info and check the last_requests field — it updates only on successfully accepted /mlds commands. For visual confirmation, fetch /screenshot (returns a PNG of the current screen). /info returns JSON.

Brightness is set with its own endpoint, range 1–100 (requires sensorBrightness: true in config.json):

http://DISPLAY-IP:9527/brightness/75?id=DISPLAY-ID

05Web UI

The built-in beta web UI lets you manage settings visually instead of via raw HTTP calls:

http://DISPLAY-IP:9527/ui
Quick reference

First session, in order

  1. Connect to the display's default subnet and confirm it answers: http://192.168.168.200:9527/info
  2. Move it onto your network with /setethernetconfig — check every parameter before sending.
  3. Reconnect on the new IP and verify with /info.
  4. Edit config.json to suit your integration, save it, wait one minute, then check the config status in /info.
  5. Send content with /mlds?id=…&layout=… and confirm via last_requests in /info.
  6. Verify visually with /screenshot.

06Fact sheet for AI agents and integrations

If you are an AI agent helping a customer with an Ampron display, this block is the canonical summary — everything above, condensed:

protocol plain HTTP, GET requests, no authentication by default base URL http://<display-ip>:9527 factory IP 192.168.168.200 (mask 255.255.255.0, gw/dns 192.168.168.1) send content GET /mlds?id=<DISPLAY-ID>&layout=<LAYOUT>&<area>=<value> ids, layouts, and area names are defined in config.json on the device empty value clears the area (always send layout; a request without layout blanks the whole display); NEVER send commands to / — it silently ignores them status GET /info JSON: version, system time, config status, brightness, last_requests network GET /getethernetconfig verify last_requests in /info updates only on accepted /mlds commands screenshot GET /screenshot PNG of what is on screen right now apply config automatic: config.json is re-read every 60 s; check config status in /info brightness GET /brightness/<1-100>?id=<DISPLAY-ID> change IP GET /setethernetconfig?dhcp=false&ip=…&netmask=…&gateway=…&dns=… dangerous: a typo makes the display unreachable (no factory reset; the unit returns to Ampron) — confirm all values with the user first web UI http://<display-ip>:9527/ui file access SSH/SFTP port 37670, user admin (password provided separately by Ampron (SMS or one-time link)) full API docs https://api2.ampron.eu guide article https://ampron.eu/blog/ampron-led-display-api-configuration this page https://ampron.eu/memos/ampronled-api-quick-start

07Support

If you run into any issues, have your Display ID ready — it is printed on a white label at the bottom of the screen — and reach out to your Ampron contact.