Alexa-API (and AmazonMusic/Deezer/Spotify) Changelog / Todo List

alexaapi icon .  . alexaamazonmusic icon alexaspotify icon alexadeezer icon

Change Log

Version in dev

  • Changed the method of defining logs at startup and some message adjustments (thanks Neurall)

Merging Beta and Stable Versions to 2022-12-23

Beta version 2022-12-11

  • Added smartHome icons: Bridge / FireStick (Thank you Skillix)
  • Fixed a block on the registration of smartHome devices to be deactivated

Beta version 2022-12-08

  • Added creation of Bridge/Echo dual equipment when duplicity exists (Thanks Skillix)
  • Added smartHome icons: Bridge / FireStick (Thank you Skillix)
  • Fixed a block on the registration of smartHome devices to be deactivated

Beta version 2022-10-02

  • Big modification of the cookies/remote library, change to v5.8.2
  • In the requeteur info, addition of PlayerQueue which will allow to find the playlists, in fact, obviously Amazon no longer broadcasts this information by the MQTT (function getPlayerQueue)
  • Added window with refresh screen after default forcing (Alexa-API, AmazonMusic and smartHome)

  • Fixed concern to update … alarms/reminders/timers
  • Adding a mute button to mute
  • Added a ‘unmute’ button to deactivate the mute

  • Fixed potential issues with alarms/reminders/timers feedback
  • Fixed potential issues to send an instant alarm
  • Embellishing the module name in the health page (Thank you noodom)
  • Redesign of Mute management and Bluetooth connectivity (new icons):

  • Integration of Amazon Air Quality Monitor into smartHome

Version 2022-06-04 (stable&beta):

  • The log alexaapi _scan passes in info instead of debug
  • Adding info in the log scan in case of device deletion by the config
  • NodeJs goes to v16 (Thank you Nebz)
  • Modification of the alexaapi.js library to take account of replies: undefined, adding the info in the log
  • Fixed display issue on Desktop, drop-down lists were no longer running

Version 2022-04-16 (stable&beta):

  • Added support for smartHome actions commands for locks (Thanks Skillix)
  • Fixed a problem on the widget player on changing the volume of a group
  • Improvement of notif d’info during scanning (possible thanks to presentation V4.2)
  • Improved Refresh Cookie and Cron deletion in config (scheduled to 30 15 * * */7)
  • Improved search field (Thank you JAG)
  • Added table mode on desktop (Thank you JAG)

Version 2021-11-27 (stable&beta)

  • Merging the two versions
  • Fixed the big MQTT bug engendered by an increase in Amazon’s security
  • Added images of the new Echo

Version 2021-09-12 19:02 (stable&beta)

  • Correction risk of error at execution, thank you Eric!!

Version 2021-09-03 09:03 (stable&beta)

  • Beta and stable merged 03/09/2021
  • resources/lib/formerDataStore.json ignored and deleted from package

Version 2021-09-02 21:47 (beta)

  • Update for debian bubbleye and new nodejs versions (Thank you Nebz)

Version 2021-06-05 09:45 (stable&beta)

  • Beta and stable merged on 05/06/2021
  • Change requeteur info to retrieve "lists"
  • Change requeteur info to test the allDeviceVolumes function
  • Correction ‘Error on the plugin’s cron function: 6 is not a valid position »
  • Fixed link change to API of routines (v2)
  • Fixed API change for history, library change and History modal.
  • Fixed a bug that caused a list of routines and alarms to be lost if a Device was saved.
  • Changing the Speak command via a scenario to ignore #volume#
  • Added interjections and sounds via tags #, doc update
  • Deleting the log condition in Debug to enable requesters on desktop
  • Automatic server restart disabled except for "experienced users" (now useless)
  • Added ‘Sleep protection’ option to disable all commands from xxh to xxh
  • Updating NodeJS 12 to 14 to align with other plugins
  • Added Display/showNameOndashboard setting when creating commands
  • Work on the "Volume" commands of devices and groups
  • Update proxy.js (Alexa-cookie 3.4.3): handle potential crash case
  • Adjust automatic Cookie Refresh interval from 7 to 4 days and 1 day adjustment on tokensValidSince
  • Added support for setThermostatMode, Fan.Speed (numbered speed selection) and Blind.Lift (speed/opening selection) commands %) Thank you Skillix and Didier3L
  • Passage of http-proxy-middleware from 1.3.1 to 2.0.0 in /resources
  • Correction last modification acceptance Cookie from Amazon: Remote 3.8.1 (2021-06-04) (bbindreiter) Set Missing Accept Header

