### Install Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.InstallController.html

Starts the game installation process using the provided installation arguments.

```APIDOC
## Install(InstallActionArgs)

### Description
Start installation.

### Parameters
#### args InstallActionArgs
- **args** (InstallActionArgs) - Description not available
```

--------------------------------

### Install Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.InstallController.html

Abstract method to start the game installation process. Implementations must define the actual installation logic.

```csharp
public abstract void Install(InstallActionArgs args)__
```

--------------------------------

### Basic Startup Script Example

Source: https://api.playnite.link/docs/manual/features/scriptingSupport/startupScript.html

This script starts a game executable and waits for it to exit. It's a fundamental example for managing game processes.

```powershell
$process = [System.Diagnostics.Process]::Start("game.exe")
$process.WaitForExit()
$process.Dispose()
```

--------------------------------

### InstallationStatus Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets the current installation state of the game.

```csharp
public InstallationStatus InstallationStatus { get; }__
```

--------------------------------

### InstallDirectory

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the installation directory path for the game.

```APIDOC
## InstallDirectory

### Description
Gets or sets game installation directory path.

### Property Value
string
```

--------------------------------

### InstallationFile Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.EmulatorDefinitionProfile.html

Gets or sets the path to the emulator's installation file.

```csharp
public string InstallationFile { get; set; }__
```

--------------------------------

### InstallSize

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the install size of the game in bytes.

```APIDOC
## InstallSize

### Description
Gets or sets the install size in bytes of the game.

### Property Value
ulong?
```

--------------------------------

### InstallDirectory Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.GameMetadata.html

Gets or sets installation directory. This property is of type string.

```csharp
public string InstallDirectory { get; set; }__
```

--------------------------------

### Example: Create New Desktop Theme

Source: https://api.playnite.link/docs/tutorials/themes/usingBlend.html

This is an example of creating a new desktop theme named 'Super Clear Modern'. Ensure you are in Playnite's installation directory when running this command.

```bash
Toolbox.exe new desktoptheme "Super Clear Modern"
```

--------------------------------

### Install Game

Source: https://api.playnite.link/docs/api/Playnite.SDK.IPlayniteAPI.html

Initiates the installation process for a game identified by its unique ID.

```csharp
void InstallGame(Guid gameId)
```

--------------------------------

### Example: Create New Desktop Theme

Source: https://api.playnite.link/docs/tutorials/toolbox.html

This is an example of creating a new desktop theme named 'New Desktop Theme'.

```bash
Toolbox.exe new desktoptheme "New Desktop Theme"
```

--------------------------------

### Example: Create New Metadata Plugin

Source: https://api.playnite.link/docs/tutorials/toolbox.html

This is an example of creating a new MetadataPlugin named 'GameDatabase metadata provider' in the 'd:\\somefolder' directory.

```bash
Toolbox.exe new MetadataPlugin "GameDatabase metadata provider" "d:\\somefolder"
```

--------------------------------

### GetInstallActions Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Returns a collection of install controllers for managing game installations.

```csharp
public virtual IEnumerable<InstallController> GetInstallActions(GetInstallActionsArgs args)__
```

--------------------------------

### InstallGame

Source: https://api.playnite.link/docs/api/Playnite.SDK.IPlayniteAPI.html

Initiates the installation process for a specified game.

```APIDOC
## InstallGame(Guid)

### Description
Installs the specified game.

### Method
```
void InstallGame(Guid gameId)
```

### Parameters

- **gameId** (Guid) - The unique identifier of the game to install.
```

--------------------------------

### Get Extension List

Source: https://api.playnite.link/docs/api/Playnite.SDK.BuiltinExtensions.html

Gets a dictionary containing all built-in extension plugins, keyed by their GUID.

```csharp
public static Dictionary<Guid, BuiltinExtension> ExtensionList { get; }
```

--------------------------------

### Get Installed Addons

Source: https://api.playnite.link/docs/api/Playnite.SDK.IAddons.html

Retrieves a list of IDs for all currently installed addons.

```csharp
List<string> Addons { get; }__
```

--------------------------------

### IsInstalling

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a value indicating whether the game is currently being installed.

```APIDOC
## IsInstalling

### Description
Gets or sets value indicating whether a game is being installed.

### Property Value
bool
```

--------------------------------

### Example: Pack Theme Extension

Source: https://api.playnite.link/docs/tutorials/toolbox.html

This is an example of packing a theme extension located at 'C:\\Playnite\\Themes\\Fullscreen\\TestingFullscreen' into the 'c:\\somefolder' directory. This will create a 'TestingFullscreen.pthm' package.

```bash
Toolbox.exe pack "C:\\Playnite\\Themes\\Fullscreen\\TestingFullscreen" "c:\\somefolder"
```

--------------------------------

### IsInstalling Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a value indicating whether the game is currently being installed.

```csharp
public bool IsInstalling { get; set; }__
```

--------------------------------

### IsInstalled

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a value indicating whether the game is installed.

```APIDOC
## IsInstalled

### Description
Gets or sets value indicating whether a game is installed.

### Property Value
bool
```

--------------------------------

### InstallSizeGroup Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets the install size group category for the game.

```csharp
public InstallSizeGroup InstallSizeGroup { get; }__
```

--------------------------------

### Script Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.GameAction.html

Gets or sets the startup script.

```csharp
public string Script { get; set; }
```

--------------------------------

### InstallSize Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.GameMetadata.html

Gets or sets install size in bytes of the game. This property is of type ulong? (nullable unsigned long).

```csharp
public ulong? InstallSize { get; set; }__
```

--------------------------------

### On Game Installed Event

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked after a game has been successfully installed.

```csharp
public virtual void OnGameInstalled(OnGameInstalledEventArgs args)__
```

--------------------------------

### PreScript Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.EmulatorProfile.html

Gets or sets the script to be executed before the emulator process starts.

```csharp
public string PreScript { get; set; }
```

--------------------------------

### On Game Started Event

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked when a game has successfully started running.

```csharp
public virtual void OnGameStarted(OnGameStartedEventArgs args)__
```

--------------------------------

### SwapStartDetailsAction

Source: https://api.playnite.link/docs/api/Playnite.SDK.IFullscreenSettingsAPI.html

Gets a value indicating whether the start and details actions are swapped in fullscreen mode.

