Skip to content

00. Installation

Jump to bottom
Valéry Letroye edited this page Feb 18, 2021 · 4 revisions

Install my Mods Packager

Mods Packager is a AnyCPU .Net 4.5 Application for Windows. You can

  • either download the last release sources from here and unzip them into a folder to build the executable yourself with Visual Studio.
  • or download the ModsPackagerSetup.exe to install the binaries on your PC.

Windows will block the execution of installer. Click on "More Info" and next on the button "Run anyway". Do this at your own risk. If you dont trust this binary, your have better check the source code and recompile it yourself.

Mods Packager Installer blocked

Run Mods Packager Installer

Mods Packager has dependencies on various libraries and executables:

  • BouncyCastle: API intended to sign the SPK files in the futur...
  • Magick.NET-Q16-AnyCPU: API used to make icons transparent.
  • Newtonsoft.Json: API used to serialize and deserialize Json strings.
  • ScintillaNET: API used to highlight Shell Scripts and Json.
  • YamlDotNet: API used to serialize and deserialize Yaml strings.
  • ZTn.Json.Editor: UI used to edit json string.
  • INIFileParser: to parse files with an INI structure (such as Port Config files).
  • [Hash.exe]: an executable created to compute the checksum of the created packages and to update their INFO file accordingly.

Mods Packager uses various resources located in the subfolder 'Resources':

  • HelpSynoWizard.csv: contains a description of all fields supported in installation/uninstallation/upgrade json wizards. These information come from Synology's Developer Guide.
  • synology_models.yaml: contains all architectures and models of Synology. You can edit that file or take the latest version from the SSPKS Package.
  • synology_services.yaml: contains all services that can be restarted when the package is installed/removed/stopped and started.
  • synology_dependencies.yaml: contains all services that can possibly be installed before the package.
  • Pack.cmd and Unpack.cmd: used to pack all Package's files into a new SPK or to unpack all files from an existing SPK.
  • 7z.exe and 7z.dll: required to pack or unpack files
  • shellcheck.exe: to validate the Shell Scripts edited with Mods.

When running for the first time, Mods Packager will add several resources in the subfolder 'Resources':

  • backwizard.png: used as background image when rendering installation/uninstallation/upgrade json wizards.
  • default.runner: default script going to be used to run your own script in a floating/popup of the DSM. You can edit that script directly with notepad++ or within Mods Packager.

Install Packages created with Mods Packager

Once a Package has been generated with Mods Packager, it can be installed on your DSM. But here are some prerequisite.

First, if your package relies on "Init 3rd Party" to run php scripts (only supported on DSM 6.x and older), you obviously have to install it; add therefore the required "custom Package Source" in your DSM:

  1. Open 'Package Center'.
  2. Click on 'Settings'.
  3. Click on 'Package Sources'.
  4. Click on 'Add'.
  5. Add 'cphub' with 'https://www.cphub.net' as Location.

The Package to be installed is Init 3rdParty. Do:

  1. Open 'Package Center'.
  2. Click on 'Community'.
  3. Click on 'Install' under 'Init 3rdParty'.

Next, you have to allow the installation of your own packages. To do so:

  1. Open the 'Package Center'
  2. Click on 'Settings'
  3. Select the option 'Any Publisher' in the section 'Trust Level'

Clone this wiki locally