{"id":6696,"date":"2025-05-26T17:43:54","date_gmt":"2025-05-26T15:43:54","guid":{"rendered":"https:\/\/www.pschatzmann.ch\/home\/?p=6696"},"modified":"2025-05-27T06:33:26","modified_gmt":"2025-05-27T04:33:26","slug":"arduino-audio-tools-using-ftp-as-data-source","status":"publish","type":"post","link":"https:\/\/www.pschatzmann.ch\/home\/2025\/05\/26\/arduino-audio-tools-using-ftp-as-data-source\/","title":{"rendered":"Arduino Audio Tools: Using FTP as Data Source"},"content":{"rendered":"

I published a new release of my TinyFTP library<\/a>, that I have converted to a header only C++ library and I changed the FTPClient to a templated class so that we can support an automatic session management with different Client implementations.<\/p>\n

I already provided an simple ftp example<\/a> in the AudioTools library<\/a> that just uses an individual FTP File as data source.<\/p>\n

However, I thought it would be cool to have a FTP audio source<\/strong> for the AudioPlayer!<\/p>\n

Example Arduino Sketch<\/h3>\n

Here is a simple example sketch the uses the ESP32 AI Thinker AudioKit as output device and we can use the buttons for navigating between the files. The data is loaded from a FTP Server!<\/p>\n

#include \"WiFi.h\"\n#include \"AudioTools.h\"\n#include \"AudioTools\/AudioCodecs\/CodecMP3Helix.h\"\n#include \"AudioTools\/AudioLibs\/AudioBoardStream.h\"\n#include \"AudioTools\/Disk\/AudioSourceFTP.h\"\n\nconst char* path = \"Music\/Tracy Chapman\/Matters of the Heart\";\nconst char* ext = \"mp3\";\nconst char* ftp_user = \"user\";\nconst char* ftp_pwd = \"pwd\";\nconst char* ssid = \"ssid\";\nconst char* ssid_pwd = \"ssid pwd\";\n\nFTPClient<WiFiClient> ftp;\nAudioSourceFTP<WiFiClient> source(ftp, path, ext);\nAudioBoardStream i2s(AudioKitEs8388V1);\nMP3DecoderHelix decoder; \nAudioPlayer player(source, i2s, decoder);\n\nvoid next(bool, int, void*) { player.next(); }\n\nvoid previous(bool, int, void*) { player.previous(); }\n\nvoid startStop(bool, int, void*) { player.setActive(!player.isActive()); }\n\nvoid setup() {\n  Serial.begin(115200);\n  AudioToolsLogger.begin(Serial, AudioToolsLogLevel::Info);\n  FTPLogger::setOutput(Serial);\n  \/\/FTPLogger::setLogLevel(LOG_DEBUG);\n\n  \/\/ connect to WIFI\n  WiFi.begin(ssid, ssid_pwd);\n  while (WiFi.status() != WL_CONNECTED) {\n    delay(500);\n    Serial.print(\".\");\n  }\n  Serial.println();\n  WiFi.setSleep(false);\n\n  \/\/ connect to ftp\n  if (!ftp.begin(IPAddress(192,168,1,39), ftp_user, ftp_pwd)){\n    Serial.println(\"ftp failed\");\n    stop();\n  }\n\n  \/\/ setup output\n  auto cfg = i2s.defaultConfig(TX_MODE);\n  if (!i2s.begin(cfg)){\n    Serial.println(\"i2s failed\");\n    stop();\n  }\n\n  \/\/ setup additional buttons\n  i2s.addDefaultActions();\n  i2s.addAction(i2s.getKey(1), startStop);\n  i2s.addAction(i2s.getKey(4), next);\n  i2s.addAction(i2s.getKey(3), previous);\n\n  \/\/ setup player\n  player.setVolume(0.7);\n  \/\/ load the directory \n  if (!player.begin()){\n    Serial.println(\"player failed\");\n    stop();\n  }\n}\n\nvoid loop() {\n  player.copy();\n  i2s.processActions();\n}\n\n<\/code><\/pre>\n
We just need to connect to Wifi, define a FTPClient<\/a> and a AudioSourceFTP<\/a> that we can use to set up the AudioPlayer<\/a>.<\/p>\n
Dependencies<\/h3>\n
For this example you need to install the following libraries:<\/p>\n