```APIDOC
## SwapStartDetailsAction

### Description
Gets a value indicating whether the start and details actions are swapped in fullscreen mode.

### Property
- **SwapStartDetailsAction** (bool) - Read-only

### Property Value
- bool
```

--------------------------------

### Verify Extension Manifest

Source: https://api.playnite.link/docs/tutorials/toolbox.html

Use this command to verify extension manifests. Specify the manifest type ('addon' or 'installer') and the path to the manifest file. 'addon' type also verifies linked installer manifests.

```bash
Toolbox.exe verify <manifest_type> <manifest_path>
```

--------------------------------

### GetInstallActions Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Retrieves a list of install controllers for the plugin.

```APIDOC
## GetInstallActions(GetInstallActionsArgs)

### Parameters
* **args** (GetInstallActionsArgs)

### Returns
* **IEnumerable<InstallController>**
```

--------------------------------

### InstallationStatus

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Retrieves the current installation state of the game.

```APIDOC
## InstallationStatus

### Description
Gets game installation state.

### Property Value
InstallationStatus
```

--------------------------------

### On Application Started Event

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked when the Playnite application has started and completed its initialization.

```csharp
public virtual void OnApplicationStarted(OnApplicationStartedEventArgs args)__
```

--------------------------------

### OnGameStarting

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked just before a game is started.

```APIDOC
## OnGameStarting

### Description
Called before game is started.

### Method
POST (Assumed for event callbacks)

### Endpoint
(Not explicitly defined, assumed to be part of the plugin's API surface)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **args** (OnGameStartingEventArgs) - Event arguments containing information about the game about to start.

### Request Example
None

### Response
#### Success Response
None

#### Response Example
None
```

--------------------------------

### SwapStartDetailsAction Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.IFullscreenSettingsAPI.html

Gets a value indicating whether the Start and Details actions are swapped in fullscreen mode.

```csharp
bool SwapStartDetailsAction { get; }
```

--------------------------------

### Example: Create New PowerShell Script

Source: https://api.playnite.link/docs/tutorials/toolbox.html

This is an example of creating a new PowerShell script named 'Testing Script' in the 'd:\\somefolder' directory.

```bash
Toolbox.exe new PowerShellScript "Testing Script" "d:\\somefolder"
```

--------------------------------

### On Game Installation Cancelled Event

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked when a game installation process has been cancelled.

```csharp
public virtual void OnGameInstallationCancelled(OnGameInstallationCancelledEventArgs args)__
```

--------------------------------

### GameInstalledEventArgs InstalledInfo Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.GameInstalledEventArgs.html

Gets or sets the data for the newly installed game. This property holds GameInstallationData.

```csharp
public GameInstallationData InstalledInfo { get; set; }__
```

--------------------------------

### Start Application Before Game

Source: https://api.playnite.link/docs/manual/features/scriptingSupport/exampleScripts.html

Use this script to start an external application before a game launches. You can optionally minimize the application window.

```powershell
Start-Process -FilePath "c:\somepath\someapp.exe" -ArgumentList "-some arguments"
```

--------------------------------

### GameStartedScript

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the script to be executed after a game starts.

```APIDOC
## GameStartedScript

### Description
Gets or sets script to be executed after game started.

### Property Value
string
```

--------------------------------

### Localization Resource Dictionary Example

Source: https://api.playnite.link/docs/tutorials/themes/localizations.html

Example of a XAML ResourceDictionary file for localization. It defines default strings, including one that spans multiple lines.

```xml
<?xml version="1.0"?>
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:sys="clr-namespace:System;assembly=mscorlib">
    <sys:String x:Key="LOCTestThemeSomeString">Test string</sys:String>
    <sys:String x:Key="LOCTestThemeMultilineString" xml:space="preserve">Test string
on multiple lines</sys:String>
</ResourceDictionary>
```

--------------------------------

### Manual

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the game manual.

```APIDOC
## Manual

### Description
Gets or sets game manual.

### Property Value
string
```

--------------------------------

### Start External Backup

Source: https://api.playnite.link/docs/manual/library/backup.html

Initiates an external backup process using a specified configuration file. Ensure the configuration file contains the necessary properties for backup.

```command-line
Playnite.DesktopApp.exe --backup "c:\test\backup_config.json"
```

--------------------------------

### SourceId

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the GUID representing the source of the game.

```APIDOC
## Property: SourceId

### Description
Gets or sets source of the game.

### Property Value
Guid
```

--------------------------------

### Handle Game Started Event (C#)

Source: https://api.playnite.link/docs/tutorials/extensions/events.html

Override the OnGameStarted method in your C# plugin to log the name of the game that just started.

```csharp
public override void OnGameStarted(OnGameStartedEventArgs args)
{
    logger.Info($"Game started: {args.Game.Name}");
}
```

--------------------------------

### Start Application Only If Not Running

Source: https://api.playnite.link/docs/manual/features/scriptingSupport/exampleScripts.html

This script checks if an application is currently running using Get-Process. If it's not running, you can then combine it with the starting script from the previous example.

```powershell
if (!(Get-Process -Name "someapp" -EA 0))
{
    # Process is not running. Combine with previous section
}
else
{
    # Process is running. Combine with previous section
}
```

--------------------------------

### Create MetadataFile with Name, Data, and Original URL

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.MetadataFile.html

Demonstrates creating a MetadataFile instance with a file name, content, and the original source URL.

```csharp
public MetadataFile(string name, byte[] data, string originalUrl)__
```

--------------------------------

### OnGameStartingEventArgs

Source: https://api.playnite.link/docs/api/Playnite.SDK.Events.OnGameStartingEventArgs.html

Arguments for the game starting event.

```APIDOC
## Class OnGameStartingEventArgs

Namespace
    Playnite.SDK.Events

Assembly
    Playnite.SDK.dll

Represents arguments for the event when a game is starting.

### Properties

#### CancelStartup
Gets or sets value indicating whether game startup should be interrupted.

- **Type**: bool
- **Access**: public bool { get; set; }

#### Game
Gets game object initiating the event.

- **Type**: Game
- **Access**: public Game { get; }

#### SelectedRomFile
Gets ROM file selected when running a game with multiple ROMs assigned.

- **Type**: string
- **Access**: public string { get; }

#### SourceAction
Gets custom game action used to start the game.

- **Type**: GameAction
- **Access**: public GameAction { get; }
```

