backuparr 0.1.0__py3-none-any.whl

backuparr/api_stuff.py

@@ -0,0 +1,23 @@
+import os
+
+from enum import StrEnum
+from dotenv import load_dotenv
+
+
+
+load_dotenv()
+
+class radarr(StrEnum):
+    apiKey = str(os.getenv("RADARR_APIKEY"))
+    baseUrl = str(os.getenv("RADARR_URL"))
+    movieListUrl = baseUrl + "/api/v3/movie"
+    qualityProfileUrl = baseUrl + "/api/v3/qualityprofile"
+    rootFolderUrl = baseUrl + "/api/v3/rootfolder"
+
+class sonarr(StrEnum):
+    apiKey = str(os.getenv("SONARR_APIKEY"))
+    baseUrl = str(os.getenv("SONARR_URL"))
+    seriesListUrl = baseUrl + "/api/v3/series"
+    episodeFileUrl = baseUrl + "/api/v3/episodefile"
+    rootFolderUrl = baseUrl + "/api/v3/rootfolder"
+    qualityProfileUrl = baseUrl + "/api/v3/qualityprofile"

backuparr/backup.py

@@ -0,0 +1,60 @@
+import json
+import sys
+import requests
+
+from backuparr import api_stuff as api
+from backuparr import functions
+
+
+def run(app, filename):
+    ## Resolving Filename
+    filename = functions.resolveFilename(filename)
+
+    ## Attempt Connection
+    movieData = {}
+    match app:
+        case "radarr":
+            movieData = functions.attemptConnection(api.radarr.movieListUrl, api.radarr.apiKey)
+        case "sonarr":
+            movieData = functions.attemptConnection(api.sonarr.seriesListUrl, api.sonarr.apiKey)
+
+    ## Display found movies
+    len_data = len(movieData)
+    if len_data == 1:
+        print(len_data, "movie/series have been found.")
+    elif len_data == 0:
+        print("No movie/series have been found.")
+        print("Exiting...")
+        sys.exit("No movies/series found.")
+    else:
+        print(len_data, "movies/series have been found.")
+
+
+    ## Making and writing data to JSON file
+    jsondata = {}
+    for i in range(len_data):
+        match app:
+            case "radarr":
+                jsondata[str(movieData[i]["tmdbId"])] = functions.makeJsonData(i, movieData)
+            case "sonarr":
+                quality = -1
+                if int(movieData[i]["statistics"]["episodeFileCount"]) > 0:
+                    req = requests.get(api.sonarr.episodeFileUrl + "?seriesId=" + str(movieData[i]["id"]), headers={"x-api-key": api.sonarr.apiKey}).json()
+                    for j in range(len(req)):
+                        try:
+                            quality = int(req[j]["quality"]["quality"]["resolution"])
+                            break
+                        except Exception as e:
+                            print("Resolution not found, trying another file...")
+                jsondata[str(movieData[i]["tvdbId"])] = functions.makeSonarrData(i, movieData, quality)
+
+        print("Writing Data for: " + str(movieData[i]["title"]))
+
+    with open(filename, "w", encoding="utf-8") as f:
+        json.dump(jsondata, f, indent=4, ensure_ascii=False, sort_keys=True)
+
+    print("Data has been writen to:", filename)
+    print("Exiting...")
+
+if __name__ == "__main__":
+    run()

backuparr/functions.py

