Skip to content

Renaming your module

Julian Waller edited this page Oct 14, 2023 · 1 revision
  1. Make sure you are happy for any changes in the main branch of the module to be included into beta builds of Companion

  2. Ask in the module-development slack for approval on the new name
    This is so that we can be sure the new name conforms to our standard structure of companion-module-manufacturer-product (or companion-module-manufacturer-protocol).

  3. Once approved, the team will be able to rename the GitHub repository for you.

  4. Some additional changes need to be made. This might be done for you, or might be left for you to do:

    • Update the name and any urls in the package.json
    • Update the name and related fields in companion/manifest.json
    • Add the old name to the legacyIds array in companion/manifest.json. This lets Companion know of the rename, so that existing users will be migrated accross.
  5. Once everything is updated, this can be included in the builds

A note for the maintainers running the build script, the old module name will need to be manually removed from the bundled-modules github repository.

Clone this wiki locally