For EdgeTX v2.5 compatible themes, please goto the 2.5 branch.

To download all themes, hit the green Code button above and choose Download ZIP. Alternatively you can git clone the whole repo with a git tool of your choice.

• Contents (ToC):
  • Online theme creator
  • List of themes available
  • Description of an EdgeTX theme
  • Steps to contribute

Please give the online themer tool created by @edriskus a try. It is a nice, simple and easy to use app that lets you play with the theme colours and generate the required files.

A theme for EdgeTX consists minimally of 5 files, all located in a dedicated subfolder (in the example here themename):

• themename/theme.yml (your theme configuration file with name, summary, and color settings)
• themename/logo.png (a logo/banner for your theme)
  
• themename/screenshot1.png (first screenshot, of the main screen with some common widgets selected)
  
• themename/screenshot2.png (second screenshot, of model selection screen with at least two models present)
  
• themename/screenshot3.png (third screenshot, of the channel monitor, or alternately, Radio/Hardware tab where warning text color shown)
  

Optional:

• themename/background_480x272.png (a background image for your theme in 480 x 272 pixel resolution, e.g. for TX16S, T16, X10, X12S)
• themename/background_320x480.png (a background image for your theme in 320 x 480 pixel resolution, e.g. for NV14)
• themename/readme.txt (any notes or information you wish to share with your theme)

Images should all be in PNG format, and 480x272 pixels in size, except the optional 320x480 background image.

Please refer to the example folder for an example of the expected layout.

Please refer to theme documentation for more information on the theme file format.

Please note that themes are currently still in development phase in EdgeTX and the specification can change. Thus please be prepared that at some point in (near) future you might be asked to update your submission, as we change the specification, e.g. about the image size or YAML style required.

In order to take screenshots using the EdgeTX simulator, first start EdgeTX Companion, pick from menu Settings the menu item with similar name Settings... Navigate to Simulator Settings tab and provide a folder where you would like the simulator to save the images (here in example Z:\Multimedia):

When using EdgeTX Simulator, click on the Screenshot icon to take a screenshot:

If you want to contribute at current early stage in spite of the warning above, here are the steps:

1. If you do not yet have a GitHub account, create it (it is free)
2. Fork this repo by clicking Fork in upper right
3. Make a branch (by clicking down arrow at "main" and typing an arbitrary name without spaces, e.g. "mytesttheme" and clicking "Create branch")
4. Commit your changes to your newly created branch.
   You can work via GitHub Web interface or optionally you can do this also locally. Instructions for local command line would be:
   git clone -b mytesttheme https://github.com/your_user_name_in_GitHub/themes.git ~/edgetx/themes
   Then add the files with git add, followed by a commit with git commit -m "commitmessagehere" and then push with git push
   If you are a Windows user and looking for a graphical tool for Git, have a look at e.g. TortoiseGit
5. Make a pull request by clicking the big green "Compare & Pull Request" button in GitHub in your fork's branch.