@@ -0,0 +1,149 @@
+import json
+import sys
+import requests
+
+from pathlib import Path
+from requests.exceptions import HTTPError, Timeout, RequestException
+
+
+def attemptConnection(connectionUrl, apiKey):
+    while True:
+        (connected, jsonData) = getJsonDataFromUrl(connectionUrl, apiKey)
+        if connected: return jsonData
+        while True:
+            choice = input("Connection failed, make sure the URL is valid and accessible. (y)Reconnect | (n) Exit: ").lower().strip()
+            if choice == "n": sys.exit("User terminated the process")
+            elif choice == "y":
+                print("Reconnecting...")
+                break
+            else: print("Invalid input. Use: y/n")
+
+def getJsonDataFromUrl(connectionUrl, apiKey):
+    noApiUrl = connectionUrl.split("?apiKey=")[0]
+    try:
+        print("Connecting to " + noApiUrl)
+        headers = {"x-api-key" : apiKey}
+        response = requests.get(connectionUrl, headers=headers, timeout=10)
+        if response.status_code == 401:
+            print("Error: 401 Request unauthorized. @:", noApiUrl)
+            return False, ""
+        print("Connection established.")
+        return True, response.json()
+    except Timeout:
+        print("Error: The request timed out. This URL might be down or slow. @:", noApiUrl)
+        return False, ""
+    except ConnectionError:
+        print("Error: Failed to connect to this URL. Check your URL or network. @:", noApiUrl)
+        return False, ""
+    except HTTPError as e:
+        print(f"HTTP Error: {e}\n@:", noApiUrl)
+        return False, ""
+    except RequestException as e:
+        print(f"An ambiguous error occurred: {e}\n@:", noApiUrl)
+        return False, ""
+    except ValueError:
+        print("Error: Successfully connected, but received invalid JSON. @:", noApiUrl)
+        return False, ""
+
+def makeJsonData(index, data):
+    try:
+        if data[index].get("movieFile") is not None: quality = data[index]["movieFile"]["quality"]["quality"]["resolution"]
+        else: quality = -1
+
+        jsonData =  {
+        "title": str(data[index]["title"]),
+        "tmdbId": int(data[index]["tmdbId"]),
+        "monitored": bool(data[index]["monitored"]),
+        "quality": int(quality)
+        }
+        return jsonData
+    except Exception as e:
+        print("KeyError: Important Data not found!")
+        print(str(e))
+        sys.exit()
+
+def makeSonarrData(index, data, quality):
+    try:
+        jsonData = {
+        "title": str(data[index]["title"]),
+        "tvdbId": int(data[index]["tvdbId"]),
+        "monitored": bool(data[index]["monitored"]),
+        "quality": int(quality)
+        }
+        return jsonData
+    except Exception as e:
+        print("KeyError: Important Data not found!")
+        print(str(e))
+        sys.exit()
+
+def getNumUserInput(lastnum):
+    while True:
+        num = input("Enter choice, default [0]: ").strip()
+        try:
+            if not num: return 0
+            num = int(num)
+            if int(num) <= lastnum: return int(num)
+            else: print(str(num) + " is not a integer, or a valid input...")
+
+        except ValueError:
+            print(str(num) + " is not a valid input...")
+
+def resolveFilename(path):
+    filename = Path(path).resolve()
+    try:
+        filename.parent.mkdir(parents=True, exist_ok=True)
+        return filename
+    except Exception as e:
+        print("An Error occurred: " + str(e))
+
+def postJsonData(connectionUrl, apiKey, jsonDataList):
+    statusDict = {}
+    print("Attempting to post data for " + str(len(jsonDataList)) + " entries...")
+    for index, item in enumerate(jsonDataList):
+        try:
+            print("Importing: " + item["title"])
+            req_response = requests.post(connectionUrl, headers={"x-api-key" : apiKey}, json=item)
+            if not req_response.status_code == 201:
+                statusDict[index] = req_response
+            print("Code: " + str(req_response.status_code) + " | " + str(req_response.elapsed.total_seconds()) + "s")
+        except Exception as e:
+            print("An Error occurred: " + str(e))
+
+    while True:
+        if len(statusDict) == 0: return
+
+        print("Successfully posted data for " + str(len(jsonDataList) - len(statusDict)) + " entries...")
+
+        choice = input("Do you want to retry all entries that didn't return 201 Created? Retry(r) | List(l) | Default: Exit(e): ").strip().lower()
+        if not choice or choice == "e":
+            sys.exit("User terminated process.")
+        elif choice == "l":
+            for j, resp in statusDict.items():
+                print(f"----- {jsonDataList[j]["title"]} -----")
+                print(f"Code: {resp.status_code}")
+                print(f"Response:\n{json.dumps(resp.json(), indent=4)}")
+                print("-" * 100)
+
+            while True:
+                choice2 = input("Do you want to retry importing? (y/n): ").strip().lower()
+                if choice2 == "y": break
+                elif choice2 == "n": sys.exit("User terminated process.")
+                else: print("Invalid Choice, retrying...")
+        elif choice == "r": print("Retrying...")
+        else:
+            print("Invalid Choice, retrying...")
+            continue
+
+        toDelete = []
+        for k, resp in statusDict.items():
+            print("Importing: " + jsonDataList[k]["title"])
+            retry_resp = requests.post(connectionUrl, headers={"x-api-key" : apiKey}, json=jsonDataList[k])
+            print("Code: " + str(retry_resp.status_code) + " | " + str(retry_resp.elapsed.total_seconds()) + "s")
+            if retry_resp.status_code == 201:
+                print(f"Successfully posted data for: {jsonDataList[k]["title"]}")
+                toDelete.append(k)
+            else:
+                print(f"Still unable to import: {jsonDataList[k]["title"]}")
+
+        for l in toDelete:
+            del statusDict[l]

backuparr/main.py

