qBitrr2 5.6.1__tar.gz → 5.6.2__tar.gz

qbitrr2-5.6.2/PKG-INFO

@@ -0,0 +1,260 @@
+Metadata-Version: 2.4
+Name: qBitrr2
+Version: 5.6.2
+Summary: Intelligent automation for qBittorrent and *Arr apps (Radarr/Sonarr/Lidarr) - health monitoring, instant imports, quality upgrades, request integration
+Home-page: https://github.com/Feramance/qBitrr
+Author: Feramance
+Author-email: fera@fera.wtf
+License: MIT
+Project-URL: Homepage, https://github.com/Feramance/qBitrr
+Project-URL: Documentation, https://feramance.github.io/qBitrr/
+Project-URL: Issue Tracker, https://github.com/Feramance/qBitrr/issues
+Project-URL: Source Code, https://github.com/Feramance/qBitrr
+Project-URL: Changelog, https://github.com/Feramance/qBitrr/blob/master/CHANGELOG.md
+Project-URL: Docker Hub, https://hub.docker.com/r/feramance/qbitrr
+Project-URL: PyPI, https://pypi.org/project/qBitrr2/
+Project-URL: Systemd Guide, https://feramance.github.io/qBitrr/getting-started/installation/systemd/
+Keywords: qbittorrent,radarr,sonarr,lidarr,arr,automation,torrent,media,plex,jellyfin,overseerr,ombi
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Communications
+Classifier: Topic :: Internet
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: <4,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cachetools
+Requires-Dist: colorama
+Requires-Dist: coloredlogs
+Requires-Dist: flask
+Requires-Dist: environ-config
+Requires-Dist: ffmpeg-python
+Requires-Dist: jaraco.docker
+Requires-Dist: packaging
+Requires-Dist: pathos
+Requires-Dist: peewee
+Requires-Dist: ping3
+Requires-Dist: pyarr
+Requires-Dist: qbittorrent-api
+Requires-Dist: requests
+Requires-Dist: tomlkit
+Requires-Dist: waitress
+Requires-Dist: croniter
+Provides-Extra: dev
+Requires-Dist: black==24.3.0; extra == "dev"
+Requires-Dist: bump2version==1.0.1; extra == "dev"
+Requires-Dist: isort==5.10.1; extra == "dev"
+Requires-Dist: pip-tools==7.3.0; extra == "dev"
+Requires-Dist: pre-commit==3.3.3; extra == "dev"
+Requires-Dist: pyinstaller==5.13.1; extra == "dev"
+Requires-Dist: pyupgrade==2.31.0; extra == "dev"
+Requires-Dist: twine==3.7.1; extra == "dev"
+Requires-Dist: ujson==5.10.0; extra == "dev"
+Requires-Dist: upgrade-pip==0.1.4; extra == "dev"
+Provides-Extra: fast
+Requires-Dist: ujson==5.10.0; extra == "fast"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.3; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5.0; extra == "docs"
+Requires-Dist: mkdocs-material-extensions>=1.3.0; extra == "docs"
+Requires-Dist: mkdocs-git-revision-date-localized-plugin>=1.2.0; extra == "docs"
+Requires-Dist: mkdocs-minify-plugin>=0.7.0; extra == "docs"
+Requires-Dist: mkdocs-redirects>=1.2.0; extra == "docs"
+Requires-Dist: mkdocs-include-markdown-plugin>=6.0.0; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.0.0; extra == "docs"
+Requires-Dist: markdown-include>=0.8.0; extra == "docs"
+Provides-Extra: all
+Requires-Dist: black==24.3.0; extra == "all"
+Requires-Dist: bump2version==1.0.1; extra == "all"
+Requires-Dist: isort==5.10.1; extra == "all"
+Requires-Dist: pip-tools==7.3.0; extra == "all"
+Requires-Dist: pre-commit==3.3.3; extra == "all"
+Requires-Dist: pyinstaller==5.13.1; extra == "all"
+Requires-Dist: pyupgrade==2.31.0; extra == "all"
+Requires-Dist: twine==3.7.1; extra == "all"
+Requires-Dist: ujson==5.10.0; extra == "all"
+Requires-Dist: upgrade-pip==0.1.4; extra == "all"
+Requires-Dist: ujson==5.10.0; extra == "all"
+Requires-Dist: mkdocs>=1.5.3; extra == "all"
+Requires-Dist: mkdocs-material>=9.5.0; extra == "all"
+Requires-Dist: mkdocs-material-extensions>=1.3.0; extra == "all"
+Requires-Dist: mkdocs-git-revision-date-localized-plugin>=1.2.0; extra == "all"
+Requires-Dist: mkdocs-minify-plugin>=0.7.0; extra == "all"
+Requires-Dist: mkdocs-redirects>=1.2.0; extra == "all"
+Requires-Dist: mkdocs-include-markdown-plugin>=6.0.0; extra == "all"
+Requires-Dist: pymdown-extensions>=10.0.0; extra == "all"
+Requires-Dist: markdown-include>=0.8.0; extra == "all"
+Dynamic: license-file
+
+# <img src="assets/logov2-clean.png" alt="qBitrr Logo" width="40" style="vertical-align: middle;"/> qBitrr
+
+[![PyPI](https://img.shields.io/pypi/v/qBitrr2?label=PyPI)](https://pypi.org/project/qBitrr2/)
+[![Downloads](https://img.shields.io/pypi/dm/qBitrr2)](https://pypi.org/project/qBitrr2/)
+[![Docker Pulls](https://img.shields.io/docker/pulls/feramance/qbitrr.svg)](https://hub.docker.com/r/feramance/qbitrr)
+[![CodeQL](https://github.com/Feramance/qBitrr/actions/workflows/codeql.yml/badge.svg?branch=master)](https://github.com/Feramance/qBitrr/actions/workflows/codeql.yml)
+[![Nightly Build](https://github.com/Feramance/qBitrr/actions/workflows/nightly.yml/badge.svg?branch=master)](https://github.com/Feramance/qBitrr/actions/workflows/nightly.yml)
+[![pre-commit.ci](https://results.pre-commit.ci/badge/github/Feramance/qBitrr/master.svg)](https://results.pre-commit.ci/latest/github/Feramance/qBitrr/master)
+[![License: MIT](https://img.shields.io/pypi/l/qbitrr)](LICENSE)
+
+> 🧩 The intelligent glue between qBittorrent and the *Arr ecosystem (Radarr, Sonarr, Lidarr). Monitors torrent health, triggers instant imports, automates quality upgrades, manages disk space, integrates with request systems (Overseerr/Ombi), and provides a modern React dashboard for complete visibility and control.
+
+## 📚 Documentation
+
+**Full documentation is available at: https://feramance.github.io/qBitrr/**
+
+- [Getting Started](https://feramance.github.io/qBitrr/getting-started/) – Installation guides for pip, Docker, and native setups
+- [Configuration](https://feramance.github.io/qBitrr/configuration/) – qBittorrent, Arr instances, quality profiles, and more
+- [Features](https://feramance.github.io/qBitrr/features/) – Health monitoring, automated search, quality management, disk space, auto-updates
+- [WebUI](https://feramance.github.io/qBitrr/webui/) – Built-in React dashboard with live monitoring and config editor
+- [Troubleshooting](https://feramance.github.io/qBitrr/troubleshooting/) – Common issues and debug logging
+- [API Reference](https://feramance.github.io/qBitrr/reference/api/) – REST API documentation
+
+## ⚡ Quick Start
+
+### 🐍 Install with pip
+```bash
+python -m venv .venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install qBitrr2
+
+# First run creates ~/config/config.toml
+qbitrr
+```
+
+### 🐳 Run with Docker
+```bash
+docker run -d \
+  --name qbitrr \
+  --tty \
+  -e TZ=Europe/London \
+  -p 6969:6969 \
+  -v /path/to/appdata/qbitrr:/config \
+  -v /path/to/completed/downloads:/completed_downloads:rw \
+  --restart unless-stopped \
+  feramance/qbitrr:latest
+```
+
+**Docker Compose:**
+```yaml
+services:
+  qbitrr:
+    image: feramance/qbitrr:latest
+    container_name: qbitrr
+    restart: unless-stopped
+    tty: true
+    environment:
+      TZ: Europe/London
+    ports:
+      - "6969:6969"
+    volumes:
+      - /path/to/appdata/qbitrr:/config
+      - /path/to/completed/downloads:/completed_downloads:rw
+```
+
+Access the WebUI at `http://<host>:6969/ui` after startup.
+
+## ✨ Key Features
+
+- **🚑 Torrent Health Monitoring** – Detect stalled/failed downloads, auto-blacklist, trigger re-searches
+- **🔍 Automated Search** – Missing media, quality upgrades, custom format scoring
+- **🎯 Request Integration** – Pull requests from Overseerr/Ombi, prioritize user-requested media
+- **📊 Quality Management** – RSS sync, queue refresh, profile switching, custom format enforcement
+- **🌱 Seeding Control** – Per-tracker settings, ratio/time limits, tracker injection
+- **💾 Disk Space Management** – Auto-pause when low on space, configurable thresholds
+- **🔄 Auto-Updates** – GitHub release-based updates with scheduled cron support
+- **💻 Modern WebUI** – Live process monitoring, log viewer, Arr insights, config editor
+
+## 🛠️ Essential Configuration
+
+1. **Configure qBittorrent** in `~/config/config.toml`:
+   ```toml
+   [qBit]
+   Host = "localhost"
+   Port = 8080
+   UserName = "admin"
+   Password = "adminpass"
+   Version5 = true  # qBittorrent 5.x
+   ```
+
+2. **Add Arr instances**:
+   ```toml
+   [Radarr-Movies]
+   URI = "http://localhost:7878"
+   APIKey = "your-radarr-api-key"
+   Category = "radarr-movies"
+   ```
+
+3. **Set completed folder**:
+   ```toml
+   [Settings]
+   CompletedDownloadFolder = "/path/to/completed"
+   ```
+
+See [Configuration Guide](https://feramance.github.io/qBitrr/configuration/) and [config.example.toml](config.example.toml) for all available options.
+
+## 📖 Resources
+
+- **Documentation:** https://feramance.github.io/qBitrr/
+- **PyPI Package:** https://pypi.org/project/qBitrr2/
+- **Docker Hub:** https://hub.docker.com/r/feramance/qbitrr
+- **Example Config:** [config.example.toml](config.example.toml)
+- **API Documentation:** [API_DOCUMENTATION.md](API_DOCUMENTATION.md)
+- **Systemd Setup:** [SYSTEMD_SERVICE.md](SYSTEMD_SERVICE.md)
+
+## 🐛 Issues & Support
+
+- **Report Bugs:** [Bug Report Template](.github/ISSUE_TEMPLATE/bug_report.yml)
+- **Request Features:** [Feature Request Template](.github/ISSUE_TEMPLATE/feature_request.yml)
+- **Discussions:** [GitHub Discussions](https://github.com/Feramance/qBitrr/discussions)
+- **Troubleshooting:** [Common Issues](https://feramance.github.io/qBitrr/troubleshooting/)
+
+## 🤝 Contributing
+
+Contributions welcome! See [CONTRIBUTION.md](CONTRIBUTION.md) for coding guidelines and development setup.
+
+**Development setup:**
+```bash
+# Python backend
+make newenv && make syncenv
+make reformat  # Format and lint
+
+# WebUI
+cd webui && npm ci
+npm run dev    # Dev server at localhost:5173
+```
+
+## ❤️ Support
+
+If qBitrr saves you time and headaches:
+- ⭐ **Star the repo** – helps others discover qBitrr
+- 💰 **Sponsor:** [Patreon](https://patreon.com/qBitrr) | [PayPal](https://www.paypal.me/feramance)
+
+## 📄 License
+
+Released under the [MIT License](LICENSE). Use it, modify it, share it—commercially or personally.
+
+---
+
+<div align="center">
+
+**Made with ❤️ by the qBitrr community**
+
+[Documentation](https://feramance.github.io/qBitrr/) • [PyPI](https://pypi.org/project/qBitrr2/) • [Docker](https://hub.docker.com/r/feramance/qbitrr) • [GitHub](https://github.com/Feramance/qBitrr)
+
+</div>

qbitrr2-5.6.2/README.md

@@ -0,0 +1,156 @@
+# <img src="assets/logov2-clean.png" alt="qBitrr Logo" width="40" style="vertical-align: middle;"/> qBitrr
+
+[![PyPI](https://img.shields.io/pypi/v/qBitrr2?label=PyPI)](https://pypi.org/project/qBitrr2/)
+[![Downloads](https://img.shields.io/pypi/dm/qBitrr2)](https://pypi.org/project/qBitrr2/)
+[![Docker Pulls](https://img.shields.io/docker/pulls/feramance/qbitrr.svg)](https://hub.docker.com/r/feramance/qbitrr)
+[![CodeQL](https://github.com/Feramance/qBitrr/actions/workflows/codeql.yml/badge.svg?branch=master)](https://github.com/Feramance/qBitrr/actions/workflows/codeql.yml)
+[![Nightly Build](https://github.com/Feramance/qBitrr/actions/workflows/nightly.yml/badge.svg?branch=master)](https://github.com/Feramance/qBitrr/actions/workflows/nightly.yml)
+[![pre-commit.ci](https://results.pre-commit.ci/badge/github/Feramance/qBitrr/master.svg)](https://results.pre-commit.ci/latest/github/Feramance/qBitrr/master)
+[![License: MIT](https://img.shields.io/pypi/l/qbitrr)](LICENSE)
+
+> 🧩 The intelligent glue between qBittorrent and the *Arr ecosystem (Radarr, Sonarr, Lidarr). Monitors torrent health, triggers instant imports, automates quality upgrades, manages disk space, integrates with request systems (Overseerr/Ombi), and provides a modern React dashboard for complete visibility and control.
+
+## 📚 Documentation
+
+**Full documentation is available at: https://feramance.github.io/qBitrr/**
+
+- [Getting Started](https://feramance.github.io/qBitrr/getting-started/) – Installation guides for pip, Docker, and native setups
+- [Configuration](https://feramance.github.io/qBitrr/configuration/) – qBittorrent, Arr instances, quality profiles, and more
+- [Features](https://feramance.github.io/qBitrr/features/) – Health monitoring, automated search, quality management, disk space, auto-updates
+- [WebUI](https://feramance.github.io/qBitrr/webui/) – Built-in React dashboard with live monitoring and config editor
+- [Troubleshooting](https://feramance.github.io/qBitrr/troubleshooting/) – Common issues and debug logging
+- [API Reference](https://feramance.github.io/qBitrr/reference/api/) – REST API documentation
+
+## ⚡ Quick Start
+
+### 🐍 Install with pip
+```bash
+python -m venv .venv
+source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install qBitrr2
+
+# First run creates ~/config/config.toml
+qbitrr
+```
+
+### 🐳 Run with Docker
+```bash
+docker run -d \
+  --name qbitrr \
+  --tty \
+  -e TZ=Europe/London \
+  -p 6969:6969 \
+  -v /path/to/appdata/qbitrr:/config \
+  -v /path/to/completed/downloads:/completed_downloads:rw \
+  --restart unless-stopped \
+  feramance/qbitrr:latest
+```
+
+**Docker Compose:**
+```yaml
+services:
+  qbitrr:
+    image: feramance/qbitrr:latest
+    container_name: qbitrr
+    restart: unless-stopped
+    tty: true
+    environment:
+      TZ: Europe/London
+    ports:
+      - "6969:6969"
+    volumes:
+      - /path/to/appdata/qbitrr:/config
+      - /path/to/completed/downloads:/completed_downloads:rw
+```
+
+Access the WebUI at `http://<host>:6969/ui` after startup.
+
+## ✨ Key Features
+
+- **🚑 Torrent Health Monitoring** – Detect stalled/failed downloads, auto-blacklist, trigger re-searches
+- **🔍 Automated Search** – Missing media, quality upgrades, custom format scoring
+- **🎯 Request Integration** – Pull requests from Overseerr/Ombi, prioritize user-requested media
+- **📊 Quality Management** – RSS sync, queue refresh, profile switching, custom format enforcement
+- **🌱 Seeding Control** – Per-tracker settings, ratio/time limits, tracker injection
+- **💾 Disk Space Management** – Auto-pause when low on space, configurable thresholds
+- **🔄 Auto-Updates** – GitHub release-based updates with scheduled cron support
+- **💻 Modern WebUI** – Live process monitoring, log viewer, Arr insights, config editor
+
+## 🛠️ Essential Configuration
+
+1. **Configure qBittorrent** in `~/config/config.toml`:
+   ```toml
+   [qBit]
+   Host = "localhost"
+   Port = 8080
+   UserName = "admin"
+   Password = "adminpass"
+   Version5 = true  # qBittorrent 5.x
+   ```
+
+2. **Add Arr instances**:
+   ```toml
+   [Radarr-Movies]
+   URI = "http://localhost:7878"
+   APIKey = "your-radarr-api-key"
+   Category = "radarr-movies"
+   ```
+
+3. **Set completed folder**:
+   ```toml
+   [Settings]
+   CompletedDownloadFolder = "/path/to/completed"
+   ```
+
+See [Configuration Guide](https://feramance.github.io/qBitrr/configuration/) and [config.example.toml](config.example.toml) for all available options.
+
+## 📖 Resources
+
+- **Documentation:** https://feramance.github.io/qBitrr/
+- **PyPI Package:** https://pypi.org/project/qBitrr2/
+- **Docker Hub:** https://hub.docker.com/r/feramance/qbitrr
+- **Example Config:** [config.example.toml](config.example.toml)
+- **API Documentation:** [API_DOCUMENTATION.md](API_DOCUMENTATION.md)
+- **Systemd Setup:** [SYSTEMD_SERVICE.md](SYSTEMD_SERVICE.md)
+
+## 🐛 Issues & Support
+
+- **Report Bugs:** [Bug Report Template](.github/ISSUE_TEMPLATE/bug_report.yml)
+- **Request Features:** [Feature Request Template](.github/ISSUE_TEMPLATE/feature_request.yml)
+- **Discussions:** [GitHub Discussions](https://github.com/Feramance/qBitrr/discussions)
+- **Troubleshooting:** [Common Issues](https://feramance.github.io/qBitrr/troubleshooting/)
+
+## 🤝 Contributing
+
+Contributions welcome! See [CONTRIBUTION.md](CONTRIBUTION.md) for coding guidelines and development setup.
+
+**Development setup:**
+```bash
+# Python backend
+make newenv && make syncenv
+make reformat  # Format and lint
+
+# WebUI
+cd webui && npm ci
+npm run dev    # Dev server at localhost:5173
+```
+
+## ❤️ Support
+
+If qBitrr saves you time and headaches:
+- ⭐ **Star the repo** – helps others discover qBitrr
+- 💰 **Sponsor:** [Patreon](https://patreon.com/qBitrr) | [PayPal](https://www.paypal.me/feramance)
+
+## 📄 License
+
+Released under the [MIT License](LICENSE). Use it, modify it, share it—commercially or personally.
+
+---
+
+<div align="center">
+
+**Made with ❤️ by the qBitrr community**
+
+[Documentation](https://feramance.github.io/qBitrr/) • [PyPI](https://pypi.org/project/qBitrr2/) • [Docker](https://hub.docker.com/r/feramance/qbitrr) • [GitHub](https://github.com/Feramance/qBitrr)
+
+</div>

{qbitrr2-5.6.1 → qbitrr2-5.6.2}/pyproject.toml

@@ -28,7 +28,7 @@ target-version = ['py311']
 
 [tool.poetry]
 name = "pypi-public"
-version = "5.6.1"
+version = "5.6.2"
 description = "Intelligent automation for qBittorrent and *Arr apps (Radarr/Sonarr/Lidarr) - health monitoring, instant imports, quality upgrades, request integration"
 authors = ["Drapersniper", "Feramance"]
 readme = "README.md"

{qbitrr2-5.6.1 → qbitrr2-5.6.2}/qBitrr/arss.py

@@ -20,7 +20,7 @@ import qbittorrentapi
 import qbittorrentapi.exceptions
 import requests
 from packaging import version as version_parser
-from peewee import Model, SqliteDatabase
+from peewee import DatabaseError, Model, OperationalError, SqliteDatabase
 from pyarr import LidarrAPI, RadarrAPI, SonarrAPI
 from pyarr.exceptions import PyarrResourceNotFound, PyarrServerError
 from pyarr.types import JsonObject
@@ -4475,6 +4475,11 @@ class Arr:
                 if self.manager.qbit_manager.should_delay_torrent_scan:
                     raise DelayLoopException(length=NO_INTERNET_SLEEP_TIMER, type="delay")
 
+                # Initialize database error tracking for exponential backoff
+                if not hasattr(self, "_db_error_count"):
+                    self._db_error_count = 0
+                    self._db_last_error_time = 0
+
                 # Periodic database health check (every 10th iteration)
                 if not hasattr(self, "_health_check_counter"):
                     self._health_check_counter = 0
@@ -4516,6 +4521,76 @@ class Arr:
                 self.logger.error("The qBittorrent API returned an unexpected error")
                 self.logger.debug("Unexpected APIError from qBitTorrent")  # , exc_info=e)
                 raise DelayLoopException(length=300, type="qbit")
+            except (OperationalError, DatabaseError) as e:
+                # Database errors after retry exhaustion - implement automatic recovery with backoff
+                error_msg = str(e).lower()
+                current_time = time.time()
+
+                # Track consecutive database errors for exponential backoff
+                if (
+                    current_time - self._db_last_error_time > 300
+                ):  # Reset if >5min since last error
+                    self._db_error_count = 0
+                self._db_error_count += 1
+                self._db_last_error_time = current_time
+
+                # Calculate exponential backoff: 2min, 5min, 10min, 20min, 30min (max)
+                delay_seconds = min(120 * (2 ** (self._db_error_count - 1)), 1800)
+
+                # Log detailed error information based on error type
+                if "disk i/o error" in error_msg:
+                    self.logger.critical(
+                        "Persistent database I/O error detected (consecutive error #%d). "
+                        "This indicates disk issues, filesystem corruption, or resource exhaustion. "
+                        "Attempting automatic recovery and retrying in %d seconds...",
+                        self._db_error_count,
+                        delay_seconds,
+                    )
+                elif "database is locked" in error_msg:
+                    self.logger.error(
+                        "Database locked error (consecutive error #%d). "
+                        "Retrying in %d seconds...",
+                        self._db_error_count,
+                        delay_seconds,
+                    )
+                elif "disk image is malformed" in error_msg:
+                    self.logger.critical(
+                        "Database corruption detected (consecutive error #%d). "
+                        "Attempting automatic recovery and retrying in %d seconds...",
+                        self._db_error_count,
+                        delay_seconds,
+                    )
+                else:
+                    self.logger.error(
+                        "Database error (consecutive error #%d): %s. " "Retrying in %d seconds...",
+                        self._db_error_count,
+                        error_msg,
+                        delay_seconds,
+                    )
+
+                # Attempt automatic recovery for critical errors
+                if "disk i/o error" in error_msg or "disk image is malformed" in error_msg:
+                    try:
+                        self.logger.warning(
+                            "Attempting enhanced database recovery (WAL checkpoint, repair, and verification)..."
+                        )
+                        self._enhanced_database_recovery()
+                        self.logger.info(
+                            "Database recovery completed successfully - will retry operation after delay"
+                        )
+                        # Reduce error count on successful recovery (but don't reset completely)
+                        self._db_error_count = max(0, self._db_error_count - 1)
+                    except Exception as recovery_error:
+                        self.logger.critical(
+                            "Automatic database recovery failed: %s. "
+                            "MANUAL INTERVENTION REQUIRED: Check disk health (smartctl), "
+                            "filesystem integrity (fsck), available space (df -h), "
+                            "Docker volume mounts, permissions, and system logs (dmesg).",
+                            recovery_error,
+                        )
+
+                # Delay processing to avoid hammering failing database
+                raise DelayLoopException(length=delay_seconds, type="database")
             except DelayLoopException:
                 raise
             except KeyboardInterrupt:
@@ -4566,6 +4641,83 @@ class Arr:
             "Manual intervention may be required. Continuing with caution..."
         )
 
+    def _enhanced_database_recovery(self):
+        """
+        Enhanced automatic database recovery with additional filesystem checks.
+
+        This method is called when disk I/O errors persist after retry logic has been exhausted.
+        It implements a comprehensive recovery strategy:
+        1. Try WAL checkpoint (least invasive)
+        2. Try VACUUM to reclaim space and fix minor corruption
+        3. Try full database repair (dump/restore) if needed
+        4. Verify database integrity after recovery
+        """
+        from qBitrr.db_recovery import (
+            DatabaseRecoveryError,
+            checkpoint_wal,
+            repair_database,
+            vacuum_database,
+        )
+        from qBitrr.home_path import APPDATA_FOLDER
+
+        db_path = APPDATA_FOLDER / "qbitrr.db"
+
+        self.logger.info("Starting enhanced database recovery procedure...")
+
+        # Step 1: Try WAL checkpoint
+        self.logger.info("Step 1/3: Attempting WAL checkpoint...")
+        if checkpoint_wal(db_path, self.logger):
+            self.logger.info("WAL checkpoint successful")
+            # Try a quick health check
+            from qBitrr.db_lock import check_database_health
+
+            healthy, msg = check_database_health(db_path, self.logger)
+            if healthy:
+                self.logger.info("Database health verified - recovery complete")
+                return
+            else:
+                self.logger.warning(
+                    "WAL checkpoint completed but database still unhealthy: %s", msg
+                )
+
+        # Step 2: Try VACUUM (only if WAL didn't fully fix it)
+        self.logger.info("Step 2/3: Attempting VACUUM to reclaim space and fix minor issues...")
+        if vacuum_database(db_path, self.logger):
+            self.logger.info("VACUUM completed successfully")
+            from qBitrr.db_lock import check_database_health
+
+            healthy, msg = check_database_health(db_path, self.logger)
+            if healthy:
+                self.logger.info("Database health verified after VACUUM - recovery complete")
+                return
+            else:
+                self.logger.warning("VACUUM completed but database still unhealthy: %s", msg)
+
+        # Step 3: Try full repair (most invasive)
+        self.logger.warning("Step 3/3: Attempting full database repair (dump/restore)...")
+        try:
+            if repair_database(db_path, backup=True, logger_override=self.logger):
+                self.logger.info("Database repair successful")
+                # Final health check
+                from qBitrr.db_lock import check_database_health
+
+                healthy, msg = check_database_health(db_path, self.logger)
+                if healthy:
+                    self.logger.info("Database health verified after repair - recovery complete")
+                    return
+                else:
+                    self.logger.error("Repair completed but database still unhealthy: %s", msg)
+                    raise DatabaseRecoveryError(f"Database unhealthy after repair: {msg}")
+        except DatabaseRecoveryError as e:
+            self.logger.error("Database repair failed: %s", e)
+            raise
+        except Exception as e:
+            self.logger.error("Unexpected error during database repair: %s", e)
+            raise
+
+        # If we reach here, all recovery methods failed
+        raise DatabaseRecoveryError("All automatic recovery methods failed")
+
     def _process_single_torrent_failed_cat(self, torrent: qbittorrentapi.TorrentDictionary):
         self.logger.notice(
             "Deleting manually failed torrent: "

{qbitrr2-5.6.1 → qbitrr2-5.6.2}/qBitrr/bundled_data.py

@@ -1,5 +1,5 @@
-version = "5.6.1"
-git_hash = "db497bc6"
+version = "5.6.2"
+git_hash = "e39e0d1e"
 license_text = (
     "Licence can be found on:\n\nhttps://github.com/Feramance/qBitrr/blob/master/LICENSE"
 )