--------------------------------

### Script Extension Manifest Example

Source: https://api.playnite.link/docs/tutorials/extensions/extensionsManifest.html

Example of a YAML manifest file for a Playnite script extension. Ensure the Module property points to the correct script file.

```yaml
Id: LibraryExporter_Playnite_Script
Name: Library Exporter
Author: Playnite
Version: 1.0
Module: LibraryExporter.psm1
Type: Script
Links:
    - Name: Website
      Url: https://some.website.nowhere

```

--------------------------------

### StartGame

Source: https://api.playnite.link/docs/api/Playnite.SDK.IPlayniteAPI.html

Launches the specified game.

```APIDOC
## StartGame(Guid)

### Description
Starts the specified game.

### Method
```
void StartGame(Guid gameId)
```

### Parameters

- **gameId** (Guid) - The unique identifier of the game to start.
```

--------------------------------

### Create MetadataFile with Path

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.MetadataFile.html

Shows how to create a MetadataFile instance by providing the source path (URL, URI, or system path).

```csharp
public MetadataFile(string path)__
```

--------------------------------

### GameStartedScript Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the script to be executed after a game starts.

```csharp
public string GameStartedScript { get; set; }__
```

--------------------------------

### StartupArguments Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.EmulatorDefinitionProfile.html

Gets or sets the arguments to be passed to the emulator on startup.

```csharp
public string StartupArguments { get; set; }__
```

--------------------------------

### StartedProcessId Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.GameStartedEventArgs.html

Gets or sets the process ID of the started game.

```csharp
public int StartedProcessId { get; set; }__
```

--------------------------------

### OnGameStarted

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked when a game has started running.

```APIDOC
## OnGameStarted

### Description
Called when game has started.

### Method
POST (Assumed for event callbacks)

### Endpoint
(Not explicitly defined, assumed to be part of the plugin's API surface)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **args** (OnGameStartedEventArgs) - Event arguments containing information about the started game.

### Request Example
None

### Response
#### Success Response
None

#### Response Example
None
```

--------------------------------

### TrackingFrequency Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.GameAction.html

Gets or sets the delay in milliseconds before tracking starts.

```csharp
public int TrackingFrequency { get; set; }
```

--------------------------------

### Start Game

Source: https://api.playnite.link/docs/api/Playnite.SDK.IPlayniteAPI.html

Launches a game identified by its unique ID.

```csharp
void StartGame(Guid gameId)
```

--------------------------------

### InitialTrackingDelay Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.GameAction.html

Gets or sets the delay in milliseconds before tracking starts.

```csharp
public int InitialTrackingDelay { get; set; }
```

--------------------------------

### OnGameInstalled

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked when a game has been successfully installed.

```APIDOC
## OnGameInstalled

### Description
Called when game has been installed.

### Method
POST (Assumed for event callbacks)

### Endpoint
(Not explicitly defined, assumed to be part of the plugin's API surface)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **args** (OnGameInstalledEventArgs) - Event arguments containing information about the installed game.

### Request Example
None

### Response
#### Success Response
None

#### Response Example
None
```

--------------------------------

### SeriesIds

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a list of GUIDs representing the game series.

```APIDOC
## Property: SeriesIds

### Description
Gets or sets game series.

### Property Value
List<Guid>
```

--------------------------------

### Source Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets the source of the game.

```csharp
public GameSource Source { get; }__
```

--------------------------------

### Library Plugin Manifest Example

Source: https://api.playnite.link/docs/tutorials/extensions/extensionsManifest.html

Example of a YAML manifest file for a Playnite library plugin extension. The Icon property is optional and specifies a relative path to the extension's icon.

```yaml
Id: SomeLibraryPlugin_Playnite_Plugin
Name: Some Library Plugin
Author: Playnite
Version: 1.0
Module: SomeLibraryPlugin.dll
Type: GameLibrary
Icon: pluginicon.png
Links:
    - Name: Website
      Url: https://some.website.nowhere

```

--------------------------------

### InstallSizeGroup

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Retrieves the install size group for the game.

```APIDOC
## InstallSizeGroup

### Description
Gets game's install size group.

### Property Value
InstallSizeGroup
```

--------------------------------

### InstallController Constructor

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.InstallController.html

Initializes a new instance of the InstallController class. Requires a Game object to be passed.

```csharp
public InstallController(Game game)__
```

--------------------------------

### InitialTrackingDelay Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.AutomaticPlayController.html

Gets or sets delay in milliseconds before tracking actually starts.

```APIDOC
## InitialTrackingDelay

### Description
Gets or sets delay in milliseconds before tracking actually starts.

### Property Value
(int) - The delay in milliseconds.
```

--------------------------------

### Platform.Empty

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Platform.html

Gets the default empty platform instance.

```APIDOC
## Platform.Empty

### Description
Gets empty platform.

### Method
Field Accessor

### Endpoint
N/A

### Parameters
None

### Request Example
None

### Response
#### Success Response
- **Platform** (Platform) - The empty platform instance.
```

--------------------------------

### StartupExecutable Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.EmulatorDefinitionProfile.html

Gets or sets the path to the emulator's startup executable.

```csharp
public string StartupExecutable { get; set; }__
```

--------------------------------

### TagIds

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a list of GUIDs representing the tags associated with the game.

```APIDOC
## Property: TagIds

### Description
Gets or sets list of tags.

### Property Value
List<Guid>
```

--------------------------------

### InstallController Constructor

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.InstallController.html

Creates a new instance of the InstallController class, initializing it with a specific game.

```APIDOC
## InstallController(Game)

### Description
Creates new instance of InstallController.

### Parameters
#### game Game
- **game** (Game) - Description not available
```

--------------------------------

### ScriptStartup Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.EmulatorDefinitionProfile.html

Gets or sets a value indicating whether to use scripts for startup.

```csharp
public bool ScriptStartup { get; set; }__
```

--------------------------------

### RegionIds

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a list of GUIDs representing the game's regions.

```APIDOC
## Property: RegionIds

### Description
Gets or sets game region.

### Property Value
List<Guid>
```

--------------------------------

### Startup Script with Cancellation Handling

Source: https://api.playnite.link/docs/manual/features/scriptingSupport/startupScript.html

