LibSMTC 1.1.0

LibSMTC

LibSMTC is a standalone Windows System Media Transport Controls (SMTC) library for .NET desktop apps.

It helps you do two things:

• Player → OS: publish playback state, metadata, timeline, and album art.
• OS → Player: receive media key requests (Play, Pause, Next, Previous, Seek, Shuffle, Repeat).

Why LibSMTC

• Clean, event-based API.
• Works great as a bridge layer for your own audio/video engine.
• Includes a runnable sample app.

Repository Structure

• LibSMTC: reusable class library.
• LibSMTC.Sample: console sample showing end-to-end integration.
• LibSMTC.sln: Visual Studio 2022 solution.

Requirements

• Windows 10/11
• .NET SDK 8.0+
• Visual Studio 2022 (optional, recommended)

Build

Run from the repository root:

dotnet build LibSMTC.sln

Run the Sample

dotnet run --project LibSMTC.Sample

Optional: pass an album art image path:

dotnet run --project LibSMTC.Sample -- D:/path/to/cover.jpg

Sample controls:

• Space: toggle play/pause
• N: switch to next mock track metadata
• C: clear metadata and thumbnail
• R: toggle repeat mode
• S: toggle shuffle
• Left/Right: seek -/+ 10 seconds
• Q or Esc: quit

Quick Start (Library)

using LibSMTC;

using var smtc = new LibSmtcController();

// OS -> Player
smtc.PlayRequested += (_, _) =>
{
    // Start playback in your player.
    smtc.Play();
};

smtc.PauseRequested += (_, _) =>
{
    // Pause playback in your player.
    smtc.Pause();
};

// Player -> OS
smtc.SetMusicMetadata(
    title: "Song Title",
    artist: "Artist",
    albumTitle: "Album"
);

smtc.SetTimeline(TimeSpan.FromSeconds(30), TimeSpan.FromMinutes(3));
smtc.Play();

API Highlights

• Playback state: Play, Pause, Stop, Close, PlaybackStatus.
• Metadata: SetMetadata, SetMusicMetadata.
• Artwork: SetThumbnailFromFileAsync, SetThumbnailFromUri, SetThumbnailFromBytesAsync, SetThumbnailFromStreamAsync, ClearThumbnail.
• Timeline: SetTimeline.
• Button control: SetButtons.
• OS requests: PlayRequested, PauseRequested, StopRequested, NextRequested, PreviousRequested, FastForwardRequested, RewindRequested, SeekRequested, ShuffleChangeRequested, RepeatModeChangeRequested.

Development Notes

• XML documentation is enabled for the LibSMTC library project.
• Build outputs (bin/obj) are intentionally not tracked.

License

See the repository license file.