Skip to content
Arie J. Godschalk edited this page Nov 15, 2026 · 7 revisions

FTP Client manual

With FTP Client, you can browse and manage files on an FTP server from Homey. You can also use Flows to save camera pictures, open files through a link, or send images to another app. Start with a small file transfer, then try a Flow when you're ready.

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 snapshots, play audio, or export text Examples
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.
  • Use Flow cards to get file URLs, list files as JSON, create image tokens, and save base64 data or image tokens to the server.
  • 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.

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.

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

File browser at a glance

FTP Client repair view showing folders and audio files in a grid

Historical developer screenshot. The list/grid controls are at the top; folders and files appear below. The surrounding Homey interface is in Dutch and may differ from your version.

Installation and support

Clone this wiki locally