Skip to content

AccessifyPlay 1.13.0

Latest

Choose a tag to compare

@github-actions github-actions released this 07 Nov 21:17

Changes since 1.12.2. Most of this release was contributed by aradix85 (#62).

⚠️ Signing in works again

  • Signing in failed with "redirect_uri: Not matching configuration": the shared Client ID belongs to ncspot, which changed the sign-in address registered on it, so Spotify refused every sign-in. Accessify Play now uses the new address. Signing in with your own Client ID is unchanged.
  • Signing in had to be finished within 10 seconds: Validate Credentials stopped waiting for the browser after 10 seconds, the limit NVDA gives every network connection, and signing in failed. It now waits five minutes, and signInTimeoutSeconds in nvda.ini changes that. Trying again straight after a failed sign-in works too.
  • New Sign-in port setting: the port Spotify's sign-in sends the browser back to can be changed in the settings (5588 by default), for when another program already uses it.
  • The Redirect URI to register is shown in the settings: a read-only field before the Client ID shows the exact address to add to your own Spotify app, following the sign-in port.
  • An error in NVDA's log at every start while not signed in ("lost sys.stdin"): starting up tried to sign in, and spotipy asked for the sign-in on a command line NVDA does not have. Starting up now only reads a saved sign-in.

🎉 Search: switch the type without leaving the results

  • Ctrl+1 to Ctrl+6 choose Song, Album, Artist, Playlist, Podcast or Audiobook, and Ctrl+Tab / Ctrl+PageDown and Ctrl+Shift+Tab / Ctrl+PageUp go to the next or previous type. With text in the search field the search runs again at once, and the focus moves to the results.
  • Ctrl+F goes back to the search field with its text selected, ready to type over.
  • Opening Search while it is already open puts the focus in the search field.
  • "No results found." is spoken: the focus stays where it is in that case, so NVDA said nothing.
  • A quick switch can no longer show the results of the type you switched away from.

🎉 Artist window: popular songs first, and playlists

  • It opens on Top Tracks, with the focus on the first song once it has loaded.
  • New Playlists found by name tab: playlists found by searching for the artist's name, so most are made by other listeners; Spotify's own, such as "This Is ...", come first. Enter opens one, and Alt+P, Alt+Q and Alt+L play, queue and copy it.
  • The tabs switch like the types in Search: Ctrl+1 to Ctrl+5 go to a tab with the focus in its list, and Ctrl+Tab / Ctrl+PageDown and Ctrl+Shift+Tab / Ctrl+PageUp go to the next or previous tab. The order is now Top Tracks, Albums and Singles, Playlists, All Tracks, Artist Info.
  • Every list is named after its tab, so NVDA says where you are.
  • Top Tracks names the artists only when someone else is on the song, instead of repeating the artist on every line.

🎉 The same lists, menus and keys in every window

  • One context menu per kind of item, the same in every window: first Play, Add to Queue and Copy Link, with their keys; then opening the item (View Tracks, View Episodes, View Chapters, View Discography), Save/Unsave or Follow/Unfollow, and Add to Playlist; then Show Lyrics, Go to Album and Go to Artist; and last what belongs to that window alone. A menu offers only what works for the item: an artist or podcast no longer offers Add to Queue, and nothing pops up for an item nothing can be done with.
  • Save/Unsave Track and Save/Unsave Album in every list of songs and albums, and Follow/Unfollow Playlist for any playlist someone else made, also in the artist window and in Browse.
  • Enter does the same everywhere: it plays a song, episode or chapter, opens an album, playlist, podcast or audiobook, and opens an artist's discography. In the Library, New Releases now opens an album instead of playing it (Alt+P still plays it), and an artist in Top Items opens.
  • A song listed outside its album plays within its album, as it already did in Search: in the artist window's Top Tracks and All Tracks, and in the Library's song tabs. The album carries on afterwards.
  • Every kind of item reads the same in every list: "Song - Artist (3:21)", "Album - Artist (2020)", "Episode - Podcast (2026-01-02, 45:00)", "Book - Author". The queue's rows read the same way, after "Playing" or "Queue".
  • The Library's tabs switch like Search and the artist window: Ctrl+1 to Ctrl+9, Ctrl+Tab / Ctrl+PageDown and Ctrl+Shift+Tab / Ctrl+PageUp, with the focus in the tab's list.
  • Removing an item from the Library takes its row away and keeps the cursor where it was, instead of loading the tab again from the top.
  • The queue window's context menu is a song's or episode's usual menu, so you can save a song, add it to a playlist or go to its album from there; Alt+W shows its lyrics.
  • Add to Playlist works in every list of songs, also in a playlist's tracks and in the queue: your own playlists load the first time the menu needs them.
  • The play button reads "Play Selected" in every track, episode and chapter window.
  • New page in the user guide: Lists and context menus, describing all of this in one place.

🎉 More settings

New in Accessify Play's settings (NVDA menu, Preferences, Settings, Accessify Play):

  • Sleep timer starts at and Longest sleep timer: the minutes the sleep timer offers (30) and the most it accepts (240).
  • Most tracks to queue from an album or playlist: Add to Queue on a whole album or playlist sends a request for every track, so it now stops at 100 tracks by default and says so ("Queued the first 100 of 250 tracks from ..."). Every request counts against the request limit everyone shares.
  • Play My Top Tracks plays the top tracks of: Last 4 Weeks, Last 6 Months or All Time, for G in the command layer.
  • Top Items in the Library opens on: the period the Top Items tab starts with.
  • Search opens on: the type the Search window starts with.
  • New playlists are public: whether Create Playlist starts with Public playlist checked.

🎉 Change the shortcuts inside the windows

  • New Window Shortcuts... button in Accessify Play's settings: every shortcut inside the windows can be changed, such as Alt+P to play, the keys that switch search types and tabs, Ctrl+N for a new playlist, and the keys that move and remove tracks in the Library. Several keys per action are possible, or none. Keys that would get in the way of typing, or that another action already has, are refused with the reason. Menus show the keys you chose. They are in nvda.ini too; the user guide (Customizing commands and shortcuts) lists them.
  • Alt+W shows a song's lyrics in every list of songs: albums, playlists, the artist window, the Library and the queue, not only in Search.

🎉 Long lists come a page at a time

  • The Library's tabs (saved tracks, albums, shows, episodes, audiobooks, new releases) load a page at a time with a "Load More" row, instead of fetching everything before showing anything. A large library opens much faster and sends far fewer requests.
  • Search uses the same lists: after Load More the cursor is on the first new result, and a search that fails says why in the results list as well as aloud.

🎉 Browse Categories and Featured Playlists

  • They load a page at a time with a "Load More" row, like every other list, instead of loading more when you reach the end.
  • Playlists can be queued: Add to Queue in the context menu, and Alt+P, Alt+Q and Alt+L play, queue and copy the selected playlist.
  • They no longer block the Search window while they are open.

🎉 Advanced settings in nvda.ini

  • Timings and limits that were fixed in the code are now settings: how often Accessify Play asks Spotify what is playing, how long a request may take and how often it is retried, the lyrics server, the command layer's timeout and beeps, and more. They are not in the settings panel; the user guide (Sign-in and settings) lists each one with its default and how to change it in nvda.ini.

🛠️ Bug fixes

  • Play/Pause, volume, shuffle and repeat said they worked when Spotify refused: "Paused", "Volume 55%" and so on were spoken even when the command failed. They now say why it failed.
  • Play/Pause with no active device did nothing. It now wakes your device and plays.
  • Like/Unlike (L) on a podcast episode looked the episode up as a song. It now saves it to Your Episodes.
  • Volume on a device that does not report its volume raised an error instead of saying so.
  • Two quick presses of a playback command could both get through, sending the command twice.
  • An error every 5 seconds in the NVDA log while Spotify reported nothing playing, such as between items.
  • A timeout on a playback command was logged as an unexpected error, with a full traceback.
  • Shared links with a country in them (open.spotify.com/intl-nl/track/...) were misread by Play from Link and the link details. They now work like any other link.
  • Copying the lyrics from the lyrics window gave no feedback. NVDA now says they were copied.
  • Adding an album to a playlist stopped after 100 songs when one of them was already in the playlist. The whole album is now added, skipping only the songs that are already there.
  • A song without lyrics was reported as a connection problem ("Could not load lyrics. Please check your internet connection."). It now says no lyrics were found, and the connection message is only for when lrclib.net can't be reached.
  • A failed lyrics lookup was remembered: after a network hiccup, the song kept saying it had no lyrics until NVDA restarted. Only successful lookups are kept now.
  • All Tracks in the artist window stopped for good when one album failed to load. The songs so far now stay, and "Load More" tries that album again.
  • A context menu with nothing in it was never cleaned up, leaving a small leak each time.
  • The command layer editor offered to restart NVDA after a change, although the new keys already worked. It no longer asks.
  • Command descriptions in the layer's help and editor stayed in the words of the version that first saved your keys. They now always follow the add-on, in the add-on's language.
  • A playlist whose tracks could not be loaded, in the Library, left an empty list; so did the artist window's albums. The list now says what went wrong, and an artist without albums says so.
  • Some list rows were always in English: "by" in playlist rows in Search and the artist window, and in the queue window.
  • Browse Categories and Featured Playlists loaded 50 items at a time whatever the Search Results Limit said. They now follow it, like every other list.
  • A button could announce a shortcut that did something else: the Library's Play Playlist button said Alt+P, while Alt+P played the selected track. Now Alt+P on the playlists tab, outside the track list, plays the chosen playlist; and a button whose letter you give to another shortcut no longer shows that letter.
  • Reloading a list while a page was still on its way (searching again quickly, changing Top Items' choices) could leave the list without results. The late page is now dropped and the new one loads.
  • Playing from a window said nothing when Spotify refused: "Playing..." was spoken, and then nothing, when for instance no device was active or the account has no Premium. Albums, playlists, Search, the Library, episodes and chapters now say why it failed, as the command layer already did.
  • Show Queue failed with an error while nothing was playing.
  • Add to Playlist in the Library offered other people's playlists, which Spotify does not let you change. It now offers only your own.
  • The command layer editor took a key away from another command without saying so when you gave a command a key that was already in use. It now says which command has that key and lets you choose another.
  • The lyrics window had no timestamp buttons when the first song it showed had plain lyrics only, so later songs with synced lyrics had none either.
  • The artist window stopped filling its tabs when Spotify sent an album without a name or release date: Albums and Singles, All Tracks and Playlists stayed empty.
  • All Tracks in the artist window named the artist on every line. Like Top Tracks, it now names the artists only when someone else is on the song.
  • A list could stay on "Loading..." for good after an unexpected error. It now says the list could not be loaded.
  • A hand-edited layerConfig.json with a malformed entry gave that command odd keys. Such an entry now gets the command's default key.
  • Items Spotify sends with missing details (a playlist without an owner, a song without artists, a queue without a current song) could stop a window from filling its list. They are now shown with what is known.

🧹 Under the hood

  • One way to save, remove, follow and unfollow: Spotify's single /me/library endpoint (February 2026) replaces 21 separate per-type functions, and one "flip the state and say which way" helper replaces six copies of that logic.
  • The playback commands share their code: one guard instead of nine, and one helper each for next/previous, volume up/down and seek forward/back.
  • One request handler: the two request wrappers share their error handling and readiness check, and six copies of the same pagination loop became one.
  • management.py is split up: it held eight dialogs in 2,900 lines. The library manager stays there; the album, playlist, artist, podcast and playlist-form dialogs have their own modules.
  • Featured Playlists and category playlists share one dialog instead of two near-identical copies.
  • The popular songs of an artist take one request fewer when the artist's name is known.
  • Every ruff rule is on (select = ["ALL"]), with the few exceptions listed in pyproject.toml along with the reason for each. ruff check and ruff format run in pre-commit, and so in CI.
  • Type annotations and docstrings on everything: every function says what it takes and returns, and every module, class and public method says what it is for.
  • Errors are handled on purpose: catching every exception is narrowed to what can actually fail, or kept at a boundary and logged, instead of being swallowed silently.
  • One clipboard helper, built on NVDA's api.copyToClip, replaces three hand-written ones; one set of add-to-playlist helpers replaces four copies in four windows; the long context menus are split into small parts.
  • Lyrics are fetched with requests, already bundled for spotipy, instead of hand-built urllib requests; paths use pathlib; HTTP statuses use http.HTTPStatus. One lyrics lookup serves the lyrics window, the auto-reader and the preview.
  • One paged list fills playlists, episodes, chapters and the artist's All Tracks a page at a time, with the Load More row, instead of four copies of that code. The episode and chapter windows share one window class.
  • Hundreds of lines less code from the clean-up, the new features included, and dead code removed, such as error branches that could never run.
  • One table of settings (settings_spec.py): the config spec, the defaults, and the ranges and labels of the settings panel are all made from it, so a limit is changed in one place. Tests check that the panel and the user guide match it.
  • One table of commands (commands.py) for the command layer's keys, names and descriptions, which used to be listed three times. layerConfig.json now keeps only your keys and whether the layer stays open.
  • A real test suite: pytest drives every window and command against stand-ins for NVDA, wx and Spotify's Web API, and covers every line and branch; CI fails below 99%. It replaces tests/run_tests.py, and checks the translations, the user guides and the bundled libraries too.
  • Removed code that never ran: an install-time clean-up for an NVDA function that does not exist, and lists the Library could be handed ready-made, which only the tests used (they now go through the stand-in Spotify server).
  • Type checking with pyright runs with the other checks, and found a few places where missing details from Spotify could stop a window (a playlist or artist without a name, a song without an id).
  • One way to give a window its shortcuts (_bind_shortcuts), instead of an accelerator table written out in each window; the keys come from the settings, and menus show them.
  • Every long list uses one paged list (Search, the Library's tabs, Browse Categories and Featured Playlists included), and playing from any window goes through one helper that reports failures.
  • One context menu, one Enter and one row format for every window: rows.py writes the rows, and the windows' base class builds the context menu, opens items, decides what Enter does and queues, instead of each window keeping its own copy. The windows fetch your playlists for Add to Playlist in one way too.
  • Lyrics requests name the add-on's homepage from its manifest (addon_url in buildVars.py) instead of a fixed address, and the donation link is written once.
  • flake8 checks the code too, with the other checks, as the original project's contributing guide asks (settings in .flake8).

SHA256 Checksum:

93971fa16345a4cad4b02da5f2a34dd297f2f4e8c80f3a49193374bac8e000b7 AccessifyPlay-1.13.0.nvda-addon