synology-nas-api

N8N nodes for Synology NAS API

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.4.0
Author: venator12

Available Nodes

Documentation generating…

Synology NAS API icon
Synology NAS API
Call any Synology DSM Web API endpoint directly (advanced/generic requests)
Synology NAS Drive icon
Synology NAS Drive
Manage files and folders on a Synology NAS (File Station)
Synology NAS Photos icon
Synology NAS Photos
Browse photos, albums and tags from Synology Photos

Documentation

n8n-nodes-synology-nas-api

n8n community nodes to manage files and browse photos on a Synology NAS.

  • Synology NAS Drive — File Station: list, upload, download, move and copy files/folders.
  • Synology NAS Photos — browse recent photos, get a single photo, download the original file, list albums and tags.

Both nodes share a single Synology NAS API credential, which supports accounts protected by 2-factor authentication (OTP).

Installation

In n8n, go to Settings → Community Nodes → Install, and enter:

n8n-nodes-synology-nas-api

Credential setup

  1. Create a new Synology NAS API credential with your NAS's protocol, host, port, username and password.
  2. If your account does not use 2-factor authentication, you're done — click "Test" to verify.
  3. If your account does use 2FA:
    • Add the Synology NAS Drive node to a workflow, set resource Session → operation Generate Device ID, enter the current OTP code from your authenticator app, and execute it once.
    • Copy the returned deviceId value into the Device ID field of your credential.
    • Future executions will authenticate as a trusted device and won't need an OTP code again.

Nodes

Synology NAS Drive

Operation Description
List List files/folders in a directory
Upload Upload a binary input file to a folder
Download Download a file to binary output
Move Move a file or folder to another folder
Copy Copy a file or folder to another folder

Synology NAS Photos

Resource Operation Description
Photo List List photos, sorted by taken time or filename
Photo Get Get metadata for a single photo
Photo Download Download the original photo file
Album List List albums
Tag List List all tags in the Photos database
Tag Get for Photo Read the tags assigned to a photo

Development

npm install
npm run dev    # start n8n locally with these nodes loaded
npm run build  # compile for publishing
npm run lint   # check for issues

License

MIT

Discussion