Website Themes

Website themes are one of the kinds of themes supported by Time Out. See the Break Themes page for more information.

Website themes are simply a URL to an online website. Themes are stored in the Themes folder of your Time Out data, which can be opened in the Finder via the Reveal Themes item in the Theme pop-up menu on the Break Appearance page.

Each theme is stored in a folder named for the theme title, with an extension of "totheme", e.g. "Amazon Deals.totheme".

Within this folder, website themes only have one file, an "Info.json" file in JSON format. This file must be present, with this name.

For website themes, the format of this file is simple, and can be easily updated via the theme editor. Here's an example for the "Amazon Deals.totheme" one; others would be similar:

{
  "author": {
    "name" : "David Sinclair",
    "email" : "support@dejal.com",
    "url" : "https://dejal.com/"
  },
  "credits" : {
    "name" : "Amazon.com",
    "url" : "http://amazon.com/"
  },
  "comments" : "Displays the Amazon.com Deals page; browse today's specials during the break.",
  "created" : "2015-09-24",
  "identifier" : "Amazon Deals",
  "modified" : "2015-09-29",
  "version" : 2,
  "name" : "Amazon Deals",
  "url" : "http://amzn.to/1Pz6tdy"
}

The "url" is of course the most important property, being the URL to load and display during the break.

The "author", "credits" and "comments" values are displayed in the information popover, accessed via the info button next to the Theme pop-up menu on the Break Appearance page. The author is you, as the theme creator. The credits provide a link to the original site. The comments should be a brief description of the site. Again, it's better to edit these values via the theme editor.

It's easy to add themes, or modify existing ones. If you add a theme that others might find useful, please submit it to Dejal so it can be shared on the Time Out Extras site, or even bundled in a future version of the app. See that site for more information.