XeroxDev.YTMDesktop.Companion 1.0.0

.NET 7.0 This package targets .NET 7.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package XeroxDev.YTMDesktop.Companion --version 1.0.0                

                    
                

            
NuGet\Install-Package XeroxDev.YTMDesktop.Companion -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="XeroxDev.YTMDesktop.Companion" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add XeroxDev.YTMDesktop.Companion --version 1.0.0                

                    
                

            
#r "nuget: XeroxDev.YTMDesktop.Companion, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install XeroxDev.YTMDesktop.Companion as a Cake Addin
#addin nuget:?package=XeroxDev.YTMDesktop.Companion&version=1.0.0

// Install XeroxDev.YTMDesktop.Companion as a Cake Tool
#tool nuget:?package=XeroxDev.YTMDesktop.Companion&version=1.0.0

YTMDesktop CSharp Companion

This is a library for the YTMDesktop Companion Server which lets you easier communicate with the server and handle authorization and so on.

Table of contents

Badges

Forks Stars Watchers Contributors

Issues Issues closed

Issues-pr Issues-pr closed PRs welcome

Version Downloads

Awesome Badges

Installation

TODO: Add installation instructions

Usage

Can be easier seen in the example file Also you can look through the documentation but here's a quick rundown:

// import everything
using System.Text.Json;
using NuGet.Versioning;
using XeroxDev.YTMDesktop.Companion;
using XeroxDev.YTMDesktop.Companion.Settings;

// Set YOUR version (or fetch them from anywhere) I will use a static version for this example 
var version = SemanticVersion.Parse("1.0.0");

// Define settings (add token if you have one, see bigger example for how this could be done)
var settings = new ConnectorSettings(
    "127.0.0.1",
    9863,
    "ytmdesktop-cs-companion-example",
    "YTMDesktop C# Companion Example",
    version
);

// Create a new connector
var connector = new CompanionConnector(settings);

// extract clients for easier access
var restClient = connector.RestClient;
var socketClient = connector.SocketClient;

// Get metadata
var metadata = await restClient.GetMetadata();
if (metadata is null)
{
    Console.WriteLine("Failed to get metadata. Probably the server is not running or the settings are wrong.");
    return;
}

Console.WriteLine(JsonSerializer.Serialize(metadata));

// Get token
var code = await restClient.GetAuthCode();
if (code is null)
{
    Console.WriteLine("Failed to get auth code. Probably the server is not running or the settings are wrong.");
    return;
}

Console.WriteLine($"Got new code, please compare it with the code from YTMDesktop: {code}");

var token = await restClient.GetAuthToken(code);
if (string.IsNullOrWhiteSpace(token))
{
    Console.WriteLine("Something went wrong...");
    return;
}
// Get the current state and print it
var state = await restClient.GetState();
Console.WriteLine(JsonSerializer.Serialize(state));

// Pause current track
await restClient.Pause();

// wait 2 seconds
await Task.Delay(2000);

// Resume current track
await restClient.Play();

How to contribute?

Just fork the repository and create PR's.

[!NOTE] We're using release-please to optimal release the library. release-please is following the conventionalcommits specification.

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net7.0-windows7.0 is compatible.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net8.0-windows7.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.2 135 2/28/2024
1.1.1 113 2/28/2024
1.1.0 117 2/25/2024
1.0.0 113 2/24/2024

Please see the CHANGELOG.md file for release notes. You can find the CHANGELOG.md file at https://github.com/XeroxDev/ytmdesktop-cs-companion/blob/main/CHANGELOG.md
           For more information and documentation, please visit the project page at https://github.com/XeroxDev/ytmdesktop-cs-companion