Profilarr is a Python-based tool designed to add import/export/sync functionality to the *arr suite. It offers a user-friendly way to export existing custom formats / profiles, import new ones or sync a master instance of Radarr / Sonarr with extras.

⚠️ Before Continuing

This tool will overwrite any custom formats in your *arr installation that have the same name.
Custom Formats MUST be imported before syncing any premade profile.
Always back up your Radarr and Sonarr configurations before using Profilarr to avoid unintended data loss. (Seriously, do it. Even I've lost data to this tool because I forgot to back up my configs.)

🛠️ Installation

Prerequisites

Python 3.x installed. You can download it from python.org.
Radarr / Sonarr

📦 Dependencies

requests (Install using pip install requests)

Initial Setup

Download the latest Profilarr package from the release section.
Extract its contents into a folder.
Open the config.json file in a text editor.
- Add your Radarr / Sonarr API key and modify the base URL as necessary.
- If importing / exporting, only change the master installation's API key and base URL.
- If syncing, add the API keys and base URLs of all instances you want to sync.
- The master install will be the one that all other instances sync to.
Save the changes.

🚀 Usage

Exporting

Run python exportarr.py in your command line interface.
Follow the on-screen prompts to select the app (Radarr or Sonarr) and the data (Custom Formats or Quality Profiles) you want to export.
Exported data will be saved in respective directories within the tool's folder.

Importing

Run python importarr.py in your command line interface.
Follow the on-screen prompts to select the app and the data you want to import.
Choose the specific file for Custom Formats or select a profile for Quality Profiles.
The data will be imported to your selected Radarr or Sonarr installation.

Syncing

Run python syncarr.py in your command line interface.
The script will automatically export data from the master instance and import it to all other instances specified in config.json.
This feature is designed to manage multiple Radarr/Sonarr instances, syncing profiles and formats seamlessly.

Radarr and Sonarr Compatibility

Custom formats can be imported and exported between Radarr and Sonarr (but might not work as expected).
Quality profiles are not directly interchangeable between Radarr and Sonarr due to differences in quality source names. If you want to use the same profile in both apps, you will need to manually edit the profile's quality source names before importing it.

🌟 Upcoming Features

Lidarr Support: Expand functionality to include Lidarr, allowing users to manage music quality profiles and custom formats.
User Interface (UI): Development of a graphical user interface (GUI) for easier and more intuitive interaction with Profilarr. This UI will cater to users who prefer graphical over command-line interactions.
Automatic Updates: Implement an auto-update mechanism for Profilarr, ensuring users always have access to the latest features, improvements, and bug fixes without manual intervention.

Profilarr Development

This section provides concise instructions for developers to set up Profilarr for further development, customization, or contribution.

Getting Started

To get started with Profilarr development, follow these steps:

Run Docker Compose:
- Start Radarr and Sonarr instances using the provided Docker Compose files:
```
docker-compose up -d
```
- This command will set up isolated instances of Radarr and Sonarr for development purposes.
Configure API Keys:
- Once Radarr and Sonarr are running, access their web interfaces to obtain the API keys.
- Update the config.json file with these API keys. This step is crucial for Profilarr to communicate with your Radarr and Sonarr instances.
Import Custom Formats:
- Use Profilarr to import any initial custom formats you need. This step sets the baseline for your development environment.
- Run python importarr.py and follow the prompts to import custom formats into Radarr or Sonarr.
Developing New Profiles and Custom Formats:
- With the setup complete, you can now start developing new profiles and custom formats.
- Test your changes by exporting from Profilarr and verifying the behavior in the Radarr/Sonarr instances.

Development Tips

Always Back Up: Before making major changes, back up your Radarr and Sonarr configurations.
Iterative Testing: Test your changes incrementally to ensure stability and expected behavior.
Document Your Changes: Keep track of modifications for future reference or contribution to the project.

By following these steps, you'll have a working development environment for Profilarr, allowing you to create and test new profiles and custom formats effectively.

TRASH Guides

Some custom formats found here have been interated on from the trash guides. Credit for these goes entirely to trash, and can be found on their site here. It is not my intention to steal their work, but rather to build on it and make it more accessible to the average user through my quality profiles. Please check out their site for more information on their work.

https://trash-guides.info/