This script demonstrates how to handle user cancellation requests during a game session. It continuously checks for cancellation and process status, allowing for graceful exit.

```powershell
#WaitForExit() is synchronous check so it can't be used if you want to support session cancellation
$process = [System.Diagnostics.Process]::Start("game.exe")
while ($true)
{
    # Check if user cancelled game session
    if ($CancelToken.IsCancellationRequested)
    {
        break
    }

    # Check if process is still running
    if (!(Get-Process -Name "game" -EA 0))
    {
        break
    }

    # Sleep for a while to not waste CPU
    Start-Sleep -s 1
}

$process.Dispose()
```

--------------------------------

### PublisherIds

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a list of GUIDs representing the publishers associated with the game.

```APIDOC
## Property: PublisherIds

### Description
Gets or sets list of publishers.

### Property Value
List<Guid>
```

--------------------------------

### On Game Starting Event

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked just before a game is launched.

```csharp
public virtual void OnGameStarting(OnGameStartingEventArgs args)__
```

--------------------------------

### LastSizeScanDate

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the date of the last scan for the game's install size.

```APIDOC
## LastSizeScanDate

### Description
Gets or sets date of last date of install size scan made to a game.

### Property Value
DateTime?
```

--------------------------------

### LastSizeScanDate Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the date of the last install size scan for the game.

```csharp
public DateTime? LastSizeScanDate { get; set; }__
```

--------------------------------

### InstallationDirectory Variable

Source: https://api.playnite.link/docs/api/Playnite.SDK.ExpandableVariables.html

Represents the full path to the game's installation directory. Essential for accessing game files.

```csharp
public const string InstallationDirectory = "{InstallDir}"
```

--------------------------------

### Create MetadataFile with Name and Data

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.MetadataFile.html

Illustrates creating a MetadataFile by specifying the file name and its content as a byte array.

```csharp
public MetadataFile(string name, byte[] data)__
```

--------------------------------

### PreScript

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the pre-action script for a game. This script is executed before the game starts.

```APIDOC
## Property: PreScript

### Description
Gets or sets pre-action script.

### Property Value
string
```

--------------------------------

### Hint Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.SearchContext.html

Gets or sets the search hint.

```csharp
public string Hint { get; set; }
```

--------------------------------

### MetadataIdProperty Id Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.MetadataIdProperty.html

Gets the unique identifier (GUID) of the referenced database object.

```csharp
public Guid Id { get; }
```

--------------------------------

### OnApplicationStarted

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked when the application has started and completed its initialization.

```APIDOC
## OnApplicationStarted

### Description
Called when application is started and initialized.

### Method
POST (Assumed for event callbacks)

### Endpoint
(Not explicitly defined, assumed to be part of the plugin's API surface)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **args** (OnApplicationStartedEventArgs) - Event arguments containing information about the application start.

### Request Example
None

### Response
#### Success Response
None

#### Response Example
None
```

--------------------------------

### GetInstallActionsArgs Class

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.GetInstallActionsArgs.html

Represents the arguments passed when requesting installation actions. It contains a reference to the Game object for which the actions are being requested.

```APIDOC
## Class GetInstallActionsArgs

Namespace
    Playnite.SDK.Plugins

Assembly
    Playnite.SDK.dll

```csharp
public class GetInstallActionsArgs
```

### Properties

#### Game

```csharp
public Game Game { get; set; }
```

**Description:**
The Game object for which installation actions are being requested.

**Type:**
Game
```

--------------------------------

### CustomEmulatorProfile.Platforms Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.CustomEmulatorProfile.html

Gets or sets the platforms supported by the profile. This property is a List of Guids.

```csharp
public List<Guid> Platforms { get; set; }
```

--------------------------------

### GuideButtonFocus

Source: https://api.playnite.link/docs/api/Playnite.SDK.IFullscreenSettingsAPI.html

Gets a value indicating whether the guide button has focus in fullscreen mode.

```APIDOC
## GuideButtonFocus

### Description
Gets a value indicating whether the guide button has focus in fullscreen mode.

### Property
- **GuideButtonFocus** (bool) - Read-only

### Property Value
- bool
```

--------------------------------

### Get ID from Extension

Source: https://api.playnite.link/docs/api/Playnite.SDK.BuiltinExtensions.html

Determines the unique GUID for a given built-in extension object.

```csharp
public static Guid GetIdFromExtension(BuiltinExtension extension)
```

--------------------------------

### Implement Automatic Play Action

Source: https://api.playnite.link/docs/tutorials/extensions/gameActions.html

Use AutomaticPlayController to simplify play action handling when no special game startup logic is required. This example shows how to configure a 'Notepad' play action.

```csharp
public override IEnumerable<PlayController> GetPlayActions(GetPlayActionsArgs args)
{
    yield return new AutomaticPlayController(args.Game)
    {
        Type = GenericPlayActionType.File,
        TrackingMode = TrackingMode.Process,
        Name = "Notepad",
        Path = "notepad.exe"
    };
}
```

--------------------------------

### Create WebView with Settings

Source: https://api.playnite.link/docs/api/Playnite.SDK.IWebViewFactory.html

Creates a new standard web view instance with specified WebViewSettings. This method allows for detailed configuration of the web view.

```csharp
IWebView CreateView(WebViewSettings settings)
```

--------------------------------

### UseGlobalGameStartedScript

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a value indicating whether the global game started script should be executed.

```APIDOC
## Property: UseGlobalGameStartedScript

### Description
Gets or sets value indicating whether global pre script should be executed.

### Property Value
bool
```

--------------------------------

### Create New Desktop or Fullscreen Theme

Source: https://api.playnite.link/docs/tutorials/themes/usingBlend.html

Use this command to generate the basic file structure for a new desktop or fullscreen theme. Replace `<ThemeName>` with your desired theme's name.

```bash
Toolbox.exe new desktoptheme|fullscreentheme <ThemeName>
```

--------------------------------

### GuideButtonFocus Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.IFullscreenSettingsAPI.html

Gets a value indicating whether the Guide button has focus in fullscreen mode.

```csharp
bool GuideButtonFocus { get; }
```

--------------------------------

### Troubleshoot Start-Process Wildcard Issues

Source: https://api.playnite.link/docs/tutorials/extensions/scripting.html

