v1.13

Version 1.13 (2026-01-17):

Behaviour changes:
* Enable searching local sources with no visible panels by default
* Add some clarifying help to the 'Exclude trailing brackets' search option

Bug fixes:
* Fix automatic removal of trailing dots and spaces from lyric filenames
  * This behaviour is intentional on directories but not file names
  * Users with existing lyric files that have had trailing dots or spaces
    removed may need to rename those files for OpenLyrics to find them.
* Fix being unable to load or save some file paths from portable fb2k
* Fix requests to Metal-Archives all returning 403
* Fix logs sometimes being spammed with warnings about missing UIE panels
* Fix an assortment of log lines that could be a little misleading
* Fix possible log spam during startup
  * There is now an extra level of 'debug logging' that uses the existence
    of a file in the fb2k config directory.
  * Logs emitted early in startup will only appear if this file is present

v1.12

Version 1.12 (2025-02-21):

Behaviour changes:
* Migrate the genius.com source from web scraping to using the API
* Enforce a limit on the number of search results returned from LRCLib
* Add a label to the root preferences page prompting to check the subpages

Bug fixes:
* Fix a crash when trying to show lyrics for a track with none saved
* Fix letras.com returning random lyrics when a good match isn't found
* Fix SongLyrics.com still returning lyrics saying there are no lyrics
* Fix a potential crash while hashing for metrics or LRCLib upload
* Fix the editor occasionally producing an invalid timestamp on line sync
* Fix some users being spammed with info-level logs on startup

v1.11

Version 1.11 (2024-09-05):

* Add a source for Bandcamp.com
* Fix SongLyrics.com sometimes returning lyrics saying there are no lyrics
* Fix OpenLyrics panels getting colours confused when toggling dark mode

v1.10.2

Version 1.10.2 (2024-09-02):

* Fix a crash when attempting to edit lyrics on a track with none saved
* Fix internet radio always searching when a new track starts, ignoring
  the option to only search when an OpenLyrics panel is visible

v1.10.1

Version 1.10.1 (2024-08-30):

* Fix version 1.10 not having any version at all in the fb2k components UI

v1.10

Version 1.10 (2024-08-30):

New features:
* Add a source for LRCLIB (https://lrclib.net)
* Add a source for SongLyrics.com
* Add a source for lyricsify.com
* Add a source for letras.com
* Add a source for LyricFind.com
* Add the option to upload lyrics to LRCLIB
  * For now this feature is experimental, not all lyrics will be uploaded
  * Upload is disabled by default, but can be enabled in Preferences/Upload
  * Upload is triggered by editing & saving lyrics
  * Lyrics will only be uploaded if they are timestamped
  * Lyrics will not be uploaded if LRCLIB has any lyrics for that track
* Add the ability to see info about the lyrics for a particular track
  * This shows the original source, when last it was edited and more
  * This data wasn't available before this update, so tracks with existing
    saved lyrics will show that the original source is local files/tags
* Add the option to enable searching even with no visible OpenLyrics panels
  * This can be enabled in Preferences/Searching
* Add an auto-edit for removing surrounding whitespace from lyrics lines
  * This is enabled by default for auto-application to new lyrics
  * The new default will only apply to new OpenLyrics users
* Add an 'Is timestamped?' column to the manual search result table
* Allow configuring whether search prefers synced or unsynced lyrics
  * This only impacts sources that return both types
  * If a source returns only one type you'll get that type regardless

Behaviour changes:
* Change default local file name format to replace invalid characters
  * Applies to new users only. Existing users' settings won't be changed
* Prevent manual search result columns from starting out 0 pixels wide
* Manual search can now give both synced & unsynced results from Musixmatch
  * Previously you'd only get one or the other, not both simultaneously
* Split the source config out from the 'Searching' preferences page
  * It now lives under the new 'Search sources' preferences page
* Metadata tag search now defaults to checking 'UNSYNCED LYRICS' first
  * This is internally FB2K stores this tag in a special, standard location
  * This should very slightly improve compatibility with other software
  * This will not affect whether synced or unsynced lyrics are selected
  * This will only apply to new users. Existing config will not be changed
* Add 'Remove repeated spaces' to the set of auto-edits enabled by default
  * This will only affect new users of OpenLyrics

Bug fixes:
* Fix the lyric editor sometimes responding badly to Ctrl-A/Ctrl-Backspace
* Fix possibly using the wrong background colour when changing FB2K colours
* Fix Metal Archives possibly returning 'lyrics not available'
* Fix album art backgrounds disappearing when playing the same track twice
* Fix the 'encoding' tag in LRC files being considered a lyric line
* Fix rounding errors causing timestamps to randomly change when saving
* Fix LRC same-line collapsing sometimes deleting parts of a line
* Fix search avoidance not working for remote/internet radio tracks
* Fix debug logs going missing if printed early on during fb2k startup
* Fix the search-avoidance tracker counting local-only searches
* Fix possibly selecting the worse match of two lyrics provided by a source
* The external window now respects colour settings when no lyrics are found

Internal improvements:
* Update the foobar2000 SDK to version 20230913
* Switch to using built-in Windows codecs for all image loading
* Many, many non-functional code improvements

v1.9

Version 1.9 (2024-06-12):

Bug fixes:
* Fix a crash when attempting to load lyrics for non-existent media files
* Fix lyrics sometimes not updating when not all lyric panels are visible

v1.8

Version 1.8 (2023-10-28):

Behaviour changes:
* Searches that are 'skipped' now still search local sources
  * This means that you'll still see lyrics for tracks matching the
    skip filter if they were already available from a local source.
  * For example if you already have (or explicitly search for) lyrics
    saved to file for a track whose genre is 'Instrumental' (which
    matches the default skip filter) then those will still show up.
* Change the default search filter to consider multi-value genre tags

Bug fixes:
* Fixed the default search skip filter never skipping anything
* Fix the parsing of line breaks in lyrics from genius.com

v1.7

Version 1.7 (2023-10-18):

New features:
* Add support for album art or a custom image file as the panel background
* Add support for gradients to the background colour preferences
* Add support for showing already-passed lyric lines in a different colour
* Add configuration for horizontal and vertical text alignment
* Add (experimental) support for showing the panel in an external window
* Add a source for metal-archives.com
* Add a 'skip filter', a titleformat-based way to skip auto-search
* Show the active sort order in column headers of the manual search window

Behaviour changes:
* Stop asking users to submit metrics after a pre-defined date
* Automatically display search result in all lyric panels, not just one
* Remove support for horizontal scrolling
* Move preferences for searching onto their own page, named accordingly
* Add a preferences page for each source with source-specific options
* Show a different 'no lyrics' message based on the reason they're missing
  * For example tracks marked instrumental will show one message, while
    tracks that are not instrumental, but that repeatedly fail searches
    will show a different message
  * This does not apply retroactively: Tracks that were previously marked
    instrumental will still show as having failed too many searches.
    Marking those tracks instrumental one more time will fix this.
* Skip auto-searching remote sources when the track has no metadata tags

Bug fixes:
* Fix retrieval failing from some sources when no 'album' tag is present
* Fix crash when deleting lyrics from tags via the playlist context menu
* Fix crash when playing tracks that have no tag metadata at all
* Fix LRC offset tags being ignored if they contained a space
* Fix a potential crash when opening preferences, caused by corrupt config
* Avoid sometimes creating difficult-to-delete folders when saving to file
* Fix a case where NetEase sometimes returns garbage results unnecessarily

v1.6

Version 1.6 (2023-04-13)

Bug fixes:
* Fix crash on startup when running on fb2k v2, beta 31 or earlier