spksrc is a cross compilation framework intended to compile and package software for Synology NAS devices. Packages are made available via the SynoCommunity repository.
Before opening a new issue, check the FAQ and search open issues. If you can't find an answer, or if you want to open a package request, read CONTRIBUTING to make sure you include all the information needed for contributors to handle your request.
Setup Development Environment
- Fork and clone spksrc:
git clone https://You@github.com/You/spksrc.git ~/spksrc
- Install Docker on your host OS: Docker installation. A wget-based alternative for linux: Install Docker with wget.
- Download the spksrc docker container:
docker pull synocommunity/spksrc
- Run the container with
docker run -it -v ~/spksrc:/spksrc synocommunity/spksrc /bin/bash
A virtual machine based on an 64-bit version of Debian 10 stable OS is recommended. Non-x86 architectures are not supported.
Install the requirements (in sync with Dockerfile):
sudo dpkg --add-architecture i386 && sudo apt-get update sudo apt install autogen automake bc bison build-essential check cmake curl cython debootstrap expect flex g++-multilib gettext git gperf imagemagick intltool libbz2-dev libc6-i386 libcppunit-dev libffi-dev libgc-dev libgmp3-dev libltdl-dev libmount-dev libncurses-dev libpcre3-dev libssl-dev libtool libunistring-dev lzip mercurial ncurses-dev php pkg-config python3 python3-distutils scons subversion swig unzip xmlto zlib1g-dev sudo pip install -U setuptools pip wheel httpie
You may need to install some packages from testing like autoconf. Read about Apt-Pinning to know how to do that.
Some older toolchains may require 32-bit development versions of packages, e.g. zlib1g-dev:i386
Once you have a development environment set up, you can start building packages, create new ones, or improve upon existing packages while making your changes available to other people. See the Developers HOW TO for information on how to use spksrc.
To support SynoCommunity, you can make a donation to its founder
When not explicitly set, files are placed under a 3 clause BSD license