Nonchalantly Perusing Magazines

    dsdl

    3.0.3-RC1 • Public • Published

    dsdl

    Build Status schnatterer/dsdl@docker hub QGate Coverage TecDebt

    DiskStation Downloader (formerly photostationtagdownloader / pstd)

    Downloads files from Synology DiskStation Manager. Supports downloading

    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
    • audio
      ./dsdl audio --user your-user --output music/ http://diskstation:5000/

    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

    Keywords

    none

    Install

    npm i dsdl

    DownloadsWeekly Downloads

    1

    Version

    3.0.3-RC1

    License

    MIT

    Unpacked Size

    27.2 kB

    Total Files

    8

    Last publish

    Collaborators

    • schnatterer