Avoid issues with wildcard characters in paths when starting processes. Use .NET classes directly for literal path execution.

```powershell
# Instead of:
Start-Process "game.exe"

# call .NET class directly:
[System.Diagnostics.Process]::Start("game.exe")
```

--------------------------------

### Get Extension by ID

Source: https://api.playnite.link/docs/api/Playnite.SDK.BuiltinExtensions.html

Retrieves a specific built-in extension plugin using its unique GUID.

```csharp
public static BuiltinExtension GetExtensionFromId(Guid id)
```

--------------------------------

### Start External Restore

Source: https://api.playnite.link/docs/manual/library/backup.html

Initiates an external restore process using a specified configuration file. The configuration file must define the backup file and target directories for restoration.

```command-line
Playnite.DesktopApp.exe --restorebackup "c:\test\restore_config.json"
```

--------------------------------

### OverrideInstallState

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a value indicating whether to ignore the installation state set by an integration plugin.

```APIDOC
## OverrideInstallState

### Description
Gets or sets value indicating whether installation state set by integration plugin should be ignored.

### Property Value
bool
```

--------------------------------

### Open Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.IWebView.html

Opens the web view.

```csharp
void Open()
```

--------------------------------

### Example Library Plugin Implementation

Source: https://api.playnite.link/docs/tutorials/extensions/libraryPlugins.html

This C# code demonstrates a basic implementation of a Playnite library plugin, including setting unique IDs, names, and game metadata.

```csharp
public class LibraryPlugin : LibraryPlugin
{
    public override Guid Id { get; } = Guid.Parse("D625A3B7-1AA4-41CB-9CD7-74448D28E99B");

    public override string Name { get; } = "Test Library";

    public TestGameLibrary(IPlayniteAPI api) : base (api)
    {
        Properties = new LibraryPluginProperties
        {
            CanShutdownClient = true,
            HasSettings = true
        };
    }

    public override IEnumerable<GameMetadata> GetGames()
    {
        return new List<GameMetadata>()
        {
            new GameMetadata()
            {
                Name = "Some App",
                GameId = "some_app_id",
                GameActions = new List<GameAction>
                {
                    new GameAction
                    {
                        Type = GameActionType.File,
                        Path = "c:\\some_path\\app.exe",
                        IsPlayAction = true
                    }
                },
                IsInstalled = true,
                Icon = new MetadataFile(@"c:\\some_path\\app.exe")
            },
            new GameMetadata()
            {
                Name = "Calculator",
                GameId = "calc",
                GameActions = new List<GameAction>
                {
                    new GameAction
                    {
                        Type = GameActionType.File,
                        Path = "calc.exe",
                        IsPlayAction = true
                    }
                },
                IsInstalled = true,
                Icon = new MetadataFile(@"https://playnite.link/applogo.png"),
                BackgroundImage =  new MetadataFile(@"https://playnite.link/applogo.png")
            }
        };
    }
}
```

--------------------------------

### UseGlobalGameStartedScript Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a value indicating whether the global game started script should be executed.

```csharp
public bool UseGlobalGameStartedScript { get; set; }__
```

--------------------------------

### OverrideInstallState Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets a value indicating whether the installation state set by an integration plugin should be ignored.

```csharp
public bool OverrideInstallState { get; set; }__
```

--------------------------------

### Play Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.AutomaticPlayController.html

Overrides the Play method from the base class to handle game startup.

```csharp
public override void Play(PlayActionArgs args)
```

--------------------------------

### StartedProcessId Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Events.OnGameStartedEventArgs.html

Gets the process ID of the started game. This may not always be accurate depending on how the game was launched.

```csharp
public int StartedProcessId { get; }
```

--------------------------------

### GetInstallSize Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.OnDemandMetadataProvider.html

Retrieves the install size for a game. Requires GetMetadataFieldArgs to specify the context.

```csharp
public virtual ulong? GetInstallSize(GetMetadataFieldArgs args)__
```

--------------------------------

### Getting Active Filter Preset ID

Source: https://api.playnite.link/docs/api/Playnite.SDK.IMainViewAPI.html

Retrieves the unique identifier (Guid) of the currently active filter preset.

```csharp
Guid GetActiveFilterPreset()
```

--------------------------------

### InstallActionArgs Constructor

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.InstallActionArgs.html

Initializes a new instance of the InstallActionArgs class.

```APIDOC
## InstallActionArgs()

### Description
Initializes a new instance of the InstallActionArgs class.

### Method
InstallActionArgs()

### Parameters
None
```

--------------------------------

### Create and Show a Custom Window with XAML Content (PowerShell)

Source: https://api.playnite.link/docs/tutorials/extensions/windows.html

This PowerShell snippet demonstrates creating a custom window with content defined in XAML. It includes setting window properties, loading XAML content, setting the data context to selected games, and attaching a click event handler to a button within the XAML.

```powershell
$windowCreationOptions = New-Object Playnite.SDK.WindowCreationOptions
$windowCreationOptions.ShowMinimizeButton = $false

$window = $PlayniteApi.Dialogs.CreateWindow($windowCreationOptions);
$window.Height = 768;
$window.Width = 768;
$window.Title = "Some title";

# Set content of a window. Can be loaded from xaml, loaded from UserControl or created from code behind
[xml]$xaml = @"
<UserControl
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

    <UserControl.Resources>
        <Style TargetType="TextBlock" BasedOn="{StaticResource BaseTextBlockStyle}" />
    </UserControl.Resources>

    <StackPanel Margin="15,0,0,0">
        <StackPanel Orientation="Horizontal">
            <TextBlock Text="An example button:" Margin="0,0,15,0" VerticalAlignment="Center"/>
            <Button x:Name="MyButton" Content="Click me!"/>
        </StackPanel>
        <TextBlock Text="Currently selected games:" Margin="0,15,0,0"/>
        <ItemsControl ItemsSource="{Binding}">
            <ItemsControl.ItemTemplate>
                <DataTemplate>
                    <TextBlock Text="{Binding Path=Name}" Margin="15,0,0,0"
                        Style="{StaticResource BaseTextBlockStyle}"/>
                </DataTemplate>
            </ItemsControl.ItemTemplate>
        </ItemsControl>
        <StackPanel Orientation="Horizontal" Margin="0,15,0,0">
            <TextBlock Text="Total selected games: "/>
            <TextBlock Text="{Binding .Count}"/>
        </StackPanel>
    </StackPanel>
</UserControl>
"@
$reader = [System.Xml.XmlNodeReader]::new($xaml)
$window.Content = [Windows.Markup.XamlReader]::Load($reader)

# Set data context if you want to use MVVM pattern
$window.DataContext = $PlayniteApi.MainView.SelectedGames

# Attach a click event handler
$button = $window.Content.FindName("MyButton")
$button.Add_Click({
    $button.Content = "Clicked"
})

# Set owner if you need to create modal dialog window
$window.Owner = $PlayniteApi.Dialogs.GetCurrentAppWindow();
$window.WindowStartupLocation = "CenterOwner";

# Use Show or ShowDialog to show the window
$window.ShowDialog();
```

