Windows on Arm Ready Software

Contributing to this site

Applications

Contributions for apps can be made directly to the github project or using a convenient form process.

How to contribute via Microsoft Forms (apps)

Fill out the below form with your App request. You can use this form for requesting a new app to be tested and added, to tell us where we have something wrong for an app, or to submit your own new app data. We recommend you contribute via the Microsoft Form and not via the Github unless you have some technical experience. Scroll down to see more details on the defined schema and category definitions.

Click here to open the MS Form directly

How to contribute via GitHub (apps)

You will need your own GitHub account. If you do not already have one, go to https://github.com, click on Sign up in the top right corner of the page and follow the instructions from there.

Once you have your account, go to https://github.com/Linaro/works-on-woa/fork to fork (i.e. make your own copy) of the repository for this website.

Once you have forked the repository, clone it to your computer with the git clone command. See https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository for more guidance if you need it.

Once you have cloned the repository, make the necessary changes to the files. Guidance can be found below on the contents required and optional for each of the different files. If you need help, please create an issue via https://github.com/Linaro/works-on-woa/issues/new and we’ll do our best to help.

When you’ve made your changes, commit them to your own repository and then push them back to GitHub.

Finally, create a Pull Request to ask for your changes to be merged into the official repository. Your request will be reviewed and, if approved, merged into the site.

PLEASE NOTE! It is strongly recommended that you try to build the website locally on your computer before pushing changes back to GitHub. This will ensure that the site builds correctly and you do not have any errors in your contribution. Please see the section Developer Info in the README file for instructions on how to do this.

File content details

For applications there is a defined schema to ensure consistency of data across the submissions.

Each entry is stored in a file with a .md file extension. Application entries are stored under src/content/applications.

If you are contributing your own report on an existing entry, it should be stored under src/content/user_reports_applications or src/content/user_reports_games as appropriate.

Each file consists of:

Applications schema

Information stored in an application entry must follow this schema:

FieldTypeNotes
namestringThe application’s name.
iconstringOptional. The path to the icon file to use, relative to public/icons. 512x512 maximum. Use SVG if possible.
categorieslistA list of one or more categories that the application belongs to. A list of categories can be found in src/content/applications_categories. Categories are referenced by their file name in this folder.
display_resultenum
  • Compatible
  • Unknown
  • Unsupported
  • Vendor Announced - Launching Soon
Displayed Arm compatibility:
Compatible: the tested app works on Windows on Arm
Unknown: The status is unknown
Unsupported: this value is not currently used
Vendor Announced - Launching Soon: this value is currently not used
compatibilityenum
  • native
  • emulation
  • no
  • unknown
Windows on Arm compatibility:
Native: WoA native support available
Emulation: Works with x86/x64 emulation
No: Not yet ported
Unknown: Status not known
version_fromstringThe version that the software is available to use from.

For software that can be compiled from one version, but is only publicly available from the other (i.e., Python was able to be compiled way earlier than they started making WoA releases), the publicly available version is to be entered here, as that is typically what most end users would want.

The compilable from version (and any caveats associated with it) can be added freehand in the notes section.
linkURLA link to where the software can be downloaded, or the application’s main website.

Applications User Report schema

Users can add their own findings regarding an application that has been added to this site. The file can have any unique filename (with a .md extension) and the contents must follow this schema:

FieldTypeNotes
reporterstringOptional. Your name.
applicationstringThe name of the application from its own filename, i.e. without the .md extension
device_configurationstringOptional. Any information about your configuration that may have an influence on the report.
date_testeddateOptional. Format is YYYY-MM-DD
compatibility_detailsstringYour report of how the application ran for you.

Categories

The categories list is constructed with an open square bracket [, one or more categories separated by commas, and a close square bracket ].

Categories must match the file name of an .md file in the appropriate categories folder as specified earlier.

Games

Contributions can be made directly to the github project or using a convenient form process.

How to contribute via Microsoft Forms (games)

Fill out the below form with your game test details. We recommend you contribute via the Microsoft Form and not via the Github unless you have some technical experience. Scroll down to see more details on the defined schema and category definitions.

Click here to open the MS Form directly

How to contribute via GitHub (games)

You will need your own GitHub account. If you do not already have one, go to https://github.com, click on Sign up in the top right corner of the page and follow the instructions from there.

