How To Convert a Custom Remote from V2 to V3

The new V3 server uses a different format for custom remotes. This means that custom remotes made for V2 will not work with the V3 server. This tutorial will explain how to perform the conversion.


We have created a conversion tool. Go to and upload your V2 custom remote file.


Click "Convert" and you should get a list of potential problems. To download the generated files, click "Download". You should go through the potential problems so you know what you need to double check later.


Once downloaded, open the zip file and you should see a folder with 3 files (layout.xml, meta.prop, and remote.lua).


Open the custom remotes folder on your computer.

  • Windows: C:\ProgramData\Unified Remote\Remotes\Custom
  • Mac: ~/Library/Application Support/Unified Remote/Remotes/Custom
  • Linux: ~/opt/urserver/remotes/custom


Place the folder from the zip file into this folder.


You should always check the generated remote file to make sure it does what it is supposed to do. The converter will not be 100% accurate.


Once you're happy. Restart the server from the manager. Don't forget to check the server log for any unexpected errors: http://localhost:9510/web/#/log. Good luck!