feat: added audio normalization flag for ffmpeg/encoding

style: Made window buttons smaller. removed rounding.

fix: Implemented fixes for other subtitle providers. Still can be finicky. SubDL doesn't like my API keys. Other web scrappers don't work too well.

Author: SirStig

EncodeForge/src/main/java/com/encodeforge/MainApp.java

@@ -85,15 +85,20 @@ public void init() throws Exception {
         }
 
         // Check if dependencies are installed
+        // ALWAYS check on every startup to detect newly-added requirements (e.g., bs4, lxml)
         Map<String, Boolean> libStatus = dependencyManager.checkRequiredLibraries().get();
         boolean allLibsInstalled = libStatus.values().stream().allMatch(v -> v);
         boolean ffmpegInstalled = dependencyManager.checkFFmpeg().get();
 
         logger.info("Dependency status:");
         logger.info("  Python libraries: {}", allLibsInstalled ? "✓" : "✗");
+        libStatus.forEach((lib, installed) -> 
+            logger.info("    - {}: {}", lib, installed ? "✓" : "✗"));
         logger.info("  FFmpeg: {}", ffmpegInstalled ? "✓" : "✗");
 
         // If anything is missing, show initialization dialog on startup
+        // This ensures new libraries (like bs4/lxml) get installed even if
+        // the app was previously initialized
         if (!allLibsInstalled || !ffmpegInstalled) {
             logger.info("Some dependencies missing, will show initialization dialog");
             pendingDependencyInstall = true;

EncodeForge/src/main/java/com/encodeforge/controller/MainController.java

@@ -170,6 +170,7 @@ private enum ResizeDirection {
     @FXML private ComboBox<String> quickQualityCombo;
     @FXML private ComboBox<String> quickPresetCombo;
     @FXML private CheckBox quickHwAccelCheck;
+    @FXML private CheckBox quickAudioNormalizeCheck;
     @FXML private CheckBox quickDownloadSubsCheck;
     @FXML private CheckBox quickRenameCheck;
     @FXML private Button configSubtitlesButton;
@@ -3101,6 +3102,10 @@ private void updateSettingsFromQuickUI() {
             settings.setHardwareDecoding(quickHwAccelCheck.isSelected());
         }
 
+        if (quickAudioNormalizeCheck != null) {
+            settings.setAudioNormalize(quickAudioNormalizeCheck.isSelected());
+        }
+        
         if (quickDownloadSubsCheck != null) {
             settings.setDownloadSubtitles(quickDownloadSubsCheck.isSelected());
         }
@@ -3716,6 +3721,11 @@ private void setupQuickSettings() {
             logger.debug("Loaded saved hardware acceleration: {}", settings.isHardwareDecoding());
         }
 
+        if (quickAudioNormalizeCheck != null) {
+            quickAudioNormalizeCheck.setSelected(settings.isAudioNormalize());
+            logger.debug("Loaded saved audio normalize: {}", settings.isAudioNormalize());
+        }
+        
         if (quickDownloadSubsCheck != null) {
             quickDownloadSubsCheck.setSelected(false);
         }

EncodeForge/src/main/java/com/encodeforge/controller/SettingsController.java

@@ -98,6 +98,7 @@ public class SettingsController {
     @FXML private RadioButton audioLanguageRadio;
     @FXML private TextField audioLanguageField;
     @FXML private ComboBox<String> audioBitrateCombo;
+    @FXML private CheckBox audioNormalizeCheck;
 
     // Subtitle Settings
     @FXML private CheckBox convertSubsCheck;
@@ -397,6 +398,7 @@ private void loadSettings() {
         crfSpinner.getValueFactory().setValue(settings.getNvencCq());
 
         audioCodecCombo.setValue(settings.getAudioCodec());
+        audioNormalizeCheck.setSelected(settings.isAudioNormalize());
 
         convertSubsCheck.setSelected(settings.isConvertSubtitles());
         subtitleFormatCombo.setValue(settings.getSubtitleFormat());
@@ -458,6 +460,7 @@ private void saveSettings() {
         settings.setNvencCq(crfSpinner.getValue());
 
         settings.setAudioCodec(audioCodecCombo.getValue());
+        settings.setAudioNormalize(audioNormalizeCheck.isSelected());
 
         settings.setConvertSubtitles(convertSubsCheck.isSelected());
         settings.setSubtitleFormat(subtitleFormatCombo.getValue());

EncodeForge/src/main/java/com/encodeforge/model/ConversionSettings.java

@@ -66,6 +66,7 @@ public class ConversionSettings {
     private String audioTrackSelection = "all";
     private String audioLanguages = "eng";
     private String audioBitrate = "Auto";
+    private boolean audioNormalize = false;
 
     // Subtitle settings
     private boolean convertSubtitles = true;
@@ -178,6 +179,9 @@ public class ConversionSettings {
     public String getAudioBitrate() { return audioBitrate; }
     public void setAudioBitrate(String audioBitrate) { this.audioBitrate = audioBitrate; }
 
+    public boolean isAudioNormalize() { return audioNormalize; }
+    public void setAudioNormalize(boolean audioNormalize) { this.audioNormalize = audioNormalize; }
+    
     public boolean isConvertSubtitles() { return convertSubtitles; }
     public void setConvertSubtitles(boolean convertSubtitles) { this.convertSubtitles = convertSubtitles; }
 
@@ -439,6 +443,7 @@ public JsonObject toJson() {
         json.addProperty("audio_track_selection", audioTrackSelection);
         json.addProperty("audio_languages", audioLanguages);
         json.addProperty("audio_bitrate", audioBitrate);
+        json.addProperty("audio_normalize", audioNormalize);
 
         // Subtitles
         json.addProperty("convert_subtitles", convertSubtitles);

EncodeForge/src/main/resources/fxml/MainView.fxml

@@ -232,6 +232,7 @@
                             <Label text="Processing Options" styleClass="group-label"/>
                             <HBox spacing="15">
                                 <CheckBox fx:id="quickHwAccelCheck" text="Hardware Acceleration" styleClass="quick-check" selected="true"/>
+                                <CheckBox fx:id="quickAudioNormalizeCheck" text="Normalize Audio" styleClass="quick-check"/>
                                 <CheckBox fx:id="quickDownloadSubsCheck" text="Download Subtitles" styleClass="quick-check" disable="true"/>
                                 <CheckBox fx:id="quickRenameCheck" text="Rename Files" styleClass="quick-check" disable="true"/>
                             </HBox>

EncodeForge/src/main/resources/fxml/SettingsDialog.fxml

@@ -175,6 +175,13 @@
                         <Label text="Audio Bitrate:" styleClass="setting-label"/>
                         <ComboBox fx:id="audioBitrateCombo" maxWidth="Infinity"/>
                     </VBox>
+                    
+                    <Separator/>
+                    
+                    <VBox spacing="10">
+                        <CheckBox fx:id="audioNormalizeCheck" text="Normalize audio volume" selected="false"/>
+                        <Label text="Automatically adjust audio levels to a consistent volume across all files" styleClass="hint-label"/>
+                    </VBox>
                 </VBox>
 
                 <!-- Subtitle Settings -->

EncodeForge/src/main/resources/python/encodeforge_api.py

@@ -163,6 +163,7 @@ def __init__(self):
             # Audio settings
             self.audio_codec = "copy"
             self.audio_bitrate = None
+            self.normalize_audio = False
 
             # General settings
             self.output_format = "mp4"
@@ -1491,6 +1492,8 @@ def update_settings(self, settings_dict: Dict):
                 self.settings.audio_bitrate = bitrate
             else:
                 self.settings.audio_bitrate = None
+        if "audio_normalize" in settings_dict:
+            self.settings.normalize_audio = settings_dict["audio_normalize"]
         if "audio_languages" in settings_dict:
             # Store for potential future use
             pass

EncodeForge/src/main/resources/python/encodeforge_modules/conversion_handler.py

@@ -510,6 +510,11 @@ def _retry_with_software_encoder(self, input_file: Path, output_path_obj: Path,
             if self.settings.audio_bitrate:
                 cmd.extend(["-b:a", self.settings.audio_bitrate])
 
+        # Add audio normalization filter
+        if self.settings.normalize_audio:
+            logger.info("Applying audio normalization (loudnorm)")
+            cmd.extend(["-af", "loudnorm=I=-16:TP=-1.5:LRA=11"])
+        
         # Add faststart for MP4
         if self.settings.use_faststart and self.settings.output_format in ["mp4", "m4v"]:
             cmd.extend(["-movflags", "+faststart"])
@@ -722,6 +727,11 @@ def convert_file(
                 if self.settings.audio_bitrate and self.settings.audio_bitrate != "Auto":
                     cmd.extend(["-b:a", self.settings.audio_bitrate])
 
+            # Add audio normalization filter
+            if self.settings.normalize_audio:
+                logger.info("Applying audio normalization (loudnorm)")
+                cmd.extend(["-af", "loudnorm=I=-16:TP=-1.5:LRA=11"])
+            
             # Subtitle handling with comprehensive format support
             temp_subtitle_files = []
             subtitle_tracks = []  # Initialize to avoid unbound variable

EncodeForge/src/main/resources/python/subtitle_providers/subdl_provider.py

@@ -2,7 +2,7 @@
 """
 SubDL Provider
 Good for movies and TV shows with free API
-Updated to use latest API structure
+Updated to use latest API structure with web scraping fallback
 """
 
 import gzip
@@ -16,6 +16,13 @@
 from io import BytesIO
 from typing import Dict, List
 
+try:
+    from bs4 import BeautifulSoup
+    BS4_AVAILABLE = True
+except ImportError:
+    BS4_AVAILABLE = False
+    logging.getLogger(__name__).warning("BeautifulSoup not available for SubDL web scraping fallback")
+
 from .base_provider import BaseSubtitleProvider
 
 logger = logging.getLogger(__name__)
@@ -27,6 +34,9 @@ class SubDLProvider(BaseSubtitleProvider):
     def __init__(self):
         super().__init__()
         self.provider_name = "SubDL"
+        # SubDL provides free API keys without login (no rate limits on free keys)
+        # This key was obtained from their website and works without authentication
+        self.api_key = "0kzwwW12CndUyeuPru5DtdRwpIXfH9H9"
 
     def search(self, video_path: str, languages: List[str]) -> List[Dict]:
         """Search SubDL (subdl.com) - improved API integration"""
@@ -70,7 +80,7 @@ def search(self, video_path: str, languages: List[str]) -> List[Dict]:
             if season and episode:
                 url = f"https://api.subdl.com/api/v1/subtitles"
                 params = {
-                    'api_key': 'free',
+                    'api_key': self.api_key,
                     'film_name': search_term,
                     'type': 'tv',
                     'season_number': str(season),
@@ -86,7 +96,7 @@ def search(self, video_path: str, languages: List[str]) -> List[Dict]:
                 # Also try with episode in the name
                 search_with_ep = f"{search_term} S{season:02d}E{episode:02d}"
                 params2 = {
-                    'api_key': 'free',
+                    'api_key': self.api_key,
                     'film_name': search_with_ep,
                     'languages': ','.join(subdl_languages)
                 }
@@ -99,7 +109,7 @@ def search(self, video_path: str, languages: List[str]) -> List[Dict]:
                 # Movie search
                 url = f"https://api.subdl.com/api/v1/subtitles"
                 params = {
-                    'api_key': 'free',
+                    'api_key': self.api_key,
                     'film_name': search_term,
                     'type': 'movie',
                     'languages': ','.join(subdl_languages)
@@ -114,7 +124,7 @@ def search(self, video_path: str, languages: List[str]) -> List[Dict]:
 
                 # Also try without specifying type
                 params_general = {
-                    'api_key': 'free',
+                    'api_key': self.api_key,
                     'film_name': search_term,
                     'languages': ','.join(subdl_languages)
                 }
@@ -167,11 +177,20 @@ def search(self, video_path: str, languages: List[str]) -> List[Dict]:
 
                 except urllib.error.HTTPError as e:
                     logger.warning(f"SubDL HTTP error {e.code}: {e.reason}")
+                    if e.code == 403:
+                        logger.info("SubDL API returned 403, will try web scraping fallback")
                     continue
                 except Exception as e:
                     logger.warning(f"SubDL search failed: {e}")
                     continue
 
+            # If API failed (403 or no results), try web scraping fallback
+            if (not data or not data.get('subtitles')) and BS4_AVAILABLE:
+                logger.info("SubDL API search failed, trying web scraping fallback...")
+                results = self._search_web_fallback(search_term, season, episode, subdl_languages)
+                if results:
+                    return results
+            
             if not data or not data.get('subtitles'):
                 logger.info("SubDL: No results found after all search strategies")
                 return results
@@ -218,6 +237,102 @@ def search(self, video_path: str, languages: List[str]) -> List[Dict]:
 
         return results
 
+    def _search_web_fallback(self, search_term: str, season, episode, languages: List[str]) -> List[Dict]:
+        """Web scraping fallback when API returns 403"""
+        results = []
+        
+        if not BS4_AVAILABLE:
+            return results
+        
+        try:
+            # Build search URL
+            query = search_term.replace(' ', '-').lower()
+            if season and episode:
+                search_url = f"https://subdl.com/subtitle/{query}/english"
+            else:
+                search_url = f"https://subdl.com/subtitle/{query}/english"
+            
+            logger.info(f"SubDL web scraping: {search_url}")
+            
+            headers = {
+                'User-Agent': self.session_headers['User-Agent'],
+                'Accept': 'text/html,application/xhtml+xml',
+                'Accept-Language': 'en-US,en;q=0.9'
+            }
+            
+            req = urllib.request.Request(search_url, headers=headers)
+            time.sleep(1.0)  # Be respectful
+            
+            with urllib.request.urlopen(req, timeout=15) as response:
+                html = response.read().decode('utf-8', errors='ignore')
+            
+            soup = BeautifulSoup(html, 'html.parser')
+            
+            # Find subtitle entries
+            subtitle_entries = soup.find_all('div', class_='item') or soup.find_all('a', class_='subtitle-entry')
+            
+            for entry in subtitle_entries[:20]:
+                try:
+                    # Extract subtitle info from web page
+                    name_elem = entry.find('h5') or entry.find('span', class_='title') or entry.find('a')
+                    if not name_elem:
+                        continue
+                    
+                    file_name = name_elem.get_text(strip=True)
+                    
+                    # Get download link
+                    link_elem = entry.find('a', href=True)
+                    if link_elem:
+                        download_url = link_elem['href']
+                        if not download_url.startswith('http'):
+                            download_url = 'https://subdl.com' + download_url
+                    else:
+                        download_url = ''
+                    
+                    # Extract file ID from URL
+                    file_id = download_url.split('/')[-1] if download_url else ''
+                    
+                    # Try to extract language
+                    lang_elem = entry.find('span', class_='language') or entry.find('span', class_='lang')
+                    lang_code = 'en'  # default
+                    if lang_elem:
+                        lang_text = lang_elem.get_text(strip=True).lower()
+                        if 'spanish' in lang_text or 'español' in lang_text:
+                            lang_code = 'es'
+                        elif 'french' in lang_text or 'français' in lang_text:
+                            lang_code = 'fr'
+                        elif 'german' in lang_text or 'deutsch' in lang_text:
+                            lang_code = 'de'
+                    
+                    # Filter by season/episode if TV show
+                    if season and episode:
+                        se_pattern = f"s{season:02d}e{episode:02d}"
+                        if se_pattern not in file_name.lower():
+                            continue
+                    
+                    results.append({
+                        "provider": "SubDL",
+                        "file_name": file_name,
+                        "language": lang_code,
+                        "downloads": 0,
+                        "rating": 0,
+                        "file_id": file_id,
+                        "download_url": download_url,
+                        "movie_name": search_term,
+                        "format": "srt"
+                    })
+                    
+                except Exception as e:
+                    logger.debug(f"Error parsing SubDL web entry: {e}")
+                    continue
+            
+            logger.info(f"SubDL web scraping found {len(results)} subtitle(s)")
+            
+        except Exception as e:
+            logger.warning(f"SubDL web scraping failed: {e}")
+        
+        return results
+    
     def download(self, file_id: str, download_url: str, output_path: str) -> tuple:
         """Download from SubDL - improved with ZIP handling"""
         try: