diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..996a1cb
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,51 @@
+# How to Contribute
+---
+
+If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
+Don't forget to give the project a star! Thanks again!
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+(back to top)
+
+### Development
+
+Before the project can be built, you must first install the .NET 9.0 SDK on your system.
+
+Instructions to run this project from the command line are included here, but you will also need to install an IDE if you want to debug Proxarr while it is running.
+
+### Prerequisites
+
+* Acquire TMDB API KEY
+ [How](https://dev.to/codexive_zech/streamlining-your-contribution-how-to-get-your-tmdb-api-key-for-ldbflix-contribution-52gf#:~:text=How%20to%20Obtain%20a%20TMDB%20API%20Key)
+* Obtain SONARR/RADARR API KEY
+ 
+
+### Installation
+
+1. Clone the repo
+ ```sh
+ git clone https://github.com/Fazzani/Proxarr.git
+ cd ./Proxarr
+ ```
+
+2. Update your [config.yml][config-yml] with your API keys according to your setup
+ ```yaml
+ AppConfiguration:
+ TMDB_API_KEY: "{{ TMDB API KEY}}"
+ TAG_NAME: "q"
+ WATCH_PROVIDERS: "YOUR PROVIDERS HERE seperated by comma (ex: FR:Netflix,US:Amazon Prime Video)"
+ Clients: # Add as many clients as you want
+ - ApiKey: "{{ SONAR OR RADARR API KEY }}"
+ BaseUrl: "{{ SONARR OR RADARR BASE URL }}"
+ ```
+
+3. Run the application
+ ```sh
+ dotnet run ./src/Proxarr.Api/Proxarr.Api.csproj
+ ```
+(back to top)
\ No newline at end of file
diff --git a/README.md b/README.md
index 73bf20c..1ac3195 100644
--- a/README.md
+++ b/README.md
@@ -54,41 +54,26 @@
Proxarr is a lightweight proxy server for automatically qualify requested media items based in countries served by watching providers.
It uses TMDB to find out which streaming services are available in the selected region.
+
+
(back to top)
## Getting Started
-### Prerequisites
-
-* Acquire TMDB API KEY
- [How](https://dev.to/codexive_zech/streamlining-your-contribution-how-to-get-your-tmdb-api-key-for-ldbflix-contribution-52gf#:~:text=How%20to%20Obtain%20a%20TMDB%20API%20Key)
-* Obtain SONARR/RADARR API KEY
-
-
-### Installation
-
-1. Clone the repo
- ```sh
- git clone https://github.com/Fazzani/Proxarr.git
- ```
-
-2. Update your [config.yml](./src/Proxarr.Api/config.yml) with your API keys according to your setup
- ```yaml
- AppConfiguration:
- TMDB_API_KEY: "{{ TMDB API KEY}}"
- TAG_NAME: "q"
- WATCH_PROVIDERS: "YOUR PROVIDERS HERE seperated by comma (ex: FR:Netflix,US:Amazon Prime Video)"
- Clients: # Add as many clients as you want
- - ApiKey: "{{ SONAR OR RADARR API KEY }}"
- BaseUrl: "{{ SONARR OR RADARR BASE URL }}"
- ```
-
-3. Run the application
- ```sh
- dotnet run ./src/Proxarr.Api/Proxarr.Api.csproj
- ```
-(back to top)
+1. Acquire TMDB API KEY
+ [How](https://dev.to/codexive_zech/streamlining-your-contribution-how-to-get-your-tmdb-api-key-for-ldbflix-contribution-52gf#:~:text=How%20to%20Obtain%20a%20TMDB%20API%20Key)
+2. Obtain SONARR/RADARR API KEY
+
+3. Prepare your [config.yml][config-yml] with your configuration
+4. Setup your [docker-compose](./docker-compose.yml)
+5. From Sonarr/Radarr you create a new Webhook connection to Proxarr server
+ 
+6. `Application URL` field must be specified this will enable Proxarr to determine the correct api key to use when sending the response to Sonarr/Radarr
+ 
+7. Tag all indexers by the TAG_NAME specified into your [config.yml][config-yml] ('q' by default). This will prevent the downloading of media that does not have the tag
+ 
+8. Enjoy!
## Usage
@@ -131,16 +116,7 @@ See the [open issues](https://github.com/Fazzani/Proxarr/issues) for a full list
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
-If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
-Don't forget to give the project a star! Thanks again!
-
-1. Fork the Project
-2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the Branch (`git push origin feature/AmazingFeature`)
-5. Open a Pull Request
-
-(back to top)
+[How to Contribute](CONTRIBUTING.md)
### Top contributors:
@@ -178,3 +154,5 @@ Project Link: [https://github.com/Fazzani/Proxarr](https://github.com/Fazzani/Pr
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://www.linkedin.com/in/heni-fazzani
[arr-api-key]: images/arr_api_key.png
+[workflow]: images/workflow.gif
+[config-yml]: src/Proxarr.Api/config.yml]
diff --git a/docker-compse.yml b/docker-compose.yml
similarity index 100%
rename from docker-compse.yml
rename to docker-compose.yml
diff --git a/images/appli_url_config.png b/images/appli_url_config.png
new file mode 100644
index 0000000..58824ac
Binary files /dev/null and b/images/appli_url_config.png differ
diff --git a/images/tagging-indexers.png b/images/tagging-indexers.png
new file mode 100644
index 0000000..1e58c10
Binary files /dev/null and b/images/tagging-indexers.png differ
diff --git a/images/webhook_creation.png b/images/webhook_creation.png
new file mode 100644
index 0000000..b24bcb3
Binary files /dev/null and b/images/webhook_creation.png differ
diff --git a/images/workflow.gif b/images/workflow.gif
new file mode 100644
index 0000000..32f59af
Binary files /dev/null and b/images/workflow.gif differ
diff --git a/src/Proxarr.sln b/src/Proxarr.sln
index cac6f99..2eb1e35 100644
--- a/src/Proxarr.sln
+++ b/src/Proxarr.sln
@@ -13,7 +13,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
ProjectSection(SolutionItems) = preProject
..\.dockerignore = ..\.dockerignore
..\.gitignore = ..\.gitignore
- ..\docker-compse.yml = ..\docker-compse.yml
+ ..\docker-compose.yml = ..\docker-compose.yml
..\.github\workflows\docker-image.yml = ..\.github\workflows\docker-image.yml
..\Dockerfile = ..\Dockerfile
..\README.md = ..\README.md