Sonarr/README.md

# <img width="24px" src="./Logo/256.png" alt="Sonarr"></img> Sonarr

[![Translated](https://translate.servarr.com/widgets/servarr/-/sonarr/svg-badge.svg)](https://translate.servarr.com/engage/servarr/)
[![Backers on Open Collective](https://opencollective.com/Sonarr/backers/badge.svg)](#backers)
[![Sponsors on Open Collective](https://opencollective.com/Sonarr/sponsors/badge.svg)](#sponsors)
[![Mega Sponsors on Open Collective](https://opencollective.com/Sonarr/megasponsors/badge.svg)](#mega-sponsors)

Sonarr is a PVR for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new episodes of your favorite shows and will grab, sort and rename them. It can also be configured to automatically upgrade the quality of files already downloaded when a better quality format becomes available.

## Getting Started

- [Download/Installation](https://sonarr.tv/#downloads-v3)
- [FAQ](https://wiki.servarr.com/sonarr/faq)
- [Wiki](https://wiki.servarr.com/Sonarr)
- [v4 Beta API Documentation](https://sonarr.tv/docs/api)
- [Donate](https://sonarr.tv/donate)

## Support

Note: GitHub Issues are for Bugs and Feature Requests Only

- [Forums](https://forums.sonarr.tv/)
- [Discord](https://discord.gg/M6BvZn5)
- [GitHub - Bugs and Feature Requests Only](https://github.com/Sonarr/Sonarr/issues)
- [IRC](https://web.libera.chat/?channels=#sonarr)
- [Reddit](https://www.reddit.com/r/sonarr)
- [Wiki](https://wiki.servarr.com/sonarr)

## Features

### Current Features

- Support for major platforms: Windows, Linux, macOS, Raspberry Pi, etc.
- Automatically detects new episodes
- Can scan your existing library and download any missing episodes
- Can watch for better quality of the episodes you already have and do an automatic upgrade. _eg. from DVD to Blu-Ray_
- Automatic failed download handling will try another release if one fails
- Manual search so you can pick any release or to see why a release was not downloaded automatically
- Fully configurable episode renaming
- Full integration with SABnzbd and NZBGet
- Full integration with Kodi, Plex (notification, library update, metadata)
- Full support for specials and multi-episode releases
- And a beautiful UI

## Contributing

### Development

This project exists thanks to all the people who contribute. [Contribute](CONTRIBUTING.md).

<a href="https://github.com/Sonarr/Sonarr/graphs/contributors"><img src="https://opencollective.com/Sonarr/contributors.svg?width=890&button=false" /></a>

### Supporters

This project would not be possible without the support of our users and software providers.
[**Become a sponsor or backer**](https://opencollective.com/sonarr) to help us out!

#### Mega Sponsors

[![Sponsors](https://opencollective.com/sonarr/tiers/mega-sponsor.svg?width=890)](https://opencollective.com/sonarr/contribute/mega-sponsor-21443/checkout)

#### Sponsors

[![Flexible Sponsors](https://opencollective.com/sonarr/sponsors.svg?width=890)](https://opencollective.com/sonarr/contribute/sponsor-21457/checkout)

#### Backers

[![Backers](https://opencollective.com/sonarr/backers.svg?width=890)](https://opencollective.com/sonarr/contribute/backer-21442/checkout)

#### JetBrains

Thank you to [<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.png" alt="JetBrains" width="96">](http://www.jetbrains.com/) for providing us with free licenses to their great tools

[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/TeamCity.png" alt="TeamCity" width="64">](http://www.jetbrains.com/teamcity/)

[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/ReSharper.png" alt="ReSharper" width="64">](http://www.jetbrains.com/resharper/)

[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/dotTrace.png" alt="dotTrace" width="64">](http://www.jetbrains.com/dottrace/)

[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/Rider.png" alt="Rider" width="64">](http://www.jetbrains.com/rider/)

### Licenses

- [GNU GPL v3](http://www.gnu.org/licenses/gpl.html)
- Copyright 2010-2024
Update JetBrains logos 2024-10-25 23:54:07 +00:00			`# <img width="24px" src="./Logo/256.png" alt="Sonarr"></img> Sonarr`
Added Readme 2011-08-03 16:29:03 +00:00
Add Translated + Sponsor Badges to README.md 2023-09-29 13:12:24 +00:00			`[![Translated](https://translate.servarr.com/widgets/servarr/-/sonarr/svg-badge.svg)](https://translate.servarr.com/engage/servarr/)`
			`[![Backers on Open Collective](https://opencollective.com/Sonarr/backers/badge.svg)](#backers)`
			`[![Sponsors on Open Collective](https://opencollective.com/Sonarr/sponsors/badge.svg)](#sponsors)`
			`[![Mega Sponsors on Open Collective](https://opencollective.com/Sonarr/megasponsors/badge.svg)](#mega-sponsors)`

Fixes small grammatical error 2015-01-16 04:17:10 +00:00			`Sonarr is a PVR for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new episodes of your favorite shows and will grab, sort and rename them. It can also be configured to automatically upgrade the quality of files already downloaded when a better quality format becomes available.`
Update readme.md 2013-03-29 16:44:41 +00:00
Updated README 2020-01-05 03:57:13 +00:00			`## Getting Started`
Update readme.md 2013-03-29 16:44:41 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`- [Download/Installation](https://sonarr.tv/#downloads-v3)`
Use YML Github templates 2021-08-05 23:16:57 +00:00			`- [FAQ](https://wiki.servarr.com/sonarr/faq)`
Readme updates 2021-01-14 00:59:08 +00:00			`- [Wiki](https://wiki.servarr.com/Sonarr)`
2023 readme fixes 2023-01-06 00:23:04 +00:00			`- [v4 Beta API Documentation](https://sonarr.tv/docs/api)`
Readme updates 2021-01-14 00:59:08 +00:00			`- [Donate](https://sonarr.tv/donate)`
Updated README 2020-01-05 03:57:13 +00:00
			`## Support`
2023 readme fixes 2023-01-06 00:23:04 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`Note: GitHub Issues are for Bugs and Feature Requests Only`
Updated README 2020-01-05 03:57:13 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`- [Forums](https://forums.sonarr.tv/)`
Updated README 2020-01-05 03:57:13 +00:00			`- [Discord](https://discord.gg/M6BvZn5)`
Readme updates 2021-01-14 00:59:08 +00:00			`- [GitHub - Bugs and Feature Requests Only](https://github.com/Sonarr/Sonarr/issues)`
Use YML Github templates 2021-08-05 23:16:57 +00:00			`- [IRC](https://web.libera.chat/?channels=#sonarr)`
Updated README 2020-01-05 03:57:13 +00:00			`- [Reddit](https://www.reddit.com/r/sonarr)`
Use YML Github templates 2021-08-05 23:16:57 +00:00			`- [Wiki](https://wiki.servarr.com/sonarr)`
Readme updates 2021-01-14 00:59:08 +00:00
Updated README 2020-01-05 03:57:13 +00:00			`## Features`

			`### Current Features`

			`- Support for major platforms: Windows, Linux, macOS, Raspberry Pi, etc.`
			`- Automatically detects new episodes`
			`- Can scan your existing library and download any missing episodes`
Update JetBrains logos 2024-10-25 23:54:07 +00:00			`- Can watch for better quality of the episodes you already have and do an automatic upgrade. _eg. from DVD to Blu-Ray_`
Updated README 2020-01-05 03:57:13 +00:00			`- Automatic failed download handling will try another release if one fails`
			`- Manual search so you can pick any release or to see why a release was not downloaded automatically`
			`- Fully configurable episode renaming`
			`- Full integration with SABnzbd and NZBGet`
			`- Full integration with Kodi, Plex (notification, library update, metadata)`
			`- Full support for specials and multi-episode releases`
			`- And a beautiful UI`
Update readme.md 2013-03-29 16:44:41 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`## Contributing`
Update readme.md 2013-03-29 16:44:41 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`### Development`
2023 readme fixes 2023-01-06 00:23:04 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`This project exists thanks to all the people who contribute. [Contribute](CONTRIBUTING.md).`
Update open collective links 2021-12-13 23:52:51 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`<a href="https://github.com/Sonarr/Sonarr/graphs/contributors"><img src="https://opencollective.com/Sonarr/contributors.svg?width=890&button=false" /></a>`
updated readme 2014-01-24 22:03:39 +00:00
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00			`### Supporters`

Update JetBrains logos 2024-10-25 23:54:07 +00:00			`This project would not be possible without the support of our users and software providers.`
Readme updates 2021-01-14 00:59:08 +00:00			`[Become a sponsor or backer](https://opencollective.com/sonarr) to help us out!`
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00
Update open collective links 2021-12-13 23:52:51 +00:00			`#### Mega Sponsors`
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00
Update open collective links 2021-12-13 23:52:51 +00:00			`[![Sponsors](https://opencollective.com/sonarr/tiers/mega-sponsor.svg?width=890)](https://opencollective.com/sonarr/contribute/mega-sponsor-21443/checkout)`
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00
Update open collective links 2021-12-13 23:52:51 +00:00			`#### Sponsors`
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00
Update open collective links 2021-12-13 23:52:51 +00:00			`[![Flexible Sponsors](https://opencollective.com/sonarr/sponsors.svg?width=890)](https://opencollective.com/sonarr/contribute/sponsor-21457/checkout)`
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00
			`#### Backers`

Update open collective links 2021-12-13 23:52:51 +00:00			`[![Backers](https://opencollective.com/sonarr/backers.svg?width=890)](https://opencollective.com/sonarr/contribute/backer-21442/checkout)`
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00
			`#### JetBrains`

Update JetBrains logos 2024-10-25 23:54:07 +00:00			`Thank you to [<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.png" alt="JetBrains" width="96">](http://www.jetbrains.com/) for providing us with free licenses to their great tools`
Update supporters and use jetbrains images 2020-10-04 22:56:26 +00:00
Update JetBrains logos 2024-10-25 23:54:07 +00:00			`[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/TeamCity.png" alt="TeamCity" width="64">](http://www.jetbrains.com/teamcity/)`

			`[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/ReSharper.png" alt="ReSharper" width="64">](http://www.jetbrains.com/resharper/)`

			`[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/dotTrace.png" alt="dotTrace" width="64">](http://www.jetbrains.com/dottrace/)`

			`[<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/Rider.png" alt="Rider" width="64">](http://www.jetbrains.com/rider/)`
updated readme 2014-01-24 22:03:39 +00:00
Readme updates 2021-01-14 00:59:08 +00:00			`### Licenses`

Update JetBrains logos 2024-10-25 23:54:07 +00:00			`- [GNU GPL v3](http://www.gnu.org/licenses/gpl.html)`
			`- Copyright 2010-2024`