Once you have your account, go to https://github.com/Linaro/works-on-woa/fork to fork (i.e. make your own copy) of the repository for this website.

Once you have forked the repository, clone it to your computer with the git clone command. See https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository for more guidance if you need it.

NOTE: You need to clone the repository into WSL (Windows Subsystem for Linux). The repository will not build locally unless it is in WSL.

Once you have cloned the repository, make the necessary changes to the files. Guidance can be found below on the contents required and optional for each of the different files. If you need help, please create an issue via https://github.com/Linaro/works-on-woa/issues/new and we’ll do our best to help.

When you’ve made your changes, commit them to your own repository and then push them back to GitHub.

Finally, create a Pull Request to ask for your changes to be merged into the official repository. Your request will be reviewed and, if approved, merged into the site.

PLEASE NOTE! It is strongly recommended that you try to build the website locally on your computer before pushing changes back to GitHub. This will ensure that the site builds correctly and you do not have any errors in your contribution. Please see the section Developer Info in the README file for instructions on how to do this.

File content details

For games, there is a defined schema to ensure consistency of data across the submissions.

Each entry is stored in a file with a .md file extension. Game entries are stored under src/content/games.

If you are contributing your own report on an existing entry, it should be stored under src/content/user_reports_games.

Each file consists of:

Games schema

FieldTypeNotes
namestringThe name of the game.
iconstringOptional. The path to the icon file to use, relative to public/icons. 512x512 maximum. Use SVG if possible.
categorieslistA list of one or more categories that the game belongs to. A list of categories can be found in src/content/gamess_categories. Categories are referenced by their file name in this folder.
publisherstringOptional. The name of the game’s publisher.
frame_ratestringOptional. Frames per second of the game.
device_configurationstringOptional. Device used to test the game.
os_versionstringOptional. OS version used to test the game.
driver_idstringOptional. ID of graphics driver used to test the game.
date_testeddateOptional. Format is YYYY-MM-DD
compatibilityenum
  • perfect
  • playable
  • runs
  • unplayable
How well the game plays. See help page for more information on how these are defined.
compatibility_detailsstringOptional. Any additional information about the compatibility.
auto_super_resolutionblockOptional. See example below for syntax.
- compatibilityenum
  • yes, out-of-box
  • yes, opt-in
  • no
  • unknown
Optional. Indicates compatibility with Auto Super Resolution feature. Opt-in means you need to enable the feature in Windows Settings, and out-of-box means that Auto SR is applied without changing any settings.
- fps_booststringOptional. How much Auto SR boosts the frame rate of a game by.
- opt-in stepsstringOptional. Steps on how to enable Auto SR for games that are opt-in.
linkURLA link to where the software can be downloaded, or the application’s main website.

The auto_super_resolution block is optional but, if present, the attribute compatibility must be present. The block is formatted like this:

   auto_super_resolution:
      compatibility: yes, out-of-box

Games User Report schema

Users can add their own findings regarding a game that has been added to this site. The file can have any unique filename (with a .md extension) and the contents must follow this schema:

FieldTypeNotes
reporterstringOptional. Your name.
gamestringThe name of the game from its own filename, i.e. without the .md extension
device_configurationstringOptional. The name of the device that you used.
date_testeddateOptional. Format is YYYY-MM-DD
os_versionstringOptional. The OS version on your system.
driver_idstringOptional. The graphics driver id on your system.
compatibilityenum
  • perfect
  • playable
  • runs
  • unplayable
How well the game plays. See help page for more information on how these are defined.
compatibility_detailsstringYour report of how the application ran for you.
auto_super_resolutionblockOptional.
- compatibilityenum
  • yes, opt-in
  • no
  • unknown
Indicates compatibility with Auto Super Resolution feature. Opt-in means you need to enable the feature in Windows Settings.
- fps_booststringHow much Auto SR boosts the frame rate of a game by.
- opt-in stepsstringOptional. Steps on how to enable Auto SR for games that are opt-in.

Note that for user game reports, auto super resolution compatibility can only be yes, opt-in or no, or unknown.

Categories

For the game category list, this is constructed with an open square bracket [, one or more categories separated by commas, and a close square bracket ].

Categories must match the file name of an .md file in the appropriate categories folder as specified earlier.