Sonarr/README.md

58 lines
2.2 KiB
Markdown
Raw Normal View History

2017-01-18 20:31:20 +00:00
# Sonarr
2011-08-03 16:29:03 +00:00
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.
2013-03-29 16:44:41 +00:00
2017-01-18 20:31:20 +00:00
## Major Features Include:
2013-03-29 16:44:41 +00:00
2017-01-18 20:31:20 +00:00
* Support for major platforms: Windows, Linux, macOS, Raspberry Pi, etc.
2013-03-29 16:44:41 +00:00
* Automatically detects new episodes
2014-12-05 05:53:28 +00:00
* 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
2017-01-18 20:31:20 +00:00
* Full integration with SABnzbd and NZBGet
* Full integration with Kodi, Plex (notification, library update, metadata)
2014-12-05 05:53:28 +00:00
* Full support for specials and multi-episode releases
* And a beautiful UI
2013-03-29 16:44:41 +00:00
2017-01-18 20:31:20 +00:00
## Configuring Development Environment:
2013-03-29 16:44:41 +00:00
2017-01-18 20:31:20 +00:00
### Requirements
2013-03-29 16:44:41 +00:00
* Visual Studio 2017 (https://www.visualstudio.com/vs/)
2017-01-18 20:31:20 +00:00
* [Git](https://git-scm.com/downloads)
2017-03-19 06:34:37 +00:00
* [NodeJS](https://nodejs.org/en/download/)
* [Yarn](https://yarnpkg.com/)
2013-03-29 16:44:41 +00:00
2017-01-18 20:31:20 +00:00
### Setup
2013-03-29 16:44:41 +00:00
* Make sure all the required software mentioned above are installed
* Clone the repository into your development machine. [*info*](https://help.github.com/en/articles/working-with-forks)
2017-01-18 20:31:20 +00:00
* Grab the submodules `git submodule init && git submodule update`
* Install the required Node Packages `yarn`
2013-03-29 16:44:41 +00:00
### Backend Development
2013-03-29 16:44:41 +00:00
* Run `yarn build` to build the UI
* Open `Sonarr.sln` in Visual Studio
* Make sure `Sonarr.Console` is set as the startup project
* Build `Sonarr.Windows` and `Sonarr.Mono` projects
* Build Solution
2013-03-29 16:44:41 +00:00
### UI Development
* Run `yarn watch` to build UI and rebuild automatically when changes are detected
* Run Sonarr.Console.exe (or debug in Visual Studio)
2012-03-04 18:02:06 +00:00
2017-01-18 20:31:20 +00:00
### License
2012-03-04 18:02:06 +00:00
* [GNU GPL v3](http://www.gnu.org/licenses/gpl.html)
* Copyright 2010-2019
2014-01-24 22:03:39 +00:00
2017-01-18 20:31:20 +00:00
### Sponsors
2014-01-24 22:03:39 +00:00
2017-01-18 20:31:20 +00:00
* [JetBrains](http://www.jetbrains.com/) for providing us with free licenses to their great tools
* [ReSharper](http://www.jetbrains.com/resharper/)
* [TeamCity](http://www.jetbrains.com/teamcity/)