Repository navigation
Home
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 |
- 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.
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.
- 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.

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.
- Install FTP Client.
- Read the FTP Client community topic for discussions and user examples.
- Report reproducible bugs or request features in the GitHub issue tracker. Older forum posts refer to Bitbucket; the project has moved to GitHub.
Support development - If FTP Client is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!