metabrainz.listenbrainz's Introduction

MetaBrainz.ListenBrainz

This is a library providing access to the ListenBrainz API.

ListenBrainz keeps track of users' listens of music tracks (similar to sites like last.fm and libre.fm).

Debugging

The ListenBrainz class provides a TraceSource that can be used to configure debug output; its name is MetaBrainz.ListenBrainz.

Configuration

In Code

In code, you can enable tracing like follows:

// Use the default switch, turning it on.
ListenBrainz.TraceSource.Switch.Level = SourceLevels.All;

// Alternatively, use your own switch so multiple things can be
// enabled/disabled at the same time.
var mySwitch = new TraceSwitch("MyAppDebugSwitch", "All");
ListenBrainz.TraceSource.Switch = mySwitch;

// By default, there is a single listener that writes trace events to
// the debug output (typically only seen in an IDE's debugger). You can
// add (and remove) listeners as desired.
var listener = new ConsoleTraceListener {
  Name = "MyAppConsole",
  TraceOutputOptions = TraceOptions.DateTime | TraceOptions.ProcessId,
};
ListenBrainz.TraceSource.Listeners.Clear();
ListenBrainz.TraceSource.Listeners.Add(listener);

In Configuration

Starting from .NET 7 your application can also be set up to read tracing configuration from the application configuration file. To do so, the application needs to add the following to its startup code:

System.Diagnostics.TraceConfiguration.Register();

(Provided by the System.Configuration.ConfigurationManager package.)

The application config file can then have a system.diagnostics section where sources, switches and listeners can be configured.

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add name="console" type="System.Diagnostics.ConsoleTraceListener" traceOutputOptions="DateTime,ProcessId" />
    </sharedListeners>
    <sources>
      <source name="MetaBrainz.ListenBrainz" switchName="MetaBrainz.ListenBrainz">
        <listeners>
          <add name="console" />
          <add name="lb-log" type="System.Diagnostics.TextWriterTraceListener" initializeData="lb.log" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="MetaBrainz.ListenBrainz" value="All" />
    </switches>
  </system.diagnostics>
</configuration>

Release Notes

These are available on GitHub.

metabrainz.listenbrainz's People

Contributors

Stargazers

Watchers

metabrainz.listenbrainz's Issues

Usage example

Very nice addon to c# for ListenBrainz!
Do you have example of usage for this API?
There is non in the readme or the project.

`GetRecentListens` no longer works

This endpoint seems to have been dropped by ListenBrainz, so we can drop the corresponding method too.

Update processing to match current server behaviour

Some of the endpoints seem to be returning data that does not match the current API documentation:

artist info (e.g. user and sitewide artist stats) has a single artist_mbid instead
artist map has additional information: for each country, an artists field containing a list of artist info
the result of the listens endpoint includes a new timestamp field (oldest_listen_ts)
the mbid_mapping field of a recent listen now has several additional fields (artists, caa_id, caa_release_mbid and recording_name)
- the artists field is a list of artist credits (artist_mbid + artist_credit_name + join_phrase)
- artists, caa_id and caa_release_mbid also appear in the data for the recording and release statistics

Listens cannot be deserialized

The inserted_at field used to be a string containing an RFC1123 date, but it's now a Unix timestamp, just like all the other timestamps (because of LB-754).
As a result, deserialization now fails (because it gets a number where a string is expected).

Recommend Projects