Screenly Clock App

Getting Started

bun install

Deployment

Create and deploy the Edge App:

screenly edge-app create --name my-clock --in-place
bun run deploy
screenly edge-app instance create

Configuration

The app accepts the following settings via screenly.yml:

Setting	Description	Type	Default
unit	Measurement unit for temperature display: auto (automatically determined based on location), metric (Celsius), or imperial (Fahrenheit)	optional	auto
style	Visual style of the clock: traditional, modern, or minimal	optional	traditional
override_locale	Override the default locale with a supported language code	optional, advanced	en
override_timezone	Override the default timezone with a supported timezone identifier (e.g., Europe/London, America/New_York). Defaults to the system timezone if left blank	optional, advanced	-
openweathermap_api_key	OpenWeatherMap API key to access weather data and location information. Get your API key from the OpenWeatherMap API	optional, advanced	-

Note: When unit is set to auto (default), temperature units are automatically determined based on the device's location. The following countries use Fahrenheit: United States (US), Bahamas (BS), Cayman Islands (KY), Liberia (LR), Palau (PW), Federated States of Micronesia (FM), and Marshall Islands (MH). All other countries use Celsius.

Development

bun install      # Install dependencies
bun run dev      # Start development server

Testing

bun test

Screenshots

Generate screenshots at all supported resolutions:

bun run screenshots

Screenshots are saved to the screenshots/ directory.