Skip to content
Cross compilation framework to create native packages for the Synology's NAS
Shell JavaScript C++ Python Perl C Other
Branch: develop
Clone or download
Pull request Compare This branch is 40 commits ahead, 1712 commits behind SynoCommunity:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



spksrc is a cross compilation framework intended to compile and package softwares for Synology NAS


To use spksrc, it is recommended to use a virtual machine with an x86, 32-bit version of Debian stable OS installed. Non-x86 architectures or 64-bit architectures are not supported.

You'll also need some stuff:

sudo aptitude install build-essential debootstrap python-pip automake libgmp3-dev libltdl-dev libunistring-dev libffi-dev ncurses-dev imagemagick libssl-dev pkg-config zlib1g-dev gettext git curl subversion check bjam intltool gperf flex bison xmlto php5 expect libgc-dev mercurial cython lzip cmake
sudo pip install -U setuptools pip==1.5.4 wheel==0.23 httpie

You may need to install some packages from testing like autoconf. Read about Apt-Pinning to know how to do that.

You are now ready to use spksrc and make almost all SPKs. If you have any problem, try installing the missing packages on your virtual machine.


Lets start with an example:

git clone
cd spksrc/
make setup
cd spk/transmission
make arch-88f6281

What have I done?

  • You cloned the repository
  • Went into the directory of the SPK for transmission
  • Started building the SPK for the architecture 88f6281
    • To list all available architectures use ls toolchains from within the spksrc directory. Remove the prefix syno- to have the actual architecture.
    • An overview of which architecture is used per Synology model can be found on the wiki page Architecture per Synology model

At the end of the process, the SPK will be available in spksrc/packages/

What is spksrc doing?

  • First spksrc will read spksrc/spk/transmission/Makefile
  • Download the adequate toolchain for the chosen architecture
  • Recursively:
    • Process dependencies if any
    • Download the source in spksrc/distrib/
    • Extract the source
    • configure
    • make
    • make install
  • Package all the requirements into a SPK under spksrc/packages/:
    • Binaries
    • Installer script
    • Start/Stop/Status script
    • Package icon
    • Wizards (optional)
    • Help files (optional)


The only thing you should be editing in spksrc is Makefiles. To make a SPK, start by cross-compiling the underlying package. To do so:

  • Copy a standard cross package like spksrc/cross/transmission/Makefile in your new package directory spksrc/cross/newpackage/
  • Edit the Makefile variables so it fits your new package
  • Empty variables DEPENDS and CONFIGURE_ARGS in the Makefile
  • Try to cross-compile and fix issues as they come (missing dependencies, configure arguments, patches)
    • cd spksrc/cross/newpackage/
    • make arch-88f6281
    • Use make clean to clean up the whole working directory after a failed attempt
  • On a successful cross-compilation create a PLIST file with the same syntax as spksrc/cross/transmission/PLIST but based on the auto-generated PLIST for your new package at spksrc/cross/newpackage/work-88f6281/newpackage.plist

Once you have successfully cross compiled the new package, to create the SPK:

  • Copy a standard SPK directory like spksrc/spk/transmission in your new SPK directory spksrc/spk/newspk
  • Edit the stuff to fit your needs

After all that hard work, submit a pull request to have your work merged with the main repository on GitHub and published in SynoCommunity's repository.

If you are not familiar with git or GitHub, please refer to the excellent GitHub help pages.


If you like spksrc and packages made out of it, please consider making a donation to his authors:

  • Diaoul
  • moneytoo
  • piwi82
  • bru7us


If you find a bug please report it in the bug tracker if it has not already been reported. Be sure to provide as much information as possible.


When not explicitly set, files are placed under a 3 clause BSD license

You can’t perform that action at this time.