@@ -0,0 +1,26 @@
+import sys
+from backuparr import backup, restore
+
+
+def run():
+    if len(sys.argv) != 4:
+        print("Usage: backuparr [backup|restore] [radarr|sonarr] [filename]")
+        return
+
+    mode = str(sys.argv[1].lower().strip())
+    app = str(sys.argv[2].lower().strip())
+    filename = str(sys.argv[3])
+
+    if (app != "radarr") and (app != "sonarr"):
+        print(app)
+        sys.exit("Argument Error, 2. Argument must be 'radarr' or 'sonarr'")
+
+    if mode == "backup":
+        backup.run(app, filename)
+    elif mode == "restore":
+        restore.run(app, filename)
+    else:
+        print("Argument Error, Usage: backuparr [backup|restore] [radarr|sonarr] [filename]")
+
+if __name__ == "__main__":
+    run()

backuparr/restore.py

@@ -0,0 +1,109 @@
+import json
+import sys
+
+from backuparr import api_stuff as api
+from backuparr import functions
+
+
+def run(app, path):
+    ## Resolving Filename
+    filename = functions.resolveFilename(path)
+
+    ## Required API Calls
+    rootFolder = ""
+    qualityProfiles = ""
+    match app:
+        case "radarr":
+            rootFolder = functions.attemptConnection(api.radarr.rootFolderUrl, api.radarr.apiKey)
+            qualityProfiles = functions.attemptConnection(api.radarr.qualityProfileUrl, api.radarr.apiKey)
+        case "sonarr":
+            rootFolder = functions.attemptConnection(api.sonarr.rootFolderUrl, api.sonarr.apiKey)
+            qualityProfiles = functions.attemptConnection(api.sonarr.qualityProfileUrl, api.sonarr.apiKey)
+
+    
+    ## Selecting Root Folder
+    if len(rootFolder) == 0:
+        sys.exit("No root folder found, please add a root folder.")
+
+    elif len(rootFolder) == 1:
+        selectedRootFolderPath = rootFolder[0]["path"]
+        print("Only one root folder found, no selection needed.")
+
+    else:
+        print("Choose Root Folder to restore into, default [0]:")
+
+        for i in range(len(rootFolder)):
+            print("[" + str(i) + "] | Radarr-ID: " + str(rootFolder[i]["id"]) + " | Accessible: " + str(rootFolder[i]["accessible"]) + " | Free Space: " + str(rootFolder[i]["freeSpace"]) + " | Path: " + str(rootFolder[i]["path"]))
+
+        selectedRootFolderPath = rootFolder[functions.getNumUserInput(len(rootFolder) - 1)]["path"]
+
+
+    ## Load file
+    try:
+        with open(filename, 'r') as f:
+            backupdata = json.load(f)
+            print("Loaded contents of:", filename)
+    except Exception as e:
+        sys.exit("An Error occurred: " + str(e))
+
+
+    ## Select Qualities
+    qualities_set = set()
+    quality_dictionary = {}
+
+    for tmdbID, details in backupdata.items():
+        qualities_set.add(details["quality"])
+
+    for x in qualities_set:
+        if x == -1:
+            print("There where was no Quality Data found for these movies, which Profile should be used for these?")
+
+            for i in range(len(qualityProfiles)):
+                print("[" + str(i) + "] | ID: " + str(qualityProfiles[i]["id"]) + " | Name: " + str(qualityProfiles[i]["name"]))
+
+            quality_dictionary[x] = qualityProfiles[functions.getNumUserInput(len(qualityProfiles) - 1)]["id"]
+
+            print("Profile-Id: " + str(quality_dictionary[x]) + " is now associated with the movies that had no data found.")
+            break
+
+
+        print("Which Quality Profile should be used for importing ==> " + str(x) + "P <== movies?")
+
+        for i in range(len(qualityProfiles)):
+            print("[" + str(i) + "] | ID: " + str(qualityProfiles[i]["id"]) + " | Name: " + str(qualityProfiles[i]["name"]))
+
+        quality_dictionary[x] = qualityProfiles[functions.getNumUserInput(len(qualityProfiles) - 1)]["id"]
+
+        print(str(x) + "p associated with Profile-Id: " + str(quality_dictionary[x]))
+
+
+    ## Making data for import
+    jsonDataList = []
+    for movie, details in backupdata.items():
+        match app:
+            case "radarr":
+                id_text = "tmdbId"
+                id_cont = details["tmdbId"]
+            case "sonarr":
+                id_text = "tvdbId"
+                id_cont = details["tvdbId"]
+
+        jsonDataList.append({
+            "title": str(details["title"]),
+            str(id_text): int(id_cont),
+            "qualityProfileId": quality_dictionary[int(details["quality"])],
+            "rootFolderPath": str(selectedRootFolderPath),
+            "monitored": bool(details["monitored"]),
+        })
+
+    match app:
+        case "radarr":
+            functions.postJsonData(api.radarr.movieListUrl, api.radarr.apiKey, jsonDataList)
+        case "sonarr":
+            functions.postJsonData(api.sonarr.seriesListUrl, api.sonarr.apiKey, jsonDataList)
+
+    print("Successfully imported all entries.\nExiting...")
+    sys.exit()
+
+if __name__ == "__main__":
+    run()