Beta and Stable merged on 17-01-2021

Version 2021-01-17 11:04 (stable&beta)

  • HUGE discovery, it was the generation of the csrf that was a concern when renewing the cookie, Amazon seems to change pages regularly and this has been corrected. So the Daemon should no longer fall and the cookie should renew itself without any user intervention.
  • New feature : Added the possibility to send a sentence to Alexa (function identical to a spoken sentence)
  • Small mods of Alexa-remote 3.3.2 in 3.3.3 (fixed potential crash case)
  • Added TextCommand Alexa-remote2 3.3.3 to 3.4.0
  • jeeObject::buildTree instead of jeeObject:all (thanks Nebz)
  • Big work on the logs of alexaapi _node to track the generation of the cookie and its renewal
  • Minor changes to the generation and renewal of cookies
  • Cookie regeneration test after 23h for test
  • Minor correction of a line in log Error instead of log Info
  • Rounded Rectangles (thanks JAG)
  • Corrections and deletions of "Notices" (thanks EricG)

Beta and Stable merged on 21-11-2020

Version 2020-11-21 21:50 (stable)

  • Addition of the future Alexa-FireTV plugin, icon and scan integration
  • Added command for time display (thanks Alexandre)
  • Added buttons on the Widget and commands to display/hide Echo Dot Clock time
  • Fix install dependencies, small fix for a + command for old raspberry and finally a fix for a prefix problem (thanks Nebz)

Version 2020-09-30 (stable)

  • Code optimization and minor corrections (thanks Thibaut)
  • Addition of a ‘Volume’ command for groups
  • Fixed a bug on the return of the last interaction
  • New plugin correction to adapt to yet another Amazon change in identification
  • Adding badges on players and smartHome
  • Modification of OffLine Bagdes
  • Adding a bagde when the device has just been discovered
  • Migration do in version 5 (Thank you JAG)
  • Edit generation Playlist (Bug appeared)
  • Addition of a new cmd info: Online (attention slow update, about 15 min)
  • Fixed a bug in the volume keys that caused a private fields are not currently supported
  • Adding .htaccess files to the core/class folders of all plugins
  • Changing querySmarthomeDevices to prevent a loss of connection to the Amazon server from knocking down the daemon
  • Changing logs, formats and removing unnecessary traces
  • Fixed a bug on the command volume, it was recreated every time the device was recorded. (following the addition of the volume in the groups)
  • Addition of Fire TV Cube, image and consideration of orders

Version 2020-07-10 13:25

  •  Changing the Timeout on all readers, from 3s to 10s (careful about sending "radio" commands to some)
  • Correction Installation nodejs

Version 2020-06-26 01:24 (beta and stable) Alexa-API:

  • Fixed plugin to adapt to a new Amazon change in identification
  • Added template/scenario to be able to specify an ID when using the deletereminder command
  • Fixed a bug on the deleteallalarms command, the type and status did not change, just delete the command and force the creation of the commands to have the update.
  • Adding a calendar to the screenplay template means that you can choose the date/time with a small assistant when creating a scenario (Thanks Aidom)
  • Added the possibility to add a reminder with a recurrence (Thank you Aidom)
  • Added the possibility to do a "test" with the command "Make Alexa speak in SSML"
  • Added <speak> tag presence check in SSML otherwise report it by saying so.
  • Edit Alexa mqtt library to fix Buffer constructor issue that is deprecated
  • Added color and brightness controls for smartHome (from Alexa-smartHome)
  • Changing the control of the cookie, the server will not be launched if the cookie is not good (also log change)
  • Added a message (message:add) to inform the user that the Amazon cookie needs to be regenerated.
  • Adding a "duplicate" control of Name when importing (comes when you change your Musicplayer for example), it adds "duplicate xxxx" behind so as not to block the scan.
  • Added a message that warns the user if they have two players activated at the same time (this will not work)
  • Change ScanDevices to only add playlists to AmazonMusic Device (for now)
  • Correction of Warnings
  • Added Alexa app logo for Windws 10
  • Changed the recovery of routines (in Alexa-API) and playlists (in Alexa-amazonMusic) to be able to reduce the number of requests from the Amazon server, adding this information in the config, ability to force the recovery of information faster.

Version 20-05-009 (beta and stable) of the players:

  • Fixed a synthaxe error on jeealexaapi

