Repository navigation
Widget Designer
Home · App settings · Widgets
The Widgets tab in Chronograph app settings lets you build reusable designs and themes. A design controls the arrangement of elements; a theme controls their colors. They are separate, so you can mix and match them on individual dashboard widgets.
- Create and save your own
- Import and export
- Community templates
- Preview
- Design styles
- Themes
- Arrange a design
- Button appearance
- Status bar
- Theme colors
- Open Chronograph app settings → Widgets.
- Select Design Styles or Themes.
- Select a built-in preset and copy it, or create a custom item.
- Give your custom item a meaningful name, adjust it and inspect the preview.
- Press Save to persist changes.
- In each dashboard widget's settings, select your design and/or theme.
Built-in designs and themes are read-only on Homey. Their preview controls still work, but editing-only fields are hidden. Built-ins cannot be deleted. Deleting a custom item requires confirmation and takes effect immediately; it does not save other pending edits. Deleting a design does not delete a theme, or vice versa.
The fixed footer places Undo and Redo on either side of Save. Undo and Redo apply to the currently selected design or theme. Switching to another item or editing mode with unsaved changes asks whether to discard those changes. Save first to keep them. Your browser may also warn when you leave settings with unsaved changes.
Use Designer help above the layout editor to collapse or expand its instructions. The choice is saved immediately and remembered when you reopen settings.
Select a custom design or theme and choose Export to download it as a JSON file named after the item, including its current edits. Built-in designs and themes cannot be exported; copy one first if needed. Choose Import and select a supported Chronograph JSON file to create a new editable copy. Its type is detected automatically; existing designs and themes are never overwritten. Name collisions receive a numbered suffix. Review the imported item and press Save to keep it. Switching away from an unsaved item during import asks whether to discard it.
Open Templates from the Widgets tab to share a saved custom design, theme, or both as a compact TWF. Copy the TWF or the prepared forum post. Built-in items must first be copied and saved. The prepared forum post uses English labels and placeholder text; design and theme names are kept as entered.
Selecting a design or theme immediately shows a normal-sized timer preview; the default design or theme is used for an unselected counterpart.
Creating the TWF also prepares a PNG containing three preview grids: one each for stopwatches, timers and transitions. Each grid shows the Compact, Normal and Large sizes in running, paused and stopped states, with each widget rendered at 350 pixels wide. Text can still be truncated if a design allocates too little space to it. If only a design or theme is included, the previews use the default counterpart.
When the previews are ready, the app attempts to copy the post and image automatically. If copying fails, choose Copy post and image to retry. Once copied, choose Post on Forum. In the forum reply composer, select the A on the right of the editor switch to use the rich-text editor and paste once. Wait for the image upload to finish before posting. The forum uploads the image itself; no Homey address is included. The Markdown editor does not handle the image in this combined paste. Clipboard support depends on the browser; if copying fails, you can still copy the TWF separately. Post on Forum opens the topic; it does not submit a post.
The Widget Exchange(r) reads shared templates from its community topic. The list shows the first uploaded preview image for each template. Search or sort the list, select a title to view its description and all uploaded preview images, mark favorites with the star, and import a template for review. Post templates to the topic yourself; the catalog is empty until templates are posted. Refresh it to load new posts.
To import, paste a Chronograph TWF (with or without its code-block fences) and read it. Review the visual preview, choose which included items to save, and adjust their names if desired. When an item is not included, choose a local design or theme for the preview. Import creates new copies; it does not overwrite existing items.
Select the chronograph type, widget size, and state to inspect the design. In design mode, choose a theme to preview with it; in color mode, choose a design. The preview buttons simulate starting, pausing, resuming and stopping, and the inputs accept sample values. They do not operate real chronographs or save sample values.
The size selector stays at the top while scrolling through the designer.
If visibility settings hide a preview control, use the state selector to change or reset the preview. Layouts are shared by widget types, but the preview shows only elements applicable to the selected type; stopwatches do not have a progress bar or duration start form.
Choose Single widget or a one-, two-, or three-column multi-widget preview. Multi-widget mode shows three sample tiles. Each tile's chronograph type can be selected independently; the design, size, state and theme are shared. For one or two columns, preview row separation as none, widget-style cards or a line, and choose the line color. The preview does not change actual dashboard widgets or save these preview choices.
Selecting the widget, a row, a column or an element highlights it in the preview when it is visible. In a multi-widget preview, the selection is highlighted in each tile where it appears.
The designer separates layout editing from color editing. These dark-mode screenshots were captured in a 500-pixel-wide browser viewport and enlarged to 1000 pixels for Wiki display. The design screenshot shows the complete row and column grid; the color screenshot shows the preview and color controls. Open either image to view it at full resolution.
Select Design Styles to arrange widget elements and choose the preview type, size, state, and theme. The full grid, including all rows and the Unused area, is shown below.
Screenshot: The complete design editor, including the row and column layout grid and the Unused area. Select an element before moving it.
Select Themes to preview and edit colors independently of the design. Choose a design and widget type for the preview.
Screenshot: The theme editor with its preview and color controls. The selected widget design determines how these colors appear.
Each size has its own layout, organized into 1–10 rows and groups of columns. Select Widget to choose the number of rows for the current size. Reducing the number requires confirmation: removed rows lose their settings, their elements move to Unused, and spanning columns are shortened. Undo restores the previous layout.
Select the Widget bar, a row, column, or element to see its options. Tap or click the selected item again to deselect it. Select the item first before dragging it. Drag a row label to reorder rows, the top line of a column to reorder columns within its row, or an element to move it into a group. An insertion indicator shows where an element will land. Move an element to Unused to remove it from that layout; drag it back to restore it.
- Set each column's horizontal or vertical element arrangement, alignment, vertical alignment, width mode, and span.
- A row has four span units, including any units occupied by columns spanning down from earlier rows. Increasing a column span can reduce or remove other columns; reducing it adds empty one-unit columns at the row's end.
- A column can span multiple rows. It is shown across those rows in the editor, fits its content, and leaves fewer span units for their other columns. When space is needed, wider columns in affected rows are reduced before extra columns are merged. Review the affected rows after changing spans or row order.
- Fit-to-content columns take their natural width where space permits; other columns share remaining width according to their spans. Narrow content may be truncated.
- Set row alignment, top padding and visibility for inactive, paused, running and start-form-open states. A start-form timeout on a visible row can close the form automatically; the earliest configured timeout applies.
- Select an element to set an optional per-size size override. Leave it empty to use the app default. Configure start-field rows independently for timers and transitions, and optionally allow some elements to shrink on narrow widgets.
- For a Duration or Status bar element, enable Reserve space when hidden to keep its space in that size's layout when it is hidden or not applicable to the selected type. This helps keep other elements aligned across chronograph types and states.
- Set the size's height mode to Auto, Minimum including input fields, or Minimum excluding input fields. The latter can grow when the start form appears.
Rows and columns are configured per size and shared across states. Each size also has a base element layout; state-specific element positions override the base only where explicitly changed. Start-form positions inherit the inactive layout before their own overrides. Check all relevant states and sizes after editing. Start and Play / Resume are separate elements.
Use Copy layout from to copy another size's row count, layout and positioning into the selected size. This replaces its layout after confirmation, but leaves other size-specific settings, such as button text and element sizes, unchanged.
Select a button element to choose a round or square shape. The shape applies to all widget sizes unless Override for this size is enabled. Disabling the override restores the shared shape for that size.
Select a button element to configure its text separately for each widget size. With Use default text checked, the translated default appears as a placeholder. Uncheck it to enter custom text; custom text is the same in every language. Leave it empty to show only the button icon.
Timer and transition designs can include a status bar. Configure its direction, timer fill/empty behavior and optional transition step markers in the design; set its background and fill colors in the theme. The preview uses sample progress. The real widget uses the active chronograph's progress and, for transitions, its actual step count. The bar is not displayed on stopwatches.
Select the widget background or an element to edit its colors. Buttons have separate background, border and text/icon colors. Select None for a transparent background or no border. Set the base colors in the inactive state; other states inherit those colors unless you override them. Choose Inherit to remove an individual override. Colors are shared across widget sizes. Preview combinations with different designs and states before saving. The Cancel button retains its original theme border unless you choose a specific border color or None.
Choose the built-in Settings design and Settings theme together for an appearance inspired by the chronograph list in app settings.
Support development - If Chronograph is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!

