schnatterer/dsdl repository overview

⁠dsdl

DiskStation Downloader (formerly photostationtagdownloader / pstd)

Downloads files from Synology DiskStation Manager⁠. Supports downloading

• photos (all photos of a tag / "smart album") via Photo Station⁠ and
• audio (all songs of a playlist) via Audio Station⁠

⁠Use Cases

⁠Photos

• Set tags (i.e. IPTC keywords⁠) for photos, grouping them into "smart albums"
• dsdl downloads those for you. For some reasons this cannot be achieved using the Photo Station web app, nor native Android or Windows apps.

⁠Audio

• Group your songs into playlists
• dsdl downloads those for you. You can also do this via the web UI (where the playlist is zipped) or with DS audio⁠ but it does not seem to work reliably and it cannot be scripted 😉

⁠Usage

⁠Prebuilt binaries

Get the binary for your specific OS from the release page⁠.

wget -O dsdl https://github.com/schnatterer/dsdl/releases/download/2.0.0/dsdl-linux-x64
chmod +x dsdl

Use it like so:

• photos

  ./dsdl photo --user your-diskstsation-user --output photos/ http://diskstation/photo
  

  Copy
• audio

  ./dsdl audio --user your-user --output music/ http://diskstation:5000/
  

  Copy

You will be prompted for the password.

⁠Docker

docker run --rm -ti -v $(pwd):/dsdl schnatterer/dsdl:2.0.0 audio --user  your-photostation-user --output /dsdl http://diskstation/photo

Make sure uid/gid 1000 are allowed to write into current folder.

⁠Node.js

You can also run it with your own node js instance. This also allows for running on platforms that are not supplied with prebuilt binaries, like arm/arm64. For example on android, you can run dsdl via termux⁠.

yarn install
node src/cli/dsdl.js photo --user your-photostation-user --output photos/ http://diskstation/photo

⁠Non-interactive password

If running in batch/non-interactive mode, you you can just pipe it to dsdl. Note that passwords showing up in the shell history or log files are a potential security risk.

echo "PW" | ./dsdl photo -u ...

⁠Options

⁠General

• --folder-structure
  • Default: list - creates subdirs for each list.
  • flat - writes all photos to a single folders.
  • server - creates same folder structure as on server (Works only for audio).
    Or is there a way to get the album for a photo via the Synology Photo Station API?

⁠Photo

• --tags - downloads specific tags. Note that tags containing spaces must be quoted. Multiple tags can either be specified
  • comma separated (e.g. --tags "tag one",numberTwo) or
  • by using multiple parameters (e.g --tags "tag one" --tags numberTwo)

⁠Audio

• --playlists - downloads specific playlists. Note that playlists containing spaces must be quoted. Multiple playlists can either be specified
  • comma separated (e.g. --playlists "tag one",numberTwo) or
  • by using multiple parameters (e.g --playlists "tag one" --playlists numberTwo)
• --m3u - Create m3u playlist files for each downloaded playlist