Version 2020-02-27 20:01

  • Added smartHome equipment detection
  • Adding the command Announcement (identical to Speak with welcome music)
  • Added the "Enable Amazon SmartHome Home Features" checkbox in the config
  • Added the checkbox "Enable Multimedia (Player/Playlist) functions" in the config
  • Added turnOn and turnOff commands for smartHome equipment
  • Small bug fix on using Play Music Track command via scenario
  • Fixed small bug if config boxes are not initialized
  • Radio management has changed from a string to a select, so you select from a drop-down list (Be careful, check your scenarios #station# became #select#)
  • MusicTrack management has changed from a string to a select, so you select from a drop-down list (Be careful, check your scenarios #trackId# became #select#)
  • Radio command on a multiroom works with a single command, more loop
  • Play/pause/Next/Previous commands on the multiroom work with a single command, no loop
  • Action commands that are lists now have their field with the data from the drop-down list, therefore editable (Playlist, Radio, IdTrack)
  • Redesign of the radio widget to include a drop-down list
  • Redesign of the Music Track Widget to include a drop-down list
  • Addition of the info command: providerName
  • Addition of the info command: contentId which gives the TrackID of a track being played or a radio
  • Fixed a bug that added "Last interaction" to smartHome
  • Fixed a bug on the command Volume, there must be volume?value=#slider# and not volume?value=#volume#
  • Fixed a bug on the command Volume, there must be command?command=#select# and not command?command=#command#
  • Added notificationsSounds in the requeteur info
  • Adding "Reminders" in the info requester
  • Added the ability to choose a sound to each alarm when programming
  • Displaying the name of the alarm music on the ‘Recall/Alarms’ tab
  • Fixed a bug on the list of devices that can launch routines, limitation to Alexa
  • "Reload default configuration" button moved next to the Save button
  • Redesign of the widgets of the Speak and Annoucement commands (and change of titles)
  • Last Interaction Widget Redesign and Title Change
  • Fixed a bug on the command Reminder, there must be text=#message# and not text=#text#
  • Template for scenario for the Reminder command redone
  • Added a default sound on the Alarm command so that the test by the Tester button does not bug
  • Adding a new info command bluetoothDevice which will give the name of the bluetooth device connected to your Alexa
  • Adding a parameter Volume the Speak and Annoucement Commands
  • Edit Speak and Announcement template scenario to add volume
  • Added log level in the server launch command to transmit this info to nodejs (for node log management)
  • Added a checkbox ‘Enable Amazon MQTT client (recommended for multimedia functions)’ in the config
  • Added command sending error detection (in remote), then 8s pause and re-send the same command
  • Deletion of: whennextalarm, whennextmusicalalarm, musicalalarmmusicentity, whennexttimer, whennextreminder, whennextreminderlabel
  • Addition of updateallalarms which replaces 6 other commands (1 request to Amazon instead of 6)
  • Renewal of information: whennextmusicalalarminfo, whennextreminderinfo, whennextmusicalalarminfo, whennexttimerinfo in CRON format (no longer hhmm)
  • Modifying templates that match the 4 commands above to adapt the result format
  • Adding Routines to the Requester Info
  • Fixed minor problems with refreshing routines

Version 2019-10-27 18:05:00

  • Addition of a cron to relaunch the link with the server (by default at 03:33 in the morning)
  • Changing the volume of a ‘Multiroom’ group no longer loops, in a single command, it changes the volume of all the equipment in the group
  • Added a development queryer (to test direct requests to the Amazon server, for informed users)
  • Integration of the MQTT link with the addition of info commands: VoluleInfo InteractionInfo
  • Added images of Delta Freebox and Echo Input
  • Addition of a link between the volume of the Echo and the ‘volume’ cursor of the widget
  • Added the ability to choose in which room to add the new equipment detected to the scan
  • Queryers are available for experienced users (option in the config) in debug mode
  • Added the "Enable Amazon SmartHome Home Features" checkbox in the config
  • Added the checkbox "Enable Multimedia (Player/Playlist) functions" in the config
  • Increased timeout from 2s to 3s for http queries
  • Added the "Recharge Default Configuration" feature for each Device
  • Added the feature "Delete all devices!! and restart a Scan" in the plugin config
  • Routines are updated during scanning
  • Playlists are updated during scanning
  • Fixed a majscule issue that blocked the DeleteAllAlarm command
  • Add MusicEntity information when you have a music alarm
  • Added Play Music Track command to play an Amazon Music Track thanks to its Id
  • Redesign of the script template for the Radio command
  • Redesign of the script template for the Play Music Track command
  • The logo of a Device Player on the desktop switches to green ‘Play’ when it is read (this will be updated the next time a page is loaded)
  • The playlist displays an animation to find out which track is playing and shifts gradually.

Version 2019-09-22 09:41:38

  • Setting up an authentication test during Refresh and relaunching the server in case of loss of authorisation

Version 2019-09-15 08:22:00

  • {{}} fix displayed in V4
  • Updating the library

Version 2019-09-08 15:01:32

  • Correct to simplify queries to the server whose routines (once at each refresh, not at each device)

Version 2019-09-05 18:44:02

  • Corrective for those with VMs

Version 2019-09-03 13:18:15

  • Fixed bug on opening screen History, Routines, Reminders, Health …
  • Replacement of all .on('click' by .off('click').on('click')
  • Queryer Addition
  • Added WhenNextMusicalAlarm
  • Added a transparent check that checks if the connection is ok during the CRON otherwise restarts the server (to avoid Close Connection)
  • General redesign of the assignment of orders, they are assigned according to the displayed capacity of each piece of equipment
  • Recoding the Multiroom part, everything works!
  • Fixed the bug Alexa-API: Error: no csrf found
  • Support nodejs v12 (forecast for debian Buster)

Version: 2019-04-12 18:32:27

  • Added Routines screen.
  • Routines can be launched in the Routines screen via the play button on the far right
  • Launching routines by scenario or action command
  • Added a Refresh command to start updating the list of routines (useful for the routine template) and to update the values of WhenNextAlarm/Reminder…
  • Added a CRON15 to check the connection with Alexa and to launch the Refresh
  • Possibility to store the lines of Action/info commands of devices (drag & drop)
  • Removal of the Speak+volume and Radio+Volume which does not bring anything since two commands launched one behind the other but raises concerns. Will be replaced by new orders when we know how to recover Alexa’s ‘ongoing’ volume.
  • Added a queue of commands and a good execution control, otherwise at the next server launch, the commands are executed.
  • Fixed an issue with the Push command that indicated that the sdevice was not specified
  • On the History screen, identification of orders sent via Jeedom

Version: 2019-03-19 19:43:34

  • Modification of the script alexa-remote.js to take into account the Other Amazon Servers (.es .de …)
  • Minor modification of the Alexa-API message: * Server listening on port 3456 * in alexaapi.js
  • Fixed a minor bug on the Volume command sending error control
  • Adding the action command: command that allows to launch |play |next |prev |fwd |rwd |shuffle |repeat
  • Adding the command Radio
  • Fixed a bug when creating commands on isVisible
  • Fix minor concern on events containing Radio+Volume
  • Added HHMM format for WhenNextAlarm
  • Integration of setDisplay and setconfiguration/request in the automatic creation loop of the command and not in the update
  • Adding type and status parameters to DeleteAllAlarms command

Version: 2019-03-11 18:36:14

  • Addition in the configuration of options to define the Amazon server and the Alexa server, and thus make the plugin international
  • Increase in the waiting time before opening the Amazon cookie loading window
  • Expansion (in height) of the loading window of the Amazon cookie

Version: 2019-03-11 12:41:20

  • Creation Cookie Alexa, changing the colour of the button informing of the opening of the identification window (Green->Blue) with a circle turning
  • Creation Cookie Alexa, decrease in waiting time opening popup 2000ms->1500ms
  • Creation Cookie Alexa, increased Cookie generation time before daemon launch (3=>4 blinks)
  • Creation of the order WhenNextAlarm who says when the next alarm will take place (explanations)
  • Creation of the order WhenNextReminder who says when the next reminder will take place (explanations)
  • Creating an order DeleteAllAlarms to remove all alarms and reminders from a device

Version: 2019-03-07 19:09:17

  • Adjustment of the width of the columns of the Equipment Controls
  • Locking Orders (Action or Info)
  • Redesign of the Orders grid, possibility of having orders that send results in Info Orders
  • Fixed alarm command?&when=#when#&recurring=#recurring# by alarm?when=#when#&recurring=#recurring#

Stable version: 2019-03-05 20:05:48

At this stage, it makes it possible to:

  • Automatically scan all Echo from Amazon account
  • Making the Amazon Echo Talk
  • Adjust the volume
  • Program alarms and remove them
  • Schedule reminders and delete them

Full of Version Beta xx-02-2019

  • Minor correction on the display of buttons to generate the Amazon cookie
  • Many other things before the release of the first stable version

Version Beta 14-02-2019

  • Added automatic generation of commands Speak and Volume
  • Complete overhaul of the Amazon Cookie Generation
  • Blocking the launch of Daemon until the cookie is present

Version Beta 12-02-2019

  • Addition of left pane (side panel)
  • Added CSS to improve display of equipment
  • Bug: Kill initCookie.js replaces Kill Cookie.js

Version Beta 09-02-2019

  • Automatic Addition of Equipment Amazon Echo
  • Detection of type of each equipment and His Presence

 Todo List

Bugs

  • Concern: When the cookie is generated, if the file is not properly retrieved, there is still the Bravo message.
  • Announcements on the multiroom are planting the demon. Generally test all multiroom functions (volume is OK)
  • Correct the display of the play/pause/next … commands in the scenarios
  • Fix ‘in Player widgets on album name or artist.
  • Program mobile template widgets in v4
  • Repeat does not work on reminders
  • Amazon has modified the operation of the alarms and we can now program in several days the alarms, to modify
  • When you export JSON from the requeteur info, there is a problem on bluetooth for example
  • See why the name doesn’t change when you change the Amazon name and run a scan

Improvements

  • Toilet logs and reclassify to info/debug/…
  • Have devices added by Amazon disabled on detection (xx Alexa Apps, This Device, All Devices)
  • For Scan or Health, add a message that says to generate the cookie when it does not yet exist
  • Add a Refresh button for Health, to have the "Present" updated
  • Check for dependencies before you can launch the Cookie-Alexa API controller
  • To the generation of the cookie, extend the blinking
  • When generating the cookie, change the color of the message "open … window" to blue instead of green and if possible with the circle that rotates
  • Delete the "Order Sent" column in the command table (not useful)
  • Delete the ‘ID’ column in the Reminders/Alarms screen (not useful)
  • Reset the Test buttons for the Reminder and Alarm commands by putting test data in the code
  • Fix alarm command?&when=#when#&recurring=#recurring# by alarm?when=#when#&recurring=#recurring#
  • Find out how _cmd table works and how commands are classified in the table
  • See why you can't move commands in the command board
  • Enlarge a little downwards the identification window of the Amazon cookie, when it asks for the captcha control, we do not have the validation button
  • In the whennextalarm command, allow the hour option to be written in upper or lower case
  • Sort routines alphabetically.
  • Add the next music alarm
  • Remove musicalalarmmusicentity to recover music by whennextmusicalalarm
  • Watch why no Refresh button for a group player
  • The alarm sounds drop-down list should be able to update itself (it is in a template for scenarios and in an action command)
  • If a device is offline, put widget on standby or at least cut the playing icon
  • Add shuffle and repeat for Multirooms
  • Only take into account for the last interactions the sentences that are in success
  • If the device exists on scan, do not change visibility (visible box) JAG request

Developments

  • Add to devices only the commands that are supported by each
  • Allow to have servers other than amazon.fr
  • Retrieve "'the last spoken voice command'"
  • Enable/disable alarms
  • Add date/time in logs
  • Add a WhenNextTimer
  • Routine management
  • Sound launch via MP3 or other (to generate an intrusion alarm)
  • Recover the volume "in progress"
  • Schedule functions such as Speak that record the current volume, run the Speak command to a specific volume, and return the old volume
  • Add a checkbox for Informed Users
  • Better manage disconnected devices
  • Delete All Alarms action command could remove reminders
  • Go and retrieve the ‘Do Not Distrub’ information and assign it to the devices (application /api/dnd/device-status-list)
  • Go and retrieve the bluetoothStates information (application /api/bluetooth?)

Team and need for help

The team is as follows:

26350534  Sigalou Generalist developer, touch everything. Designer of the plugin, in support of improvements, bug fixes and other evolutions.
 Nebz  Nebz Senior developer, very present on supporting the use of NPM and dependencies, full of good ideas.
jbecker  Jbecker Very experienced and rigorous developer in the presentation and simplification of scripts, ensures the link with the ioBroker script

All good wills are welcome, collective work on this plugin.

Whether you are a programmer, developer, user or full of good voloonity, there are things to do.

We would need translators to make this plugin international.

Documentation is to be done, probably useful tutorials …

Leave a Reply