backuparr-0.1.0.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: backuparr
+Version: 0.1.0
+Summary: A lightweight, efficient way to backup your media library without duplicating large video files.
+Author: Daniel Mayhan
+License: MIT License
+        
+        Copyright (c) 2026 DanielMayhan
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: python-dotenv
+Dynamic: license-file
+
+# BackupArr
+
+> [!NOTE]
+> **AI-Generated Documentation:** This README was drafted with the assistance of AI, but none of the Code in this Project was written by AI.
+
+Welcome to the **BackupArr** repository. This project is currently in its early development stages (**Pre-Alpha**) and aims to provide a lightweight, efficient way to "back up" your media library without duplicating large video files.
+
+---
+
+## The Concept
+Traditional backups for media libraries are often prohibitively expensive due to massive file sizes. **BackupArr** changes the paradigm: instead of backing up the media files themselves, this tool maps your library metadata back to its source. In the event of data loss, you can restore the library state to your download client to re-acquire the media from the swarm.
+
+---
+
+## Project Status: Alpha
+**Warning:** This software is experimental and **Work in Progress**. It is not recommended for production use. Any and all code are subject to radical changes as development progresses.
+
+---
+
+## Getting Started (Development)
+
+1.  **Clone the repository:**
+    ```bash
+    git clone https://github.com/DanielMayhan/BackupArr.git
+    cd BackupArr
+    ```
+
+2.  **Configure Environment:**
+    Copy the sample configuration and add your Radarr API key & Url.
+    ```bash
+    cp .env.example .env
+    ```
+    
+---
+
+## Usage
+* **Command Structure:**
+    ```bash
+    python3 main.py [backup|restore] [radarr|sonarr] [filename].json
+* **Example Command:**
+    ```bash
+    python3 main.py backup radarr radarr_backup.json
+    ```
+
+---
+
+## Roadmap
+These are features and code changes that are either currently being worked on or are planned to be implemented later!
+* Code Cleanup
+* Unification of all text in-/outputs
+
+
+---
+
+## Contributing
+We welcome all input during these early stages!
+* Open an **Issue** to discuss new ideas or report bugs.
+* Submit a **Pull Request** to help with early-stage logic.
+* Check the **Discussions** tab to help define the project roadmap.
+
+---
+
+## License
+This project is licensed under the [MIT License](LICENSE).

backuparr-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+backuparr/api_stuff.py,sha256=3c9nbGqQdBb2NlA-1r7k_TDVB3JWWazmerqUpfCGb80,672
+backuparr/backup.py,sha256=0BobcvkgrG_BZ31VdtV4jxQbzFdf30IB1ndlCSPBuvE,2122
+backuparr/functions.py,sha256=ITWUZ8sqh1R53rKQzanlsV2tQ-2VGSQBMhy3GO4Pp6o,5829
+backuparr/main.py,sha256=tM5XcqsACQi6fieOus1ZmqNow0eeg-azWlWHl-7cUMA,711
+backuparr/restore.py,sha256=Ju5wslj0dYc7HXyuKJUYaZeRvmzcoGbs-2oNmLUMCjE,3955
+backuparr-0.1.0.dist-info/licenses/LICENSE,sha256=DVzZw-LqmvfYKYrA3s8rfstBmVXqcqCjMkH_SY9pCRA,1069
+backuparr-0.1.0.dist-info/METADATA,sha256=Ptrgv9T7e3jdowZffgx771DuzaDfRiJH7W2BxfMHpz0,3651
+backuparr-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+backuparr-0.1.0.dist-info/entry_points.txt,sha256=zxz1ZgnkPWIUYTEv-AjdMQ9Dblmu612NROyliyyX7rg,49
+backuparr-0.1.0.dist-info/top_level.txt,sha256=afh1QB7ZvxyUeEALqhf2HUAlCmRAlNMqfnNFTeOUjQs,10
+backuparr-0.1.0.dist-info/RECORD,,

backuparr-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

backuparr-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+backuparr = backuparr.main:run

backuparr-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DanielMayhan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

backuparr-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+backuparr