--------------------------------

### Get Playnite Application Path

Source: https://api.playnite.link/docs/api/Playnite.SDK.IPlaynitePathsAPI.html

Retrieves the main installation directory of Playnite. Use this to access core Playnite files.

```csharp
string ApplicationPath { get; }
```

--------------------------------

### SelectFolder with initial directory

Source: https://api.playnite.link/docs/api/Playnite.SDK.IDialogsFactory.html

Displays a system dialog for folder selection, starting in a specified directory. The user can choose a folder, and the path is returned.

```APIDOC
## SelectFolder(string initialDir)

### Description
Displays a system dialog for folder selection, starting in a specified directory. The user can choose a folder, and the path is returned.

### Method Signature
`string SelectFolder(string initialDir)`

### Parameters
#### Path Parameters
- **initialDir** (string) - Description: The initial directory to open the dialog in.

### Returns
- **string** - The path of the selected folder, or an empty string if the user cancels the dialog.
```

--------------------------------

### this[Guid id]

Source: https://api.playnite.link/docs/api/Playnite.SDK.IItemCollection-1.html

Gets or sets an item from the collection by its unique identifier. Returns null if no item with the specified ID is found.

```APIDOC
## this[Guid id]

### Description
Gets or sets item from collection.

### Property
- **this[Guid id]** (TItem) - Gets or sets the item with the specified ID.

#### Parameters
* **id** (Guid) - Required - The unique identifier of the item to retrieve or set.

#### Property Value
- **TItem** - Returns the item if found, otherwise returns `null`.
```

--------------------------------

### Create MetadataFile Instance

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.MetadataFile.html

Demonstrates creating a new instance of the MetadataFile class. This constructor initializes an empty MetadataFile object.

```csharp
public MetadataFile()__
```

--------------------------------

### GetLocalized String Extension Method

Source: https://api.playnite.link/docs/api/System.StrExtensions.html

Use this extension method to get the localized version of a string key. The key must start with 'LOC'.

```csharp
public static string GetLocalized(this string stringKey)
    {
        // Implementation details omitted for brevity
        return stringKey;
    }
```

--------------------------------

### Get Clone

Source: https://api.playnite.link/docs/api/Playnite.SDK.IItemCollection-1.html

Gets a clone of the entire collection.

```APIDOC
## GetClone()

### Description
Gets a clone of the collection.

### Method
GET

### Endpoint
/items/clone

### Response
#### Success Response (200)
- **IEnumerable<TItem>** - A clone of the collection.
```

--------------------------------

### CustomEmulatorProfile.StartupScript Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.CustomEmulatorProfile.html

Gets the startup script for the emulator. This property is of type string.

```csharp
public string StartupScript { get; set; }
```

--------------------------------

### InstallationStatus Enum

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.InstallationStatus.html

Represents the installation status of a game. It can be either Installed or Uninstalled.

```APIDOC
## Enum InstallationStatus

Namespace
    Playnite.SDK.Models 

Assembly
    Playnite.SDK.dll
Represents game installation status.
```csharp
public enum InstallationStatus
```

## Fields 

`Installed = 0`
    
Game is installed. 

`Uninstalled = 1`
    
Game is not installed. 

```

--------------------------------

### Create New Plugin Extension

Source: https://api.playnite.link/docs/tutorials/toolbox.html

Use this command to create a new plugin extension. Specify the plugin type (e.g., GenericPlugin, MetadataPlugin, LibraryPlugin), the plugin name, and the target folder for creation.

```bash
Toolbox.exe new <plugintype> <pluginname> <targetfolder>
```

--------------------------------

### InstallationStatus Enum Definition

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.InstallationStatus.html

Defines the possible installation states for a game: Installed or Uninstalled.

```csharp
public enum InstallationStatus__
```

--------------------------------

### InstallationDirName Variable

Source: https://api.playnite.link/docs/api/Playnite.SDK.ExpandableVariables.html

Represents the name of the game's installation directory. Useful for referencing the directory by name.

```csharp
public const string InstallationDirName = "{InstallDirName}"
```

--------------------------------

### Request Method Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.WebViewModels.Request.html

Gets or sets the HTTP method (e.g., GET, POST) of the request.

```csharp
public string Method { get; set; }
```

--------------------------------

### InstallActionArgs Constructor

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.InstallActionArgs.html

Initializes a new instance of the InstallActionArgs class. This is the default constructor.

```csharp
public InstallActionArgs()
```

--------------------------------

### Create New Theme Extension

Source: https://api.playnite.link/docs/tutorials/toolbox.html

Use this command to create a new theme extension. Specify the theme type (DesktopTheme or FullscreenTheme) and the desired theme name.

```bash
Toolbox.exe new <themetype> <themename>
```

--------------------------------

### Example Extension Directory Structure

Source: https://api.playnite.link/docs/tutorials/extensions/intro.html

Illustrates the expected folder structure for a Playnite extension, including the manifest file and the script or plugin file.

```yaml
├──Install directory or %AppData%\Playnite
│  └── Extensions
│      └── ExtensionFolder
│          ├── extension.yaml
│          └── scriptFileName.psm1 or pluginFileName.dll
```

--------------------------------

### GameStartedEventArgs

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.GameStartedEventArgs.html

Represents arguments for the game started event, containing the process ID of the started game.

