This project contains the source and tools for software packages for Western Digital My Cloud (OS3) NAS devices. The packages are made available via the WDCommunity website. Most of the packages are simply scripts to fetch the applications from the official sources and configure them with a sensible default. Only a few packages were compiled with the OS3 toolchain with the help of the SynoCommunity project tools.
Most of the packages are published on the WD community forum in their own thread. Use the search bar.
Setup Development Environment
For simple script based apps (most of the current packages), you only need mksapkg to create a binary.
On Ubuntu 16.04:
apt-get install libxml2:i386
Ensure you have openssl v1.0.x, not openssl v1.1+ (as is the case on Ubuntu 18).
The build environment is also available in a docker image.
docker build -t wdpk . docker run -it -v $(pwd):/wdpksrc wdpk /bin/bash cd wdpk/<somepackage> ./build.sh
Build and deploy test
./build_and_install.sh <package> <host>
This will build the package, install it on a PR4100 host device and run a sanity check if a test is available.
If you want to compile native apps, you'll need a complete wdpksrc / spksrc toolchain. Then follow the
Currently, these custom WD targets are available in this SynoCommunity fork
- wdx64 - WD PR2100/PR4100/DL2100/DL4100
- wdpro - WD PR2100 / PR4100 with 4.1.9 kernel
- wddl - WD DL2100 / DL4100 with 3.10.28 kernel
- wdarm - all other devices (firmware version 2.x only!)
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.
Note that spksrc creates synology SPK packages.
- rename the .spk package with the .tar extension
- unpack with tar xf somepackage.tar
- move the bins and libs to your wdpk somepackage
- modify the start/stop scripts as necessary into the wdpk format, stripped from all synology specific logics.
Feel free to donate to the SynoCommunity project.
When not explicitly set, files are placed under a 3 clause BSD license