Q-SYS Library

This tab is for managing and organizing your checked out assets. It is only shown when you are logged into the site with your QSC ID.

Sort/Filter

Use the dropdowns to sort and filter your checked out content.

Name

Displays the name of checked out content.

Manufacturer

Displays the manufacturer of checked out content.

Download/Remove

• Select Download to download a .zip file of the package. You will be prompted to choose the version of the package you wish to install. This can be used when you need to downgrade an asset. You will need to unzip the file and add the assets to the proper Asset Directory folder that you have set in Q-SYS Designer preferences (default for plugins: Documents > QSC > Q-Sys Designer > Assets).

• Select Remove to remove the asset from your library. This will unsubscribe you from the asset. This does not remove the asset from the local Asset Directory on your PC, but it will no longer show up in Asset Installer if updates are released, or if the asset is uninstalled from your local PC.

This tab is for managing and organizing your user packages.

Requirements

• NuGet Server that can be reached over the internet via HTTPS

  • Server must support NuGet v3 API

  • Feed/Package must be able to be read without credentials

• Package conforms to structure defined below

The following NuGet package managers have been tested with personal packages:

• MyGet

• Gitea

Package Structure

Minimum NuSpec contents used by Q-SYS Library for Personal Packages

• id - should be very unique and not conflict with other personal Packages or Q-SYS Library Packages

• version - This should follow Semantic versioning and only count up. the latest version a user has access to will be the version that they will see. NuGet Package Version Reference

• title - This will show in the Asset Installer in Q-SYS Designer Software

• icon - path to icon file in package

• iconUrl - path to public icon file accessible over the web

• description - short description of the asset

Sort

Use the dropdown to sort your packages.

Add Personal Package

Use to link to a user created package.

• Asset Name - Enter name for the asset

• Package URL - Enter URL for the package (i.e. OneDrive, Dropbox)

Steps to Add to your Library

1. Get your package registration URL.

   Note: Example: https://qsysassets.myget.org/F/bugfixing/api/v3/registration1/EugeneQsysCrossfadeRouter/index.json

   1. Go to V3 Feed URL https://qsysassets.myget.org/F/bugfixing/api/v3/index.json

   2. Grab first result with @type of RegistrationsBaseUrl

   3. Add <packageId>/index.json to end of that URL

   4. Test in a web browser, you should get json result with each version and the respective metadata

2. Navigate to Q-SYS Library

3. Log In and navigate to My Library.

4. On the My Packages tab press Add Personal Package.

5. Enter a name and the URL we formed in Step 1 and press Add Package.

6. You will see it show in the list and get a success popup.

Name

Displays the name of the user package.

Last Updated

Displays the date of the most recent update to the package.

Note: Packages are refreshed daily

Note: Packages can also be manually refreshed br hitting the menu icon on the right side of the package in the list.