/WDD-themes

Community submitted themes for WinDynamicDesktop

Primary LanguagePython

WDD-themes

Community submitted themes for WinDynamicDesktop. Automatically published to the WDD Themes site.

Submit New Themes

Create and package your theme

Follow the instructions here to create your own theme. Then package the images and theme.json file into a ZIP archive.

Rename the file to change the .zip extension to .ddw. The rest of the filename should equal your theme ID.

Make sure your theme meets the following requirements:

  • Theme ID must be unique and can only contain alphanumeric, hyphen (-), and underscore (_) characters
  • Theme package must contain theme.json file at top level
  • Theme JSON must include required keys (dayImageList, imageCredits, imageFilename, nightImageList)
  • Theme package cannot contain extra files in addition to images and theme.json
  • Theme package must include all images referenced in theme.json
  • Image size must be at least HD resolution (1920x1080)
  • Image ratio must be landscape or square (16:9 is recommended)
  • Image shown at noon should be brightest image in the set
  • Image shown at midnight should be darkest image in the set
  • Image credits must include name of the original artist/photographer

Publish your theme to direct link

Upload your DDW file for others to download and use in WDD. Your theme must be uploaded to a direct link, meaning you must provide a URL which downloads the file directly rather than going to a web page with a download button.

You can host your theme on OneDrive or Google Drive and obtain a direct link by following instructions in the links below:

Create pull request for your theme

Open a pull request (PR) in this repository to add your theme to the list on the WDD Themes site. Only one of the following files must be updated in your PR:

Find one of these files on GitHub and click the pencil icon to fork this repository and edit the file:

Edit the file in your fork of this project

You only need to add two lines to the YAML file for your theme:

<theme_id>:
- <theme_url>

After adding these lines, label your changes with "Add <themeName> theme" and click "Propose changes":

Propose changes

Confirm your changes and click through the green buttons labeled "Create pull request".

After your PR has been created, wait for the Check Theme task to run. It will scan your .ddw file to check that it meets all the requirements listed above. If the scan fails, click the "Details" link to find out why:

All checks have failed

If any issues are reported, fix them and rerun the Check Theme task by posting a comment with the line /check-theme:

Check Theme comment

Once the Check Theme task has succeeded, your theme is ready to be published. A WDD theme reviewer will merge your pull request to add it to the WDD Themes site.