View Source Changelog


0.10.0 (2023-06-07)

  • first interactive notebook - Livebook support
  • provide an archiving Livebook to initiate archiving jobs
  • playcounts heatmap and table for visualising archiving progress


0.9.3 (2023-06-02)

  • refactor: FileArchive - raw Lastfm scrobbles JSON format and better logging
  • default runtime configuration to better support Livebook usage


0.9.2 (2023-05-24)

  • info/0 returns total play count and first date of scrobble for default user
  • update Lastfm client to use Livebook system env vars (LB_LFM_USER and LB_LFM_API_KEY) along with config values
  • rename modules and tests in idiomatic namespaces
  • bump dependencies, Elixir / Erlang versions
  • Github Actions CI


0.9.1 (2021-05-05)

  • sync/2 handles request errors from API
  • caches errors during sync so that subsequent syncs or API requests can be made to archive the missing scrobbles
  • do not cache sync results of today's scrobbles as it's a always partial sync


0.9.0 (2021-04-14)

  • Create an Archive behaviour with FileArchive implementation
  • Extract and store scrobbles in daily chunks
  • Extensive refactoring: simpler LastfmArchive functions core, deprecate archive functions
  • Rewrite tests with mocks, eliminate file writes during tests
  • Implement a GenServer simple tick-based (auto) cache memoization to prevent repetitive API calls to


0.8.0 (2021-01-04)

  • Update Elixir/Erlang versions and dependencies
  • Replace HTTP client (HTTPoison) with Erlang's built-in httpc client
  • Replace Poison with Jason for JSON decoding/encoding
  • Apply mix formatting to the entire codebase
  • Refactor and abstract LastfmArchive.Extract functions into a new module based on Lastfm.Client behaviour
  • Implement explicit behaviour and contract-based unit testing (Hammox/Mox)
  • Refactor and enable concurrent testing


0.7.2 (2019-02-25)

  • Fix the issue of changing the date/count data type in JSON back and forth (string <-> integer).


0.7.1 (2019-01-14)

  • Patches as per API JSON data format changes: uts timestamp, play counts info are now returned as integers instead of strings.


0.7.0 (2019-01-11)

  • sync/0, sync/1: sync and keep tracks of scrobbles for a default and users, via delta archiving (download latest scrobbles)


0.6.0 (2018-11-10)

  • Support for Solr: load all transformed (TSV) data from the archive into Solr, load_archive/2
  • Underpinning functions to read, parse, load data into Solr


0.5.0 (2018-11-05)

  • transform_archive/2: transform downloaded raw archive and create a TSV file archive
  • Underpinning functions to read, parse and transform raw Lastfm JSON data into TSV files


0.4.1 (2018-11-01)

  • fix single year archiving (bug): daily: true option


0.4.0 (2018-10-31)

  • archive/3: archiving data subset based on date ranges: single day/year, past week/month, arbitrary date range using Date, Date.Range structs
  • daily: true option for finer-grained batch archiving cf. the default year-level granularity


0.3.2 (2018-10-27)

  • overwrite archiving option to also re-fetch any existing downloaded data, for refreshing file archive


0.3.1 (2018-10-27)

  • Keyword list archiving options (per_page, interval) for archive/2 which can also be configured


0.3.0 (2018-10-26)

  • archive latest tracks (current year) on a daily basis to better ensure data immutability and updatability (new scrobbles)
  • archive older tracks on a yearly basis


0.2.0 (2018-10-23)

  • archive/0: downloads scrobbled tracks, creates a file archive for a default user according to configuration settings
  • archive/2: downloads scrobbled tracks, creates a file archive for any Lastfm user
  • write/3: outputs data for multiple Lastfm users (no longer hardwired to the default user)


0.1.0 (2018-10-22)

  • Download scrobbled tracks raw data, create an archive on local filesystem for a default user in configuration - archive/1
  • extract/5 and write/2 functions for Lastfm API requests and file output