Jump to content

Extension catalog

From SimTX Wiki

The extension catalog is a collection of Lua extension packages and transmitter presets shared through the connected SimTX server. It is opened with the Catalog button in the transmitter footer.


Choose between a package and a preset[edit | edit source]

  • An extension adds a mode, processor, tool, theme, or library.
  • A station preset fills in transmitter settings. Applying one can change frequency, source, power, location, and antenna together.

For first use, find an item, select Preview Selected, then follow the appropriate installation steps below. Preview alone does not install it. After applying a preset, check the frequency and any local file paths before pressing Start TX.

Publishing requires permission on your SimTX account.

Browsing[edit | edit source]

The catalog can be searched by name, author, description, package ID, version, type, and category. Separate filters select an extension type or community category. Results may be sorted by update time, name, author, size, type, or category.

Each entry displays its types, categories, name, package version, catalog revision, author, description, file count, size, and update time.

Preview Selected downloads the entry and shows its metadata, folder tree, file paths, and complete file contents. Previewing does not install the item.

Installing an extension[edit | edit source]

  1. Select an extension and choose Install Selected.
  2. If required packages are missing, review the dependency list and continue.
  3. Review each package's files in the installation preview.
  4. Select Install.

The package is checked before installation and is then loaded without restarting the transmitter. An installed package appears in the Extensions window. Loading errors appear in its Problems tab.

Extensions installed from the catalog update automatically when you reconnect. Your locally created packages are not changed.

Installing a preset[edit | edit source]

A preset entry contains a complete transmitter station configuration. After installation it appears in the Presets menu. The application offers to apply it immediately. Presets are not updated automatically because a revision could change the operator's active settings.

Safety and review[edit | edit source]

Review the files shown before confirming installation. See the extension environment for details about what extensions can access.

Publishing[edit | edit source]

Publishing requires catalog publication permission on the signed-in SimTX account.

To publish an extension:

  1. Open Catalog.
  2. Select Share Extension Folder....
  3. Choose a package folder containing extension.properties.
  4. Enter the catalog name and description.
  5. Select existing community categories or enter new comma-separated categories.
  6. Confirm the upload.

To publish the current transmitter setup, select Share Current Settings... instead. No preset file needs to be created first.

A publication may have at most 12 categories, and each category name may contain at most 32 characters. An extension publication contains its manifest and Lua files. A preset publication contains one .stxpreset file. Catalog packages may contain at most 64 files, with a maximum of 60 KiB per file.

Revisions and editing[edit | edit source]

A new catalog name begins at revision 1. Only its original author may publish later revisions under that name. The catalog entry retains its identity and increments its revision number.

The author may select an entry and choose Edit Publication. The editor permits changes to the description, categories, and file contents, or replacement of the complete source folder or preset file. The proposed files are validated before the new revision is published.

Related pages[edit | edit source]