PoshSonarr.psd1

#
# Module manifest for module 'PoshSonarr'
#
# Generated by: Mike Garvey
#
# Generated on: 2026-11-16
#

@{

# Script module or binary module file associated with this manifest.
RootModule = 'MG.Sonarr.Next.Shell.dll'

# Version number of this module.
ModuleVersion = '3.0.0'

# Supported PSEditions
CompatiblePSEditions = 'Core'

# ID used to uniquely identify this module
GUID = '0cd92751-7c76-4b31-ae4a-48d344f9b786'

# Author of this module
Author = 'Mike Garvey'

# Company or vendor of this module
CompanyName = 'Yevrag35, LLC.'

# Copyright statement for this module
Copyright = 'Copyright (c) 2018-2026 Yevrag35, LLC.'

# Description of the functionality provided by this module
Description = 'A PowerShell module for querying and managing Sonarr PVR through its APIs.'

# Minimum version of the PowerShell engine required by this module
PowerShellVersion = '7.7'

# Name of the PowerShell host required by this module
# PowerShellHostName = ''

# Minimum version of the PowerShell host required by this module
# PowerShellHostVersion = ''

# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
# DotNetFrameworkVersion = ''

# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
# ClrVersion = ''

# Processor architecture (None, X86, Amd64) required by this module
# ProcessorArchitecture = ''

# Modules that must be imported into the global environment prior to importing this module
# RequiredModules = @()

# Assemblies that must be loaded prior to importing this module
# RequiredAssemblies = @()

# Script files (.ps1) that are run in the caller's environment prior to importing this module.
# ScriptsToProcess = @()

# Type files (.ps1xml) to be loaded when importing this module
TypesToProcess = 'PSTypes\SonarrObjects.Type.ps1xml'

# Format files (.ps1xml) to be loaded when importing this module
FormatsToProcess = 'PSFormats\EpisodeObject.Format.ps1xml', 
               'PSFormats\MetadataTag.Format.ps1xml', 
               'PSFormats\RenameObject.Format.ps1xml', 
               'PSFormats\SeriesObject.Format.ps1xml', 
               'PSFormats\SonarrProperty.Format.ps1xml', 
               'PSFormats\SonarrTag.Format.ps1xml', 
               'PSFormats\SystemStatus.Format.ps1xml'

# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
# NestedModules = @()

# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
FunctionsToExport = @()

# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
CmdletsToExport = 'Add-SonarrRelease', 'Add-SonarrSeries', 'Add-SonarrTag', 
               'Clear-SonarrTag', 'Connect-SonarrInstance', 
               'Disconnect-SonarrInstance', 'Edit-SonarrManualImport', 
               'Get-SonarrBackup', 'Get-SonarrCalendar', 'Get-SonarrCommand', 
               'Get-SonarrCommandHistory', 'Get-SonarrDelayProfile', 
               'Get-SonarrDiskspace', 'Get-SonarrDownloadClient', 
               'Get-SonarrDownloadClientConfig', 'Get-SonarrDownloadClientSchema', 
               'Get-SonarrEpisode', 'Get-SonarrEpisodeFile', 'Get-SonarrHistory', 
               'Get-SonarrHostConfig', 'Get-SonarrIndexer', 
               'Get-SonarrLanguageProfile', 'Get-SonarrLog', 'Get-SonarrLogFile', 
               'Get-SonarrManualImport', 'Get-SonarrMediaManagement', 
               'Get-SonarrNamingConfig', 'Get-SonarrNotification', 
               'Get-SonarrNotificationSchema', 'Get-SonarrObjectProperty', 
               'Get-SonarrQualityDefinition', 'Get-SonarrQualityProfile', 
               'Get-SonarrReleaseProfile', 'Get-SonarrRemotePathMapping', 
               'Get-SonarrRootFolder', 'Get-SonarrSeries', 'Get-SonarrStatus', 
               'Get-SonarrTag', 'Get-SonarrWantedMissing', 
               'Invoke-SonarrManualImport', 'Invoke-SonarrRename', 
               'Invoke-SonarrRssSync', 'New-SonarrDelayProfile', 
               'New-SonarrDownloadClient', 'New-SonarrReleaseProfile', 
               'New-SonarrRemotePathMapping', 'New-SonarrRootFolder', 
               'New-SonarrTag', 'Remove-SonarrBackup', 'Remove-SonarrDelayProfile', 
               'Remove-SonarrDownloadClient', 'Remove-SonarrEpisodeFile', 
               'Remove-SonarrIndexer', 'Remove-SonarrNotification', 
               'Remove-SonarrReleaseProfile', 'Remove-SonarrRemotePathMapping', 
               'Remove-SonarrRootFolder', 'Remove-SonarrSeries', 'Remove-SonarrTag', 
               'Rename-SonarrTag', 'Restart-SonarrInstance', 'Save-SonarrBackup', 
               'Save-SonarrLogFile', 'Search-SonarrRelease', 'Search-SonarrSeries', 
               'Show-SonarrException', 'Test-SonarrHost', 'Test-SonarrRename', 
               'Test-SonarrResource', 'Update-SonarrDelayProfile', 
               'Update-SonarrDownloadClient', 'Update-SonarrEpisode', 
               'Update-SonarrHostConfig', 'Update-SonarrIndexer', 
               'Update-SonarrMediaManagement', 'Update-SonarrNamingConfig', 
               'Update-SonarrNotification', 'Update-SonarrReleaseProfile', 
               'Update-SonarrRemotePathMapping', 'Update-SonarrSeries'

# Variables to export from this module
# VariablesToExport = @()

# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
AliasesToExport = 'Connect-Sonarr', 'Delete-SonarrBackup', 'Delete-SonarrEpisodeFile', 
               'Delete-SonarrSeries', 'Delete-SonarrTag', 'Disconnect-Sonarr', 
               'Download-SonarrBackup', 'Download-SonarrLogFile', 'Get-SonarrHost', 
               'Get-SonarrObjectProperties', 'Get-SonarrProfile', 
               'Get-SonarrProperties', 'Get-SonarrQuality', 
               'Get-SonarrRemoteMapping', 'Get-SonarrRemotePath', 
               'New-SonarrRemoteMapping', 'New-SonarrRemotePath', 
               'Rename-SonarrEpisodeFile', 'Restart-Sonarr', 'Set-SonarrHost', 
               'Set-SonarrHostConfig', 'Set-SonarrIndexer', 
               'Set-SonarrRemoteMapping', 'Set-SonarrRemotePathMapping', 
               'Set-SonarrSeries', 'Show-SonarrError', 'Test-Sonarr', 
               'Update-SonarrHost', 'Update-SonarrRemoteMapping'

# DSC resources to export from this module
# DscResourcesToExport = @()

# List of all modules packaged with this module
# ModuleList = @()

# List of all files packaged with this module
# FileList = @()

# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
PrivateData = @{

    PSData = @{

        # Tags applied to this module. These help with module discovery in online galleries.
        Tags = 'Anime', 'Api', 'Backup', 'Calendar', 'Connect', 'dll', 'Episode', 'Json', '.NET', 
               'Manage', 'PVR', 'Quality', 'Rss', 'Series', 'Sonarr', 'Status', 'Sync', 
               'Website', 'automation'

        # A URL to the license for this module.
        LicenseUri = 'https://raw.githubusercontent.com/Yevrag35/PoshSonarr/master/LICENSE'

        # A URL to the main website for this project.
        ProjectUri = 'https://github.com/Yevrag35/PoshSonarr'

        # A URL to an icon representing this module.
        IconUri = 'https://raw.githubusercontent.com/Yevrag35/PoshSonarr/refs/heads/master/.img/PoshSonarr.png'

        # ReleaseNotes of this module
        ReleaseNotes = 'PoshSonarr 3.0.0

Breaking Changes
- Raise the minimum PowerShell version from 7.5 to 7.7, the first release on .NET 11
- Write each error when it happens instead of only the last one when the cmdlet ends, so -ErrorAction Stop ends the statement at the step that failed
- Stop a cmdlet whose setup fails instead of going on to its input
- Move CmdletScopeNotReadyException, ContextNotSetException, InvalidApiKeyException, and SonarrParameterException from MG.Sonarr.Next.Shell.Exceptions to MG.Sonarr.Next.Exceptions.Shell
- Move InvalidEpisodeIdFormatException from MG.Sonarr.Next.Shell.Exceptions to MG.Sonarr.Next.Exceptions
- Make Get-SonarrHistory -EventType take an event type''s name or number, and reject one it doesn''t know when it binds instead of returning every event
- Return a history record''s Data as the strings that Sonarr sends for the event, instead of a release object
- Change the type name of Get-SonarrDiskspace''s objects from MG.Sonarr.Next.Models.System.Diskspace to MG.Sonarr.Next.Models.System.DiskspaceObject
- Remove the naming settings'' SeparatorLength property, which was always 0

Connection Updates and Fixes
- Add Test-SonarrHost (Test-Sonarr) to check a URL and API key the way Connect-SonarrInstance does, without changing the current connection
- Write the server''s status from Test-SonarrHost, or $true or $false with -Quiet, and support -NoApiInPath, -SkipCertificateCheck, and -Timeout
- Replace the current connection in Connect-SonarrInstance, so a new URL or key takes effect and a wrong one fails even while connected
- Report a wrong API key as a 401 error, with or without -PassThru, instead of a JSON parse error
- Fix the URL base of a -Url such as https://host/sonarr being left out of requests, the forms login, and downloads
- Fix a SecureString API key not working on Linux and macOS
- Validate Connect-SonarrInstance -Timeout when it binds, allowing more than zero and up to about 24.8 days
- Fix Disconnect-SonarrInstance throwing a NullReferenceException when there''s no connection

General Cmdlet Updates and Fixes
- Make -Force skip only confirmation prompts, so -WhatIf always wins
- Fix -Force -WhatIf running Remove-SonarrDelayProfile, Remove-SonarrDownloadClient, Remove-SonarrIndexer, Remove-SonarrNotification, Remove-SonarrReleaseProfile, Remove-SonarrRemotePathMapping, Remove-SonarrRootFolder, Remove-SonarrTag, Restart-SonarrInstance, and Update-SonarrMediaManagement
- Support -WhatIf and -Confirm in Invoke-SonarrRename with -SeriesId or -EpisodeFileId, Invoke-SonarrRssSync, and Save-SonarrBackup
- Report a request that can''t reach the server as ConnectionError, with the URL in the message, and one that times out as OperationTimeout, from every cmdlet
- Cancel a request in flight when the pipeline stops, such as with Ctrl+C
- Show Sonarr''s messages for its validation errors instead of a JSON error or no detail
- Fix search terms and paths that contain &, #, or +, such as Search-SonarrSeries ''Law & Order'' searching for ''Law ''
- Honor preference variables that a script or function sets to a string, such as $ErrorActionPreference = ''Stop''
- Show the body of every request that has one with -Debug
- Fix requests deadlocking in a host whose pipeline thread has a single-threaded synchronization context
- Make Show-SonarrException find the newest Sonarr error in $Error, including one that ended a statement under -ErrorAction Stop
- Fix Add-SonarrTag, Clear-SonarrTag, Get-SonarrEpisode, Get-SonarrEpisodeFile, Get-SonarrQualityProfile, Get-SonarrTag, and Remove-SonarrTag skipping every piped input when one fails to bind or another command writes an error

Series and Episode Updates and Fixes
- Fix Get-SonarrSeries writing earlier piped objects'' series again with each new object
- Fix Add-SonarrSeries -SearchForMissingEpisodes IgnoreWithoutEpisodes also leaving episodes that have files unmonitored
- Fix Remove-SonarrSeries -DeleteFiles not deleting the series'' files
- Write a warning that names the series, instead of an error, when Remove-SonarrSeries can''t find it in Sonarr 4
- Accept S00 for specials, ranges of specials such as S00E01-02, and absolute ranges such as E25-28 in episode identifiers
- Reject an episode identifier that can''t be read, such as S01Ex or 10E05, with an error that names it, instead of taking it for the whole season or another episode
- Continue to the next piped series after a failed request in Get-SonarrEpisode and Get-SonarrEpisodeFile
- Fix Get-SonarrEpisodeFile sending its request only the first time it runs
- Use a piped episode''s file ID in Get-SonarrEpisodeFile and Remove-SonarrEpisodeFile, and warn about an episode or calendar entry that has no file
- Fix Update-SonarrEpisode sending an air date of 0001-01-01 for an episode that has none
- Fix Get-SonarrCalendar returning every entry when -Tags matches no tag
- Use the local air day instead of the UTC one for Get-SonarrCalendar -DayOfWeek
- Fix Get-SonarrWantedMissing ignoring -PageNumber
- Fix Add-SonarrRelease writing an error when it succeeds and Sonarr''s response when it fails
- Fix Add-SonarrRelease sending an empty guid for a release whose guid looks like a number or a GUID
- Fix Edit-SonarrManualImport not binding an ID or an object to -Series, -Episode, and -Quality
- Fix Get-SonarrManualImport changing a path that''s absolute on Linux, macOS, or Windows

Tag, Profile, and Notification Updates and Fixes
- Allow -Id with piped objects in Add-SonarrTag and Clear-SonarrTag
- Accept series lookup results and schemas in Add-SonarrTag, Clear-SonarrTag, and Get-SonarrTag
- Fix Add-SonarrTag changing a notification''s tags only in PowerShell instead of saving them to Sonarr
- Fix Get-SonarrTag listing no tags when given no arguments
- Fix New-SonarrDelayProfile -Protocol PreferUsenet or PreferTorrent enabling only the preferred protocol
- Stop New-SonarrDelayProfile and New-SonarrReleaseProfile with an error when a tag name matches no tag, instead of creating the profile without it
- Stop New-SonarrReleaseProfile with an error when -Indexer matches no indexer, instead of creating the profile for every indexer
- Accept (Any) in New-SonarrReleaseProfile -Indexer for any indexer
- Fix Get-SonarrReleaseProfile ignoring the names it''s given along with IDs
- Fix Update-SonarrNotification failing on every run
- Make a notification''s IsEnabled true when any of its triggers is on, including triggers that later Sonarr versions add

System and Settings Updates and Fixes
- Fix Save-SonarrBackup and Invoke-SonarrRssSync failing before sending a request
- Fix Save-SonarrBackup and Save-SonarrLogFile logging in with -Credential only after Connect-SonarrInstance -PassThru
- Keep a DOMAIN\user or user@host name whole when Save-SonarrBackup and Save-SonarrLogFile log in
- Log in again when Sonarr ends the session during a download
- Fail with an error, instead of saving the page as the file, when Sonarr answers a download with an error or its login page
- Write a download''s connection and file errors as errors instead of throwing them
- Honor -Verbose and -Debug in Save-SonarrBackup and Save-SonarrLogFile
- Count a failed or aborted command as finished in Get-SonarrCommandHistory
- Fix New-SonarrRootFolder changing a path that''s absolute on Linux or Windows, such as /tv becoming C:\tv from Windows
- Write the new root folder object from New-SonarrRootFolder
- Accept a local path for the host localhost in New-SonarrRemotePathMapping without checking that it exists on your computer
- Fix Update-SonarrRemotePathMapping dropping the values that you leave out
- Fix Update-SonarrMediaManagement adding a backslash to the recycle bin''s path, which broke Linux paths

Value Handling Fixes
- Keep names and typed text that look like numbers as strings, such as a download client named 2024, a tag''s label, a provider''s setting, a host name, or a release''s guid
- Fix wildcard name filters missing such text, such as -Name ''10*'' not finding a tag labeled 1080
- Fix the 400 error that Sonarr returns for a setting whose text looks like a number
- Read numbers and dates, and build queries, the same way under every culture setting
- Keep text with group separators, such as 1,000, as text instead of a number
- Read a string as a date only in ISO 8601 form
- Keep the text that Sonarr sent for a date that doesn''t read as one, instead of 1/1/0001
- Fix an error when setting a model''s number or date property to a value that came from a command
- Treat every * in a name filter as a wildcard, even where a name holds a literal *
- Ignore case for letters outside ASCII in name filters
- Read a lone % in a name filter as a name instead of every name'


        # Prerelease string of this module
        # Prerelease = ''

        # Flag to indicate whether the module requires explicit user acceptance for install/update/save
        # RequireLicenseAcceptance = $false

        # External dependent modules of this module
        # ExternalModuleDependencies = @()

    } # End of PSData hashtable

} # End of PrivateData hashtable

# HelpInfo URI of this module
# HelpInfoURI = ''

# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
# DefaultCommandPrefix = ''

}