Fix 236 ruff lint errors blocking CI

- Add missing validate_path imports to 7 route files (F821)
- Auto-fix import sorting across all route/core files (I001)
- Remove unused imports (F401)
- Prefix unused variables with underscore (F841)

Author: SysAdminDoc

opencut/core/ai_dubbing.py

@@ -7,18 +7,14 @@
 Supports 50+ languages via pluggable translation and TTS backends.
 """
 
-import json
 import logging
 import os
-import subprocess
 import tempfile
 from dataclasses import dataclass, field
 from typing import Callable, Dict, List, Optional, Tuple
 
 from opencut.helpers import (
     FFmpegCmd,
-    ensure_package,
-    get_ffmpeg_path,
     get_video_info,
     output_path,
     run_ffmpeg,
@@ -216,7 +212,7 @@ def _generate_tts(
     # Try voice generation module
     try:
         from opencut.core.voice_gen import generate_voice
-        result = generate_voice(
+        generate_voice(
             text=text,
             output_path=output_audio,
             language=target_lang,
@@ -232,7 +228,7 @@ def _generate_tts(
         dur = max(1.0, target_duration)
         cmd = (FFmpegCmd()
                .option("f", "lavfi")
-               .input(f"anullsrc=r=16000:cl=mono", t=str(dur))
+               .input("anullsrc=r=16000:cl=mono", t=str(dur))
                .audio_codec("pcm_s16le")
                .output(output_audio)
                .build())

opencut/core/audio_anon.py

@@ -9,15 +9,14 @@
 advanced processing.
 """
 
-import json
 import logging
 import os
 import subprocess
 import tempfile
-from dataclasses import asdict, dataclass, field
-from typing import Callable, Dict, List, Optional
+from dataclasses import asdict, dataclass
+from typing import Callable, List, Optional
 
-from opencut.helpers import get_ffmpeg_path, get_ffprobe_path, get_video_info, output_path, run_ffmpeg
+from opencut.helpers import get_ffmpeg_path, get_video_info, output_path, run_ffmpeg
 
 logger = logging.getLogger("opencut")
 
@@ -63,7 +62,6 @@ def _diarize_simple(input_path: str, num_speakers: int = 2) -> List[SpeakerSegme
     result = subprocess.run(cmd, capture_output=True, text=True, timeout=300, check=False)
 
     segments = []
-    speech_start = 0.0
     speaker_idx = 0
     current_start = 0.0
 
@@ -142,7 +140,6 @@ def _pitch_shift_segment(
 
     # Use asetrate + atempo for simple pitch shift
     # Raising pitch by semitones: rate_factor = 2^(semitones/12)
-    import math
     rate_factor = 2 ** (semitones / 12.0)
     tempo_factor = 1.0 / rate_factor  # compensate to keep duration
 
@@ -270,7 +267,6 @@ def anonymize_speaker(
     try:
         # Create pitch-shifted version of full audio
         shifted_path = os.path.join(tmpdir, "shifted.wav")
-        import math
         rate_factor = 2 ** (pitch_semitones / 12.0)
         tempo_factor = 1.0 / rate_factor
 

opencut/core/auto_dub_pipeline.py

@@ -494,7 +494,7 @@ def _apply_lip_sync(
     _stage_progress(on_progress, STAGE_LIP_SYNC, 0, "Applying lip sync...")
 
     try:
-        from opencut.core.lip_sync_gen import apply_lip_sync, LipSyncConfig
+        from opencut.core.lip_sync_gen import LipSyncConfig, apply_lip_sync
 
         os.path.join(work_dir, "lip_synced.mp4")
         config = LipSyncConfig()

opencut/core/bg_replace_ai.py

@@ -53,9 +53,9 @@ class BGReplaceResult:
 
 def _remove_bg_rembg(frame):
     """Remove background from a single frame using rembg."""
-    from rembg import remove
     import numpy as np
     from PIL import Image
+    from rembg import remove
 
     pil_img = Image.fromarray(frame[:, :, ::-1])  # BGR -> RGB
     result = remove(pil_img)
@@ -194,14 +194,13 @@ def replace_background(
         raise RuntimeError("opencv-python-headless is required")
 
     import cv2
-    import numpy as np
 
     out = output_path_override or output_path(video_path, f"bg_{bg_type}")
 
     if on_progress:
         on_progress(5, "Preparing background replacement...")
 
-    info = get_video_info(video_path)
+    get_video_info(video_path)
 
     # Determine removal method
     actual_removal = removal_method

opencut/core/broll_ai_gen.py

@@ -405,8 +405,8 @@ def _try_video_gen_api(prompt: str, config: BRollGenConfig,
         return None
 
     try:
-        import urllib.request
         import urllib.error
+        import urllib.request
 
         payload = {
             "prompt": _enhance_prompt(prompt, config.style_prompt_suffix),

opencut/core/chromatic_aberration.py

@@ -10,18 +10,15 @@
 Uses FFmpeg's chromashift and scale filters.
 """
 
-import json
 import logging
-import math
 import os
 import subprocess
 import tempfile
-from dataclasses import dataclass, field
-from typing import Callable, Dict, List, Optional, Tuple
+from dataclasses import dataclass
+from typing import Callable, Optional, Tuple
 
 from opencut.helpers import (
     FFmpegCmd,
-    get_ffprobe_path,
     get_video_info,
     output_path,
     run_ffmpeg,

opencut/core/composition_guide.py

@@ -17,10 +17,7 @@
 from opencut.helpers import (
     ensure_package,
     get_ffmpeg_path,
-    get_ffprobe_path,
     get_video_info,
-    output_path,
-    run_ffmpeg,
 )
 
 logger = logging.getLogger("opencut")

opencut/core/content_calendar.py

@@ -8,7 +8,6 @@
 import csv
 import logging
 import os
-import re
 from dataclasses import dataclass, field
 from datetime import datetime, timedelta
 from typing import Callable, Dict, List, Optional
@@ -123,7 +122,7 @@ def _distribute_posts(
     # If items have no platform, distribute evenly
     unassigned = [it for it in items if not it.platform]
     if unassigned and platforms:
-        per_platform = max(1, len(unassigned) // len(platforms))
+        max(1, len(unassigned) // len(platforms))
         for i, item in enumerate(unassigned):
             p = platforms[i % len(platforms)]
             if p not in platform_queues:
@@ -219,7 +218,7 @@ def _export_ics(posts: List[ScheduledPost], output_path: str) -> str:
             f"SUMMARY:{summary}",
             f"DESCRIPTION:{description}",
             f"CATEGORIES:{post.platform.upper()}",
-            f"STATUS:CONFIRMED",
+            "STATUS:CONFIRMED",
             "END:VEVENT",
         ])
 

opencut/core/deinterlace.py

@@ -18,7 +18,6 @@
     FFmpegCmd,
     get_ffmpeg_path,
     get_ffprobe_path,
-    get_video_info,
     output_path,
     run_ffmpeg,
 )

opencut/core/delivery_validate.py

@@ -13,7 +13,7 @@
 import re
 import subprocess as _sp
 from dataclasses import asdict, dataclass, field
-from typing import Callable, Dict, List, Optional, Any
+from typing import Any, Callable, Dict, List, Optional
 
 from opencut.helpers import (
     get_ffmpeg_path,