Skip to content
Arie J. Godschalk edited this page Nov 19, 2026 · 9 revisions

FTP Client manual

With FTP Client, you can browse and manage files on an FTP server from Homey. Use Flows to save pictures and files, create temporary links, archive Simple (Sys) Log exports, and react to FTP connection or transfer problems. Start with a small file transfer, then try one of the examples.

I want to… Start here
Add a server and open its file browser Getting started
Check that my first upload and download work First file transfer
Configure a connection or its file URLs FTP Connection device
Browse, upload, download, or organize files Devices
Find the right app or device Flow card Flows
Save camera pictures or archive a log export Examples
Monitor FTP availability or failed transfers FTP Connection Flowcards
Fix a connection or file-access problem Troubleshooting

What you can do

  • Browse an FTP server's folders and files from a Homey device's repair view.
  • Create, rename, move, upload, download, and delete folders and files.
  • Keep all browsing and Flow file operations inside an optional configured working directory.
  • Monitor FTP availability, check the connection on demand, and receive triggers when the connection changes or a transfer fails.
  • Use Flow cards to get file URLs, list files as JSON, create image tokens, save files and pictures, or stream a Simple (Sys) Log export to FTP.
  • Connect to servers discovered on the network or enter a custom server.

Before you start

You'll need a local Homey and an FTP server: a computer, network storage device, or server app that lets you send and receive files over a network. The server must be running, and Homey must be able to connect to it. Have its address, port, username, and password ready; Getting started explains where to enter them.

You'll also need Better Logic Library. FTP Client uses this app to load parts of its file browser and provide file links. Install Better Logic Library and enable it on Homey as well as FTP Client.

Recommended first visit: follow Getting started to connect a server and verify a small file transfer. Then try the text-file example before building larger exports or camera workflows. To keep logs off the Flow token path, see archive a Simple (Sys) Log export.

Terms used in this manual

  • FTP Connection: a Homey device that remembers how to connect to one server.
  • Repair view: the device's file-management screen in Homey.
  • Flow card: an action you add to a Homey Flow.
  • Token: a value you can pass from one Flow card to another, such as a file link or an image. An Image token lets the next card use a picture; it is not a text link.
  • URL: an address or link you can open to access a file or image.
  • Base64: a way to represent file contents as text so another app can pass them along. It does not encrypt or protect the file.
  • NAS: a network storage device, often used to keep shared files or backups.
  • Working directory: the folder you choose as the FTP Connection device's root. FTP Client shows that folder as / and prevents navigation above it.

This manual describes the app's current development version. The available settings and Flow cards can change between app versions.

Connection status at a glance

FTP Client Flow card example: Status and transfer alerts

Actual Homey card examples, saved but disabled. They have not been run; follow this page for the full setup and connections.

Installation and support

Clone this wiki locally