```APIDOC
## Class GameStartedEventArgs

Namespace
    Playnite.SDK.Plugins

Assembly
    Playnite.SDK.dll

Represents arguments for game started event.

```csharp
public class GameStartedEventArgs
```

## Constructors
### GameStartedEventArgs()

Initializes a new instance of the `GameStartedEventArgs` class.

```csharp
public GameStartedEventArgs()
```

## Properties
### StartedProcessId

Gets or sets the process ID of the started game.

#### Property Value

`int`

```csharp
public int StartedProcessId { get; set; }
```
```

--------------------------------

### IdItemFilterItemProperties Constructor (Guid)

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.IdItemFilterItemProperties.html

Creates a new instance of the IdItemFilterItemProperties class with a single GUID to filter by.

```csharp
public IdItemFilterItemProperties(Guid id)__
```

--------------------------------

### Platform Constructor (with Name)

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Platform.html

Creates a new instance of the Platform class with a specified name.

```csharp
public Platform(string name)__
```

--------------------------------

### Platform Constructor (Default)

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Platform.html

Creates a new instance of the Platform class.

```csharp
public Platform()__
```

--------------------------------

### GetInstallDrive

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Retrieves the drive where the game is installed. This is useful for managing game installations across different drives.

```APIDOC
## GetInstallDrive()

### Description
Gets game Install Drive.

### Method Signature
public string GetInstallDrive()

### Returns
string - The drive letter where the game is installed.
```

--------------------------------

### IdItemFilterItemProperties Constructor (List<Guid>)

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.IdItemFilterItemProperties.html

Creates a new instance of the IdItemFilterItemProperties class with a list of GUIDs to filter by.

```csharp
public IdItemFilterItemProperties(List<Guid> ids)__
```

--------------------------------

### Publisher Constructor with Name

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Publisher.html

Creates a new instance of the Publisher class, initializing it with a provided name.

```csharp
public Publisher(string name)__
```

--------------------------------

### Play Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.AutomaticPlayController.html

Initiates the play action with the provided arguments.

```APIDOC
## Play(PlayActionArgs)

### Description
Initiates the play action with the provided arguments.

### Parameters
- **args** (PlayActionArgs) - The arguments for the play action.
```

--------------------------------

### GetInstallDriveGroup

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Retrieves the drive group for the game's installation. This can be used for categorizing or organizing games based on their installation location.

```APIDOC
## GetInstallDriveGroup()

### Description
Gets game Install Drive group.

### Method Signature
public string GetInstallDriveGroup()

### Returns
string - The drive group identifier for the game installation.
```

--------------------------------

### CreateWindow

Source: https://api.playnite.link/docs/api/Playnite.SDK.IDialogsFactory.html

Creates a new window with Playnite's default styling applied.

```APIDOC
## CreateWindow (WindowCreationOptions)

### Description
Creates new window with Playnite's default styling applied.

### Method Signature
```csharp
Window CreateWindow(WindowCreationOptions options)
```

### Parameters
#### options
- **Type**: WindowCreationOptions
- **Description**: Custom window options.

### Returns
- **Type**: Window
- **Description**: New window instance.
```

--------------------------------

### LibraryClient Open Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.LibraryClient.html

Abstract method to open the client application. Derived classes must provide the implementation to launch the client.

```csharp
public abstract void Open()
```

--------------------------------

### ApplyFilterPreset(Guid)

Source: https://api.playnite.link/docs/api/Playnite.SDK.IMainViewAPI.html

Applies a filter preset identified by its unique ID. Use this method to activate a specific filter configuration using its GUID.

```APIDOC
## Method ApplyFilterPreset(Guid)

### Description
Applies filter preset.

### Parameters
#### Path Parameters
- **filterId** (Guid) - Required - Filter ID.
```

--------------------------------

### Manual Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the game's manual content.

```csharp
public string Manual { get; set; }__
```

--------------------------------

### Configure Supported File Types

Source: https://api.playnite.link/docs/manual/features/emulationSupport/addingNewEmulators.html

List supported file types separated by commas, without periods or spaces. This example includes common GBA ROM formats.

```text
gba,zip,7z,elf,agb,mb,rom,bin
```

--------------------------------

### Select Folder with Initial Directory

Source: https://api.playnite.link/docs/api/Playnite.SDK.IDialogsFactory.html

Displays a system dialog for folder selection, starting in a specified directory. Returns the selected folder path.

```csharp
string SelectFolder(string initialDir)__
```

--------------------------------

### GetSettings Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Retrieves the plugin's settings, or null if none are provided.

```csharp
public virtual ISettings GetSettings(bool firstRunSettings)__
```

--------------------------------

### Detect Plugin Installation Status

Source: https://api.playnite.link/docs/tutorials/themes/extensionIntegration.html

Use PluginStatus markup to conditionally apply properties based on whether a plugin is installed. It returns a boolean or can be used directly with Visibility properties.

```xaml
<SomeElement Property="{PluginStatus Plugin=AddonId, Status=Installed}" />
```

--------------------------------

### SearchItem Constructor with Name, Primary Action Name, Action, and Icon

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.SearchItem.html

Creates a new instance of SearchItem with all parameters: name, primary action name, primary action delegate, and an icon.

```csharp
public SearchItem(string name, string primaryActionName, Action primaryAction, object icon)
```

--------------------------------

### Developer Constructor with Name

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Developer.html

Creates a new instance of the Developer class, initializing it with a provided name.

```csharp
public Developer(string name)__
```

--------------------------------

### Version

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets or sets the version of the game.

```APIDOC
## Property: Version

### Description
Gets or sets game version.

### Property Value
string
```

--------------------------------

### GameInstalledEventArgs Constructor (With Data)

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.GameInstalledEventArgs.html

Initializes a new instance of the GameInstalledEventArgs class with specified game installation data.

```csharp
public GameInstalledEventArgs(GameInstallationData installData)__
```

--------------------------------

### ReleaseYear

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Game.html

Gets the release year of the game.

```APIDOC
## Property: ReleaseYear

### Description
Gets game's release year.

### Property Value
int?
```

--------------------------------

### Properties Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.LibraryPlugin.html

Gets the properties of the plugin.

```APIDOC
## Properties Property

### Description
Gets plugin's properties.

### Property Value
LibraryPluginProperties
```

--------------------------------

### Init(ILogProvider) Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.LogManager.html

Initializes the LogManager with a custom ILogProvider. This method should be called early in the application lifecycle to set up the logging infrastructure.

