New version. Improved API endpoints to validate hostname, added german translation for tell address and made it accessible to the API

README.md

@@ -3,7 +3,7 @@
 [![License: Unlicense](https://img.shields.io/badge/License-Unlicense-blue.svg?style=for-the-badge)](https://unlicense.org/)
 [![Open Source](https://img.shields.io/badge/Open_Source-gray?style=for-the-badge&logo=opensourceinitiative&logoColor=3DA639)](https://opensource.org/)
 [![ESP32](https://img.shields.io/badge/ESP32-FCC624?style=for-the-badge&logo=esphome&logoColor=black)](https://www.espressif.com/en/products/socs/esp32)
-[![State: Unstable](https://img.shields.io/badge/State-Unstable-red.svg?style=for-the-badge)]()
+[![State: Development](https://img.shields.io/badge/State-Development-orange.svg?style=for-the-badge)]()
 
 
 NetSpeaker is a project that aims to make it easier to build your own sound system, just like sqeezebox, for example.
@@ -22,7 +22,7 @@ One thing I have learnt while developing NetSpeaker is that implementing a web s
 which servers hundreds of lines of html is... well sort of dumb (there previously was an API demo running
 directly on the NetSpeaker machine which took loads of resources when requested).
 You can see all this in [that commit](https://git.privacynerd.de/NetSpeaker/NetSpeaker/commit/35138308ef90ea1fccbf1b292eeb69a7d4e8a084).
-This local API demo has been replaced by another [repository](https://git.privacynerd.de/BlueFox/NetSpeaker-API-Demo) containing 
+This local API demo has been replaced by another [repository](https://git.privacynerd.de/NetSpeaker/NetSpeaker-API-Demo) containing 
 the Demo as HTML files (you can just open these in your web browser and type in you NetSpeaker's IP address and start playing).
 
 
@@ -37,6 +37,7 @@ Features, already implemented, or still in progress for the v1.0.0 release!
 
 - [x] SD card support for playing audio files
 - [x] Two operating modes, standalone mode fully implemented
+- [x] two further operation modes to choose whether to run as standalone or interconnected at startup by pressing buttons
 - [x] API in mode 0
 - [x] API methods:
     - [X] /api/v1/playback/toggle
@@ -72,11 +73,16 @@ Features, already implemented, or still in progress for the v1.0.0 release!
     - [X] /api/v1/system/restart/
     - [X] /api/v1/system/name
     - [X] /api/v1/system/name/change
+    - [X] /api/v1/system/network_name
+    - [X] /api/v1/system/network_name/change
     - [X] /api/v1/system/restore_state/{on,off,get}
     - [X] /api/v1/system/restore_playing/{on,off,get}
+    - [X] /api/v1/system/tell_address/{on,off,get}
+    - [X] /api/v1/system/tell_address/lang/{en,de,get}
     - [X] /api/v1/system/version
     - [X] /api/v1/system/wifi/change
     - [X] /api/v1/system/wifi/get_ssid
+    - [X] /api/v1/system/wifi/get_ap_creds
     - [ ] /api/v1/files/get
     - [ ] /api/v1/files/upload
 - [X] Automatic WiFi connection
@@ -84,6 +90,8 @@ Features, already implemented, or still in progress for the v1.0.0 release!
 - [X] Improve the volume endpoint handler (currently pretty undynamic - not anymore :)
 - [ ] Add better encoding as umlauts are not displayed correctly **sometimes**
 
+Please note that all API endpoints may not end with a `/`.
+
 
 ## Credits & Acknowledgements
 
@@ -103,7 +111,7 @@ External librarys used:
 
 - [Seperate audio task example which may solve the issue that when running the API server no IO is accesible (no buttons, status led, ...)](https://github.com/schreibfaul1/ESP32-audioI2S/tree/master/examples/separate_audiotask)
 - [Wiki of the projects Audio library](https://github.com/schreibfaul1/ESP32-audioI2S/wiki)
-- [API demo showing how to use the NetSpeaker's API](https://git.privacynerd.de/BlueFox/NetSpeaker-API-Demo)
+- [API demo showing how to use the NetSpeaker's API](https://git.privacynerd.de/NetSpeaker/NetSpeaker-API-Demo)
 
 
 ## Contributing
@@ -129,4 +137,4 @@ successors. We intend this dedication to be an overt act of relinquishment in pe
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-For more information, please refer to <http://unlicense.org/>
+For more information, please refer to <http://unlicense.org/>

initial_config.ino

@@ -0,0 +1,18 @@
+#import <Preferences.h>
+
+const char PREFERENCES_KEY_WIFI_SSID[] = "wifi_ssid";              // preferences key name for wifi ssid; DO NOT CHANGE
+const char PREFERENCES_KEY_WIFI_PSK[] = "wifi_psk";                // preferences key name for wifi psk;  DO NOT CHANGE
+const char WIFI_SSID[] = "";                                       // type in the wifi's ssid here
+const char WIFI_PSK[] = "";                                        // and the wifi's passkey
+Preferences config;
+
+void setup() {
+  config.begin("netspeaker", false);
+  config.clear();
+  config.putString(PREFERENCES_KEY_WIFI_SSID, WIFI_SSID);
+  config.putString(PREFERENCES_KEY_WIFI_PSK, WIFI_PSK);
+}
+
+void loop() {
+  // empty loop
+}

src/NetSpeaker/NetSpeaker.ino

@@ -1,12 +1,18 @@
 /*
 This is free and unencumbered software released into the public domain.
 
-Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in 
+source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
 
-In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and
-successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and 
+all copyright interest in the software to the public domain. We make this dedication for the benefit of 
+the public at large and to the detriment of our heirs and successors. We intend this dedication to be an 
+overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <http://unlicense.org/>
 */
@@ -19,50 +25,58 @@ For more information, please refer to <http://unlicense.org/>
 #include <WebServer.h>      // https://github.com/espressif/arduino-esp32/tree/master/libraries/WebServer
 #include <uri/UriBraces.h>  // https://github.com/espressif/arduino-esp32/tree/master/libraries/WebServer
 #include <Preferences.h>    // https://github.com/espressif/arduino-esp32/tree/master/libraries/Preferences/
+#include <ESPmDNS.h>        // https://github.com/espressif/arduino-esp32/blob/master/libraries/ESPmDNS/
 
 
 // define all constants
-const String version_tag = "v0.4.0-dev";                           // version tag (with -dev appendix for dev versions)
-const String version = "NetSpeaker " + version_tag;                // version string used e.g. for access point ssid when wifi couldn't connect
-const int operation_mode = 0;                                      // 0: interconnected (no buttons, but api and wifi); 1: standalone (no wifi; no api)
-const int SD_CS = 5;                                               // BOARD SPECIFIC
-const int SPI_MISO = 19;                                           // BOARD SPECIFIC
-const int SPI_MOSI = 23;                                           // BOARD SPECIFIC
-const int SPI_SCK = 18;                                            // BOARD SPECIFIC
-const int I2S_DOUT = 2;                                            // can be changed on need
-const int I2S_BLCK = 4;                                            // can be changed on need
-const int I2S_LRC = 15;                                            // can be changed on need
-const int sdCardEjectPin = 13;                                     // pin which is used to tell the program to eject the sd card (so that the file system doesn't brake)
-const int audioVolumePin = 25;                                     // pin where the poti is connected to (wired as voltage divider)
-const int pausePlaybackPin = 12;                                   // switch (the switching is done digitally, a button has to be connected, NO switch) between play and pause)
-const int forwardButtonPin = 14;                                   // pin for forward button
-const int backwardButtonPin = 27;                                  // pin for backward btn
-const int waitOnSDCardEject = 5000;                                // defines how long to wait (in ms) after the button for SD card eject was pressed (on pin 'sdCardEjectPin'!)
-const int retrySDMountTreshold = 1000;                             // defines how long to wait (in ms) to the next try of mounting the sd card
-const int readyPin = 32;                                           // for an LED that shows if everything started up correctly (SD card mounted, wifi connected, ...)
-const int webport_api = 80;                                        // port for the api (can't be the same as 'webport_config', will throw an error)
-const int maxVolume = 100;                                         // defines the volume steps (max. 255)
-const int EEPROM_WRITE_INTERVAL = 10000;                           // how long to wait until the next EEPROM saving process, in ms
-const int WEB_RESTART_DELAY = 5000;                                // how long (in ms) to wait when a restart is requested by the api
-const String playlistExtension = ".m3u";                           // extension for playlist files
-const String directoryPlaylistName = ".directory";                 // name for directory playlists (not a path, just a filename without ext.!)
-const String apSSID = version;                                     // ssid of access point opened when not able to connect to wifi
-const String apPSK = "aA16161Aa";                                  // pre-shared-key of access point opened when not able to connect to wifi
-const char PREFERENCES_NAMESPACE[] = "netspeaker";                 // namespace for preferences library (stores config data in the ESP32's built-in EEPROM)
-const char PREFERENCES_KEY_WIFI_SSID[] = "wifi_ssid";              // preferences key name for wifi ssid
-const char PREFERENCES_KEY_WIFI_PSK[] = "wifi_psk";                // preferences key name for wifi psk
-const char PREFERENCES_KEY_FRIENDLY_NAME[] = "friendly_name";      // preferences key name for the NetSpeaker's friendly name
-const char PREFERENCES_KEY_RESTORE_OLD_STATE[] = "restore_state";  // preferences key name for getting if the old state should be restored or not
-const char PREFERENCES_KEY_RESTORE_PLAYING[] = "restore_playing";  // preferences key name for getting if the old state should be restored or not
-const char PREFERENCES_KEY_VOLUME[] = "volume";                    // preferences key name for old volume (for state restore)
-const char PREFERENCES_KEY_BALANCE[] = "balance";                  // preferences key name for old balance (for state restore)
-const char PREFERENCES_KEY_EQ_LOW[] = "eq_low";                    // preferences key name for old low equalizer value (for state restore)
-const char PREFERENCES_KEY_EQ_MID[] = "eq_mid";                    // preferences key name for old mid equalizer value (for state restore)
-const char PREFERENCES_KEY_EQ_HIGH[] = "eq_high";                  // preferences key name for old high equalizer value (for state restore)
-const char PREFERENCES_KEY_PLAYING[] = "playing";                  // preferences key name for info if currently playing (for state restore)
-const char PREFERENCES_KEY_MUTED[] = "muted";                      // preferences key name for info if currently muted
-const char PREFERENCES_KEY_PLAYLIST_PATH[] = "playlist";           // preferences key name for playlist path (for state restore)
-const char PREFERENCES_KEY_PLAYLIST_INDEX[] = "pl-index";          // preferences key name for current playlist index (for state restore)
+const String version_tag = "v0.4.2-dev";                                // version tag (with -dev appendix for dev versions)
+const String version = "NetSpeaker " + version_tag;                     // version string used e.g. for access point ssid when wifi couldn't connect
+const int operation_mode = 2;                                           // 0: interconnected (no buttons, but api and wifi); 1: standalone (no wifi; no api);
+                                                                        // 2: choose by pressing any button at startup (not pressed: interconnected; pressed: standalone)
+                                                                        // 3: same as 2 but if not pressed: standalone; pressed: interconnected
+const int SD_CS = 5;                                                    // BOARD SPECIFIC
+const int SPI_MISO = 19;                                                // BOARD SPECIFIC
+const int SPI_MOSI = 23;                                                // BOARD SPECIFIC
+const int SPI_SCK = 18;                                                 // BOARD SPECIFIC
+const int I2S_DOUT = 2;                                                 // can be changed on need
+const int I2S_BLCK = 4;                                                 // can be changed on need
+const int I2S_LRC = 15;                                                 // can be changed on need
+const int sdCardEjectPin = 13;                                          // pin which is used to tell the program to eject the sd card (so that the file system doesn't brake)
+const int audioVolumePin = 25;                                          // pin where the poti is connected to (wired as voltage divider)
+const int pausePlaybackPin = 12;                                        // switch (the switching is done digitally, a button has to be connected, NO switch) between play and pause)
+const int forwardButtonPin = 14;                                        // pin for forward button
+const int backwardButtonPin = 27;                                       // pin for backward btn
+const int waitOnSDCardEject = 5000;                                     // defines how long to wait (in ms) after the button for SD card eject was pressed (on pin 'sdCardEjectPin'!)
+const int retrySDMountTreshold = 1000;                                  // defines how long to wait (in ms) to the next try of mounting the sd card
+const int readyPin = 32;                                                // for an LED that shows if everything started up correctly (SD card mounted, wifi connected, ...)
+const int webport_api = 80;                                             // port for the api (can't be the same as 'webport_config', will throw an error)
+const int maxVolume = 100;                                              // defines the volume steps (max. 255)
+const int EEPROM_WRITE_INTERVAL = 10000;                                // how long to wait until the next EEPROM saving process, in ms
+const int WEB_RESTART_DELAY = 5000;                                     // how long (in ms) to wait when a restart is requested by the api
+const int startupChooserWaitTime = 5000;                                // how long to wait for user to choose the mode (in operation_modes 2 and 3)
+const int startupChooserBlinkDelay = 500;                               // how long to wait for user to choose the mode (in operation_modes 2 and 3)
+const String playlistExtension = ".m3u";                                // extension for playlist files
+const String directoryPlaylistName = ".directory";                      // name for directory playlists (not a path, just a filename without ext.!)
+const String apSSID = version;                                          // ssid of access point opened when not able to connect to wifi
+const String apPSK = "aA16161Aa";                                       // pre-shared-key of access point opened when not able to connect to wifi
+const char PREFERENCES_NAMESPACE[] = "netspeaker";                      // namespace for preferences library (stores config data in the ESP32's built-in EEPROM)
+const char PREFERENCES_KEY_WIFI_SSID[] = "wifi_ssid";                   // preferences key name for wifi ssid
+const char PREFERENCES_KEY_WIFI_PSK[] = "wifi_psk";                     // preferences key name for wifi psk
+const char PREFERENCES_KEY_FRIENDLY_NAME[] = "friendly_name";           // preferences key name for the NetSpeaker's friendly name
+const char PREFERENCES_KEY_NETWORK_NAME[] = "network_name";             // preferences key name for the NetSpeaker's network name (<Network name>.local)
+const char PREFERENCES_KEY_RESTORE_OLD_STATE[] = "restore_state";       // preferences key name for getting if the old state should be restored or not
+const char PREFERENCES_KEY_RESTORE_PLAYING[] = "restore_playing";       // preferences key name for getting if the old state should be restored or not
+const char PREFERENCES_KEY_VOLUME[] = "volume";                         // preferences key name for old volume (for state restore)
+const char PREFERENCES_KEY_BALANCE[] = "balance";                       // preferences key name for old balance (for state restore)
+const char PREFERENCES_KEY_EQ_LOW[] = "eq_low";                         // preferences key name for old low equalizer value (for state restore)
+const char PREFERENCES_KEY_EQ_MID[] = "eq_mid";                         // preferences key name for old mid equalizer value (for state restore)
+const char PREFERENCES_KEY_EQ_HIGH[] = "eq_high";                       // preferences key name for old high equalizer value (for state restore)
+const char PREFERENCES_KEY_PLAYING[] = "playing";                       // preferences key name for info if currently playing (for state restore)
+const char PREFERENCES_KEY_MUTED[] = "muted";                           // preferences key name for info if currently muted
+const char PREFERENCES_KEY_PLAYLIST_PATH[] = "playlist";                // preferences key name for playlist path (for state restore)
+const char PREFERENCES_KEY_PLAYLIST_INDEX[] = "pl-index";               // preferences key name for current playlist index (for state restore)
+const char PREFERENCES_KEY_TELL_ADDRESS_AT_STARTUP[] = "tell_address";  // preferences key name for turning the telling of the NetSpeaker at startup on or off
+const char PREFERENCES_KEY_TELL_ADDRESS_LANG[] = "tellAddressLang";     // preferences key name to determine what the language of the address telling at startup should be (valid: en, de)
 
 // all other variables needed
 Audio audio;                                                                                       // Audio object (for playing audio, decoding mp3, ...)
@@ -72,20 +86,24 @@ String defaultPlaylist = defaultPlaylistFolder + "/" + directoryPlaylistName + p
 int currentWiFiMode = 0;                                                                           // DON'T CHANGE IF NOT KNOWING WHAT YOU'RE DOING; selector for wether an AP (1) should be set up or a wifi (0) should be connected
 bool apON = false;                                                                                 // DON'T CHANGE IF NOT KNOWING WHAT YOU'RE DOING; is the access point opened?
 Preferences configuration;
-long lastTimeEEPROMwritten = 0;  // used to limit the number of eeprom write cycles
+long lastTimeEEPROMwritten = 0;              // used to limit the number of eeprom write cycles
+int operationModeChosen = operation_mode;    // if in operation modes 2 or 3, you can choose between "interconnected" (= 0) and "standalone" (=1). This variable is used to store the decision (made at startup!)
+bool eof_speech_reached = false;             // used to recognize the end of an tts speech (e.g. used for telling the address of the netspeaker)
+bool wait_after_eof_speech = false;          // used for the audio_eof_speech handler to determine what to do after reaching eof_speach
+String default_network_name = "netspeaker";  // default network name (the part of the mDNS domain before .local (<networkName>.local will be registered))
 
 // create all variables for playback (will be set in 'void setup()' by 'restoreLastState();' call)
-int currentVolume = 100;                   // variable where current volume (0...maxVolume) is stored
-int balanceLevel = 0;                      // left-right balance between -16 to 16 inclusive (both)
-int eqLow = 0;                             // equalizer low value between -40 and 6dB
-int eqMid = 0;                             // equalizer mid value between -40 and 6dB
-int eqHigh = 0;                            // equalizer high value between -40 and 6dB
-bool muted = false;                        // currently muted (does not affect currentVolume)
-bool audioPlaying = false;                 // play song or not?; don't play by standard
-String currentSongPath;                    // path to currently playing song
-String currentPlaylist = defaultPlaylist;  // path to current playlist
-int currentPlaylistPosition = -1;          // the current position in the current playlist
-bool restore_old_state;                    // restore the old state of EEPROM?
+int currentVolume = 100;                     // variable where current volume (0...maxVolume) is stored
+int balanceLevel = 0;                        // left-right balance between -16 to 16 inclusive (both)
+int eqLow = 0;                               // equalizer low value between -40 and 6dB
+int eqMid = 0;                               // equalizer mid value between -40 and 6dB
+int eqHigh = 0;                              // equalizer high value between -40 and 6dB
+bool muted = false;                          // currently muted (does not affect currentVolume)
+bool audioPlaying = false;                   // play song or not?; don't play by standard
+String currentSongPath;                      // path to currently playing song
+String currentPlaylist = defaultPlaylist;    // path to current playlist
+int currentPlaylistPosition = -1;            // the current position in the current playlist
+
 
 // struct for playback info (especially when playing mp3 files with id3 tags)
 struct playbackInfo {
@@ -102,13 +120,54 @@ struct playbackInfo {
 };
 struct playbackInfo pbInfo = { "", "", "", "", "", "", "", "", "", "" };
 
+
+// general helper when an system-halting error occurs (to show this, the LED blinks fast)
+bool indicate_system_error() {
+  pinMode(readyPin, OUTPUT);
+
+  while(true) {
+    digitalWrite(readyPin, LOW);
+    delay(150);
+    digitalWrite(readyPin, HIGH);
+    delay(150);
+  }
+}
+
+// helper for operation mode 2 and 3
+bool wait_for_btn_press_and_blink(int blink_pin, int blink_delay, int wait_time) {  // returns true for button pressed and false for button not pressed
+  pinMode(sdCardEjectPin, INPUT);
+  pinMode(backwardButtonPin, INPUT);
+  pinMode(pausePlaybackPin, INPUT);
+  pinMode(forwardButtonPin, INPUT);
+  pinMode(readyPin, OUTPUT);
+
+  int wait_timer_start = millis();
+  int blink_timer_start;
+
+  while ((millis() - wait_timer_start) < wait_time) {  // wait_time in milliseconds!
+    // turn led on and wait for blink_delay while checking for button presses
+    digitalWrite(blink_pin, HIGH);  // turn the LED on (HIGH is the voltage level)
+    blink_timer_start = millis();
+    while((millis() - blink_timer_start) < blink_delay) {  // wait a given time period (delay in milliseconds!)
+      if(analogRead(sdCardEjectPin) > 4000 || analogRead(pausePlaybackPin) > 4000 || analogRead(forwardButtonPin) > 4000 || analogRead(backwardButtonPin) > 4000) return true;
+    }
+
+    // turn led off and wait for blink_delay while checking for button presses
+    digitalWrite(blink_pin, LOW);
+    blink_timer_start = millis();
+    while((millis() - blink_timer_start) < blink_delay) {
+      if(analogRead(sdCardEjectPin) > 4000 || analogRead(pausePlaybackPin) > 4000 || analogRead(forwardButtonPin) > 4000 || analogRead(backwardButtonPin) > 4000) return true;
+    }
+  }
+  return false;
+}
+
 void setup() {
   Serial.begin(115200);                               // setup Serial console (over USB) with baud 115200
   configuration.begin(PREFERENCES_NAMESPACE, false);  // Initialize preferences library in RW mode
 
   // restore process if configured so
-  restore_old_state = configuration.getBool(PREFERENCES_KEY_RESTORE_OLD_STATE, true);
-  if (restore_old_state) restoreLastState();  // standard of restore = true
+  if (configuration.getBool(PREFERENCES_KEY_RESTORE_OLD_STATE, true)) restoreLastState();  // standard of restore = true
 
   // connect to sd card reader
   Serial.println(F("[SETUP]              Setting up SD-Card reader"));
@@ -117,36 +176,83 @@ void setup() {
     delay(retrySDMountTreshold);
   }
 
-  if (operation_mode == 0) {  // things only need to be done if in interconnected mode
-    setupWiFi();
-    setupWeb();
-  } else if (operation_mode == 1) {  // things only need to be done if in standalone mode
+  setupAudio();  // setup audio library
+
+
+  // DEPENDING ON THE OPERATION MODE, DIFFERENT OPERATIONS NEED TO BE DONE
+  // BEFORE STARTING. This is what the following code does.
+
+  // operation_mode 0: see below
+  if (operation_mode == 1) {  // things only need to be done if in standalone mode
     // setup all pins (not SPI and other buses!)
     pinMode(sdCardEjectPin, INPUT);
     pinMode(backwardButtonPin, INPUT);
     pinMode(pausePlaybackPin, INPUT);
     pinMode(forwardButtonPin, INPUT);
     pinMode(readyPin, OUTPUT);
-  } else {
-    Serial.println(F("[FATAL] PLEASE CHOOSE A OPERATION MODE! VALID OPTIONS: 0; 1. SLEEPING FOREVER."));
-    while (true) delay(100);
+  } else if (operation_mode == 2) {  // if enabled choosing  (mode 2: no press = interconnected, press = standalone)
+    bool runStandalone = wait_for_btn_press_and_blink(readyPin, startupChooserBlinkDelay, startupChooserWaitTime);
+    
+    if (runStandalone) {
+      Serial.println(F("[SETUP]              User pressed button; Running in 'Standalone' mode now!"));
+      operationModeChosen = 1;
+      digitalWrite(readyPin, HIGH);
+    } else {
+      Serial.println(F("[SETUP]              User didn't press any button; Running in 'Interconnected' mode now!"));
+      operationModeChosen = 0;
+      digitalWrite(readyPin, HIGH);
+    }
+
+  } else if (operation_mode == 3) {  // if enabled choosing  (mode 3: no press = standalone, press = interconnected)
+    bool runInterconnected = wait_for_btn_press_and_blink(readyPin, startupChooserBlinkDelay, startupChooserWaitTime);
+    
+    if (runInterconnected) {
+      Serial.println(F("[SETUP]              User pressed button; Running in 'Interconnected' mode now!"));
+      operationModeChosen = 0;
+      digitalWrite(readyPin, HIGH);
+    } else {
+      Serial.println(F("[SETUP]              User didn't press any button; Running in 'Standalone' mode now!"));
+      operationModeChosen = 1;
+      digitalWrite(readyPin, HIGH);
+    }
   }
 
-  setupAudio();                                        // setup audio library
+  // this function is placed here because it could be that the operation mode is chosen to be interconnected - then this check needs to run afterwards!
+  if (operation_mode == 0 || operationModeChosen == 0) {  // things only need to be done if in - or choosen to - interconnected mode
+    setupWiFi(); 
+
+    // set up the mDNS responder
+    setupMDNS();
+
+    // set up the API web server
+    setupWeb();
+
+    // now tell the address (can be turned off using the web API, state stored in the EEPROM)
+    tellAddressInfo();  // helper which uses google TTS to tell the address
+  } 
+  if (operation_mode != 0 && operation_mode != 1 && operation_mode != 2 && operation_mode != 3) {
+    Serial.println(F("[FATAL] PLEASE CHOOSE A OPERATION MODE! VALID OPTIONS: 0; 1; 2; 3. SLEEPING FOREVER."));
+    indicate_system_error();  // halt system and blink readyPin
+  }
+
+  // AND start the current track (if restored from EEPROM, only nextAudio is doing something important)
+  // TODO: move createPlaylistFromDirectory to some place where it fits better and is not called uselessly
   createPlaylistFromDirectory(defaultPlaylistFolder);  // create playlist from default dir
   nextAudio();                                         // play first element of the playlist
   digitalWrite(readyPin, HIGH);                        // show that startup is done and everything works fine
 }
 
 
+
 void loop() {
-  if (operation_mode == 0) {               // things only need to be done if in interconnected mode
+  if (operation_mode == 0 || operationModeChosen == 0) {  // things only need to be done if in interconnected mode
     setupWiFi();                           // if connection was lost
     if (audioPlaying) audio.loop();        // play audio if not paused
     if (esp_timer_get_time() % 60 == 0) {  // REALLY NEEDED; audio playing won't work else!
       api_server.handleClient();           // listen on http ports all 60 ms
     }
-  } else if (operation_mode == 1) {  // things only need to be done if in standalone mode
+  }
+  if (operation_mode == 1 || operationModeChosen == 1) {  // things only need to be done if in standalone mode
     if (audioPlaying) audio.loop();  // play audio if not paused
 
     loopBtnListeners();

src/NetSpeaker/audio.ino

@@ -1,12 +1,18 @@
 /*
 This is free and unencumbered software released into the public domain.
 
-Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in 
+source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
 
-In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and
-successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and 
+all copyright interest in the software to the public domain. We make this dedication for the benefit of 
+the public at large and to the detriment of our heirs and successors. We intend this dedication to be an 
+overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <http://unlicense.org/>
 */
@@ -21,6 +27,47 @@ void setupAudio() {
   Serial.printf("[SETUP]              Set up audio card successfully (Pins: BLCK %d | LRC %d | DOUT %d)\n", I2S_BLCK, I2S_LRC, I2S_DOUT);
 }
 
+void tellAddressInfo() {
+  // TODO: make this Preference accessible via the Web API
+  if(configuration.getBool(PREFERENCES_KEY_TELL_ADDRESS_AT_STARTUP, true) && apON == false) {  // only tell the name if the key is set (do it by default) and connected to wifi (for internet)
+    String tellAddressLang = configuration.getString(PREFERENCES_KEY_TELL_ADDRESS_LANG, "en"); 
+    
+    String tell_address_string;
+    IPAddress ip = WiFi.localIP();
+    if(tellAddressLang == "en") {
+      tell_address_string = "Connected. Head over to ";
+      tell_address_string += configuration.getString(PREFERENCES_KEY_NETWORK_NAME, default_network_name);
+      tell_address_string += " dot local.";
+      tell_address_string += " Or ";  // this is needed for a little gap between the hostname and ip telling
+      tell_address_string += String(ip[0]) + " dot ";
+      tell_address_string += String(ip[1]) + " dot ";
+      tell_address_string += String(ip[2]) + " dot ";
+      tell_address_string += String(ip[3]);
+    } else if (tellAddressLang == "de") {
+      tell_address_string = "Verbunden. Gehe zu ";
+      tell_address_string += configuration.getString(PREFERENCES_KEY_NETWORK_NAME, default_network_name);
+      tell_address_string += " punkt local.";
+      tell_address_string += " Oder ";  // this is needed for a little gap between the hostname and ip telling
+      tell_address_string += String(ip[0]) + " punkt ";
+      tell_address_string += String(ip[1]) + " punkt ";
+      tell_address_string += String(ip[2]) + " punkt ";
+      tell_address_string += String(ip[3]);
+    } else {
+      Serial.println(F("[FATAL] PLEASE CHOOSE A VALID TELL_STRING LANGUAGE (valid options: en; de). SLEEPING FOREVER."));
+      indicate_system_error();  // halt system and blink readyPin
+    }
+    Serial.printf("[SETUP]              Telling address now. String: %s\n", tell_address_string);
+    audio.connecttospeech(tell_address_string.c_str(), tellAddressLang.c_str());
+    wait_after_eof_speech = true;  // to prevent the eof_speech handler of the Audio.h library (defined below) to play next audio (as there's none at startup!)
+    while(!eof_speech_reached) { audio.loop(); }  // wait till end of speech
+    wait_after_eof_speech = false;  // turn calling nextAudio on again (the default behaviour)
+    eof_speech_reached = false;  // reset the variable
+    Serial.println("[SETUP]              Told the address.");
+  } else {
+    Serial.println("[SETUP]              Did not tell my address because either not connected to WiFi or it's not configured so.");
+  }
+}
+
 String nextAudio() {
   String url;
 
@@ -28,7 +75,7 @@ String nextAudio() {
   url = getURLFromPlaylist(currentPlaylist, currentPlaylistPosition);
 
   if (url == "") {                 // if the end of the playlist is reached go to start (typically)
-    if(getURLFromPlaylist(currentPlaylist, 0)) {  // untypically: prevent infinite loop if playlist doesn't exist
+    if(getURLFromPlaylist(currentPlaylist, 0) == "") {  // untypically: prevent infinite loop if playlist doesn't exist
       Serial.println(F("[ERROR]              It seems like the current playlist does not exist! Defaulting to the default playlist!"));
       currentPlaylist = defaultPlaylist;
       currentPlaylistPosition = 0;
@@ -172,7 +219,12 @@ void audio_eof_mp3(const char *info) {  // MUST HAVE THIS NAME (audio_eof_mp3) b
 }
 void audio_eof_speech(const char *info) {
   Serial.printf("[Audio.h] EOF_Speech %s\n", info);
-  nextAudio();
+  
+  if (wait_after_eof_speech) {
+    eof_speech_reached = true;
+  } else {
+    nextAudio();
+  }
 }
 void audio_info(const char *info) {
   Serial.printf("[Audio.h] Info       %s\n", info);

src/NetSpeaker/fs.ino

@@ -1,12 +1,18 @@
 /*
 This is free and unencumbered software released into the public domain.
 
-Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in 
+source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
 
-In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and
-successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and 
+all copyright interest in the software to the public domain. We make this dedication for the benefit of 
+the public at large and to the detriment of our heirs and successors. We intend this dedication to be an 
+overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <http://unlicense.org/>
 */
@@ -22,7 +28,7 @@ int setupSD(int SD_CS, int SPI_MISO, int SPI_MOSI, int SPI_SCK) {
 
 // write preferences via the Preferences.h library
 void writeLastState() {
-  if (restore_old_state) {  // only save if restoration is wanted (to avoid unnecessary write cycles on eeprom)
+  if (configuration.getBool(PREFERENCES_KEY_RESTORE_OLD_STATE, true)) {  // only save if restoration is wanted (to avoid unnecessary write cycles on eeprom)
     // always check if the value is different on the EEPROM so that it has to be updated
     Serial.printf("[RESTORE]            Saving last state to EEPROM.\n");
     if (configuration.getInt(PREFERENCES_KEY_VOLUME, maxVolume) != currentVolume) configuration.putInt(PREFERENCES_KEY_VOLUME, currentVolume);
@@ -60,6 +66,7 @@ void restoreLastState() {
   }
   currentPlaylistPosition = configuration.getInt(PREFERENCES_KEY_PLAYLIST_INDEX, 0) - 1;  // -1 as default playlist position (is incremented with the first nextAudio() call)
   Serial.printf("[RESTORE]            PREFERENCES_KEY_PLAYLIST_INDEX = %i\n", currentPlaylistPosition);
+  
   Serial.println(F("[RESTORE]            Restored."));
 }
 

src/NetSpeaker/webserver.ino

@@ -1,12 +1,18 @@
 /*
 This is free and unencumbered software released into the public domain.
 
-Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in 
+source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
 
-In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and
-successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and 
+all copyright interest in the software to the public domain. We make this dedication for the benefit of 
+the public at large and to the detriment of our heirs and successors. We intend this dedication to be an 
+overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <http://unlicense.org/>
 */
@@ -24,6 +30,7 @@ String send_api_json(bool success, String content, bool plain) {
   }
   json += "}";
 
+  api_server.sendHeader("Access-Control-Allow-Origin", "*");
   api_server.send(200, "application/json", json);
   return json;
 }
@@ -39,6 +46,21 @@ bool isStringConvertable2Int(String toIntStr) {
   }
   return true;
 }
+bool isValidNetworkName(String to_validate) {
+  // if too long
+  if (to_validate.length() > 63) return false;  // see here under labels: https://datatracker.ietf.org/doc/html/rfc1035#section-2.3.4
+
+  // check if it only contains a-z, A-Z, 0-9 and -
+  char currentChar;
+  for (int i = 0; i < to_validate.length(); i++) {
+    currentChar = (char)to_validate[i];
+    if (!isAlphaNumeric(currentChar) && currentChar != '-') {
+      return false;  // if not, return false
+    } 
+  }
+  // then return true
+  return true;
+}
 
 /* ----------------------
 ----  API FUNCTIONS  ----
@@ -158,6 +180,7 @@ void api_v1_volume() {
   content += String(currentVolume);
   content += ", \"muted\": ";
   content += muted ? "true" : "false";
+  content += ", \"volume_max\": " + String(maxVolume);
   send_api_json(success, content);  // generate json and send it
 }
 
@@ -312,6 +335,7 @@ void api_v1_playback_info() {
   content += "\"resource_year\": \"" + pbInfo.year + "\", ";                     // year
   content += "\"resource_genre\": \"" + pbInfo.genre + "\", ";                   // genre
   content += "\"resource_copyright\": \"" + pbInfo.copyright + "\", ";           // copyright
+  content += "\"resource_tts_language\": \"" + pbInfo.tts_language + "\", ";     // language
   content += "\"resource_playlist_path\": \"" + currentPlaylist + "\", ";        // playlist path
   content += "\"resource_playlist_index\": " + String(currentPlaylistPosition);  // playlist index (starting from 0)
 
@@ -396,6 +420,7 @@ void api_v1_system_restart() {
   SD.end();           // delete SD object and sync its cache to flash
   WiFi.disconnect();  // disconnect wifi
   Serial.printf("[INFO]               Restarting after 5000ms.\n", waitOnSDCardEject, retrySDMountTreshold);
+  api_server.sendHeader("Access-Control-Allow-Origin", "*");
   api_server.send(200, "application/json", "{\"restart\": true, \"wait_time\": 5000}");
   delay(WEB_RESTART_DELAY);
   ESP.restart();  // reset everything and restart the program
@@ -428,11 +453,53 @@ void api_v1_system_friendlyname_change() {
   }
 
   configuration.putString(PREFERENCES_KEY_FRIENDLY_NAME, newFriendlyName);
-  Serial.printf("[INFO]               Changed friendly name from \"%s\" to \"%s\".\n", currentFriendlyName.c_str(), newFriendlyName.c_str());
+  Serial.printf("[INFO]               Changed friendly name from \"%s\" to \"%s\".\n", currentFriendlyName, newFriendlyName);
 
   send_api_json(true, "\"friendly_name\": \"" + newFriendlyName + "\"");
 }
 
+void api_v1_system_networkname_get() {
+  Serial.println("[HTTP] [API]         200 - '/api/v1/system/network_name'");
+
+  send_api_json(true, "\"network_name\": \"" + configuration.getString(PREFERENCES_KEY_NETWORK_NAME, default_network_name) + "\"");
+}
+
+void api_v1_system_networkname_change() {
+  Serial.println("[HTTP] [API]         200 - '/api/v1/system/network_name/change'");
+
+  String currentNetworkName = configuration.getString(PREFERENCES_KEY_NETWORK_NAME, default_network_name);
+  String newNetworkName;
+  bool arg_given = false;
+  bool apply_changes = false;  // whether changes should be applied directly
+  // get the right post param (by key)
+  for (int i = 0; i < api_server.args(); i++) {
+    if (api_server.argName(i) == "apply_changes") {
+      apply_changes = true;
+    }
+    if (api_server.argName(i) == "network_name") {
+      arg_given = true;
+      newNetworkName = api_server.arg(i);
+    }
+  }
+  // define what to do if nothing really changed (or no argument was given)
+  if (!isValidNetworkName(newNetworkName) || !arg_given) {
+    send_api_json(false, "\"network_name\": \"" + currentNetworkName + "\", \"apply_changes\": false");  // return with no success ("false")
+    return;
+  }
+  // if the network name hasn't changed, just return success (as no further action's required)
+  if (newNetworkName == currentNetworkName) send_api_json(true, "\"network_name\": \"" + newNetworkName + "\", \"apply_changes\": " + (apply_changes ? "true" : "false"));
+
+
+  configuration.putString(PREFERENCES_KEY_NETWORK_NAME, newNetworkName);
+  Serial.printf("[INFO]               Changed network name from \"%s\" to \"%s\".\n", currentNetworkName, newNetworkName);
+
+  if(apply_changes) {
+    setupMDNS();
+  }
+
+  send_api_json(true, "\"network_name\": \"" + newNetworkName + "\", \"apply_changes\": " + (apply_changes ? "true" : "false"));
+}
+
 void api_v1_system_restore_state() {
   String option = api_server.pathArg(0);
   bool success = true;
@@ -477,6 +544,51 @@ void api_v1_system_restore_playing() {
   send_api_json(success, content);  // generate json and send it
 }
 
+
+void api_v1_system_tell_address() {
+  String option = api_server.pathArg(0);
+  bool success = true;
+  Serial.printf("[HTTP] [API]         200 - '/api/v1/system/tell_address/%s'\n", option);
+
+  if (option == "get") {
+    // just here that calling .../get wont respond 404
+  } else if (option == "on") {
+    configuration.putBool(PREFERENCES_KEY_TELL_ADDRESS_AT_STARTUP, true);
+  } else if (option == "off") {
+    configuration.putBool(PREFERENCES_KEY_TELL_ADDRESS_AT_STARTUP, false);
+  } else if (option == "toggle") {  // toggle; default to true (tell by default)
+    configuration.putBool(PREFERENCES_KEY_TELL_ADDRESS_AT_STARTUP, !configuration.getBool(PREFERENCES_KEY_TELL_ADDRESS_AT_STARTUP, false));
+  } else {
+    success = false;
+  }
+
+  String content = "\"tell_address\": ";  // prepare the http response
+  content += configuration.getBool(PREFERENCES_KEY_TELL_ADDRESS_AT_STARTUP, true) ? "true" : "false";
+  send_api_json(success, content);  // generate json and send it
+}
+
+
+void api_v1_system_tell_address_lang() {
+  String option = api_server.pathArg(0);
+  bool success = true;
+  Serial.printf("[HTTP] [API]         200 - '/api/v1/system/tell_address/lang/%s'\n", option);
+
+  if (option == "get") {
+    // just here that calling .../get wont respond 404
+  } else if (option == "en") {
+    configuration.putString(PREFERENCES_KEY_TELL_ADDRESS_LANG, "en");
+  } else if (option == "de") {
+    configuration.putString(PREFERENCES_KEY_TELL_ADDRESS_LANG, "de");
+  } else {
+    success = false;
+  }
+
+  String content = "\"tell_address_lang\": \"";  // prepare the http response
+  content += configuration.getString(PREFERENCES_KEY_TELL_ADDRESS_LANG, "en") + "\"";
+  send_api_json(success, content);  // generate json and send it
+}
+
+
 void api_v1_system_version() {
   Serial.printf("[HTTP] [API]         200 - '/api/v1/system/version'\n");
 
@@ -489,6 +601,13 @@ void api_v1_system_wifi_getssid() {
   send_api_json(true, "\"wifi_ssid\": \"" + configuration.getString(PREFERENCES_KEY_WIFI_SSID) + "\"");
 }
 
+void 
+api_v1_system_wifi_get_ap_creds() {
+  Serial.println("[HTTP] [API]         200 - '/api/v1/system/wifi/get_ap_creds'");
+
+  send_api_json(true, "\"ap_ssid\": \"" + apSSID + "\", \"ap_psk\": \"" + apPSK + "\"");
+}
+
 void api_v1_system_wifi_change() {
   Serial.println("[HTTP] [API]         200 - '/api/v1/system/wifi/change'");
 
@@ -526,12 +645,14 @@ void api_v1_system_wifi_change() {
 
 void setupWeb() {
   api_server.on("/", []() {
-    Serial.println("[HTTP] [API]         404: Not Found");
-    char message[] = "{\"message\": 404, \"message\": \"Welcome to your NetSpeaker's API! More info can be found at https://git.privacynerd.de/NetSpeaker/NetSpeaker\"}";
-    api_server.send(404, "application/json", message);
+    Serial.println("[HTTP] [API]         200 - '/'");
+    char message[] = "{\"message\": \"Welcome to your NetSpeaker's API! More info can be found at https://git.privacynerd.de/NetSpeaker/NetSpeaker\"}";
+    api_server.sendHeader("Access-Control-Allow-Origin", "*");
+    api_server.send(200, "application/json", message);
   });  // on /
   api_server.onNotFound([]() {
     Serial.println("[HTTP] [API]         404: Not Found");
+    api_server.sendHeader("Access-Control-Allow-Origin", "*");
     api_server.send(404, "application/json", "{\"code\": 404, \"message\": \"Resource not found.\"}");
   });  // on NotFound (the fallback if nothing else configured for the requested URL)
   api_server.on("/api/v1/playback/toggle", api_v1_playback_toggle);
@@ -554,11 +675,16 @@ void setupWeb() {
   api_server.on("/api/v1/system/restart", api_v1_system_restart);
   api_server.on("/api/v1/system/name", api_v1_system_friendlyname_get);
   api_server.on("/api/v1/system/name/change", api_v1_system_friendlyname_change);
+  api_server.on("/api/v1/system/network_name", api_v1_system_networkname_get);
+  api_server.on("/api/v1/system/network_name/change", api_v1_system_networkname_change);
   api_server.on(UriBraces("/api/v1/system/restore_state/{}"), api_v1_system_restore_state);
   api_server.on(UriBraces("/api/v1/system/restore_playing/{}"), api_v1_system_restore_playing);
+  api_server.on(UriBraces("/api/v1/system/tell_address/{}"), api_v1_system_tell_address);
+  api_server.on(UriBraces("/api/v1/system/tell_address/lang/{}"), api_v1_system_tell_address_lang);
   api_server.on("/api/v1/system/version", api_v1_system_version);
   api_server.on("/api/v1/system/wifi/change", api_v1_system_wifi_change);
   api_server.on("/api/v1/system/wifi/get_ssid", api_v1_system_wifi_getssid);
+  api_server.on("/api/v1/system/wifi/get_ap_creds", api_v1_system_wifi_get_ap_creds);
 
   Serial.println("[HTTP] [API]         Starting API server (http) on port " + String(webport_api));
   api_server.begin();

src/NetSpeaker/wifi.ino

@@ -1,17 +1,22 @@
 /*
 This is free and unencumbered software released into the public domain.
 
-Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in 
+source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
 
-In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and
-successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and 
+all copyright interest in the software to the public domain. We make this dedication for the benefit of 
+the public at large and to the detriment of our heirs and successors. We intend this dedication to be an 
+overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 For more information, please refer to <http://unlicense.org/>
 */
 
-
 void setupWiFi() {
   if(WiFi.status() == WL_CONNECTED) { return; }  // return if not connected
   switch(currentWiFiMode) {
@@ -54,4 +59,18 @@ void setupWiFi() {
       }
       break;
   }
+}
+
+void setupMDNS() {
+  MDNS.end();
+  // start the mDNS responder
+  Serial.println(F("[SETUP]              Starting mDNS responder"));
+  if (!MDNS.begin(configuration.getString(PREFERENCES_KEY_NETWORK_NAME, default_network_name))) {  // get network name from EEPROM (default to default_network_name)
+    Serial.println(F("[SETUP]              Error setting up mDNS responder!"));
+    indicate_system_error();  // halt system and blink readyPin
+  }
+  Serial.println(F("[SETUP]              Started mDNS responder"));  
+
+  // Add service to MDNS-SD
+  MDNS.addService("http", "tcp", 80);
 }