```csharp
public static void Init(ILogProvider manager)__
```

--------------------------------

### Platform.Icon

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Platform.html

Gets or sets the platform icon.

```APIDOC
## Platform.Icon

### Description
Gets or sets platform icon.

### Method
Property Accessor

### Endpoint
N/A

### Parameters
None

### Request Example
None

### Response
#### Success Response
- **Icon** (string) - The platform icon.
```

--------------------------------

### Select Icon File with Initial Directory

Source: https://api.playnite.link/docs/api/Playnite.SDK.IDialogsFactory.html

Displays a file open dialog filtered for icon image files, starting in a specified directory. Returns the selected icon file path.

```csharp
string SelectIconFile(string initialDir)__
```

--------------------------------

### MetadataSpecProperty.Id Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.MetadataSpecProperty.html

Gets the ID of the specification.

```APIDOC
## Id

### Description
Gets specification id.

### Property Value
- **Id** (string) - The specification ID.
```

--------------------------------

### InvokeOnInstalled Method

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.InstallController.html

Protected method to signal that the installation has been completed successfully.

```APIDOC
## InvokeOnInstalled(GameInstalledEventArgs)

### Description
Invoke to signal that installation completed.

### Parameters
#### args GameInstalledEventArgs
- **args** (GameInstalledEventArgs) - Description not available
```

--------------------------------

### SearchItem Constructor with Name, Primary Action Name, and Action

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.SearchItem.html

Creates a new instance of SearchItem using a name, the name of the primary action, and the primary action itself.

```csharp
public SearchItem(string name, string primaryActionName, Action primaryAction)
```

--------------------------------

### GameRom Constructor with Name and Path

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.GameRom.html

Creates a new instance of GameRom with a specified name and path.

```csharp
public GameRom(string name, string path)
```

--------------------------------

### ApplicationPath

Source: https://api.playnite.link/docs/api/Playnite.SDK.IPlaynitePathsAPI.html

Retrieves the installation path of the Playnite application.

```APIDOC
## ApplicationPath

### Description
Gets Playnite's installation path.

### Property Value
string
```

--------------------------------

### On Game Startup Cancelled Event

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Callback method invoked when the startup process for a game has been cancelled.

```csharp
public virtual void OnGameStartupCancelled(OnGameStartupCancelledEventArgs args)__
```

--------------------------------

### OnGameStartupCancelledEventArgs

Source: https://api.playnite.link/docs/api/Playnite.SDK.Events.html

Represents arguments for the event when a game is installed.

```APIDOC
## Class OnGameStartupCancelledEventArgs

### Description
Represents arguments for the event when a game is installed.

### Class
Playnite.SDK.Events.OnGameStartupCancelledEventArgs
```

--------------------------------

### Platform(string name) Constructor

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Platform.html

Creates a new instance of the Platform class with a specific name.

```APIDOC
## Platform(string name)

### Description
Creates new instance of Platform with specific name.

### Method
Constructor

### Endpoint
N/A

### Parameters
#### Path Parameters
- **name** (string) - Required - Platform name.

### Request Example
None

### Response
#### Success Response
- **Platform** (Platform) - A new instance of the Platform class with the specified name.
```

--------------------------------

### OnGameInstalledEventArgs

Source: https://api.playnite.link/docs/api/Playnite.SDK.Events.html

Represents arguments for the event when a game is installed.

```APIDOC
## Class OnGameInstalledEventArgs

### Description
Represents arguments for the event when a game is installed.

### Class
Playnite.SDK.Events.OnGameInstalledEventArgs
```

--------------------------------

### Create and Show a Custom Window (C#)

Source: https://api.playnite.link/docs/tutorials/extensions/windows.html

Use this snippet to create a basic custom window in C#. You can set properties like height, width, title, content, and data context. The window is displayed using `ShowDialog()`.

```csharp
var window = PlayniteApi.Dialogs.CreateWindow(new WindowCreationOptions
{
    ShowMinimizeButton = false
});

window.Height = 1024;
window.Width = 768;
window.Title = "Some title";

// Set content of a window. Can be loaded from xaml, loaded from UserControl or created from code behind
window.Content = 

// Set data context if you want to use MVVM pattern
window.DataContext = 

// Set owner if you need to create modal dialog window
window.Owner = PlayniteApi.Dialogs.GetCurrentAppWindow();
window.WindowStartupLocation = WindowStartupLocation.CenterOwner;

// Use Show or ShowDialog to show the window
window.ShowDialog();
```

--------------------------------

### Id Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.Plugin.html

Gets the unique identifier for the plugin.

```APIDOC
## Id

### Description
Gets unique object identifier.

### Property Value
* **Id** (Guid)
```

--------------------------------

### WindowWidth Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.WebViewSettings.html

Gets or sets the window width.

```csharp
public int WindowWidth { get; set; }
```

--------------------------------

### WindowHeight Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.WebViewSettings.html

Gets or sets the window height.

```csharp
public int WindowHeight { get; set; }
```

--------------------------------

### ImageFileOption Constructor with Path

Source: https://api.playnite.link/docs/api/Playnite.SDK.ImageFileOption.html

Creates a new instance of the ImageFileOption class, initializing it with a specified image path.

```csharp
public ImageFileOption(string path)__
```

--------------------------------

### Label Property

Source: https://api.playnite.link/docs/api/Playnite.SDK.Plugins.SearchContext.html

Gets or sets the search label.

```csharp
public string Label { get; set; }
```

--------------------------------

### Configure Emulator Arguments

Source: https://api.playnite.link/docs/manual/features/emulationSupport/addingNewEmulators.html

Use this format for emulator arguments, replacing `{ImagePath}` with the game file path. Refer to emulator documentation for specific arguments and game variables.

```text
mgba -f "{ImagePath}"
```

--------------------------------

### Emulator Constructors

Source: https://api.playnite.link/docs/api/Playnite.SDK.Models.Emulator.html

Provides information on how to create new instances of the Emulator class.

```APIDOC
## Emulator()

### Description
Creates a new instance of the Emulator class.

### Method
Constructor

### Parameters
None

## Emulator(string name)

### Description
Creates a new instance of the Emulator class with a specific name.

### Method
Constructor

### Parameters
#### Path Parameters
- **name** (string) - Required - The name of the emulator.
```