Method doChannelDownloads

server/modules/downloadModule.js:164–210

(jobData = {}, isNextJob = false)

  }

  async doChannelDownloads(jobData = {}, isNextJob = false) {
    const overrideSettings = this.getOverrideSettings(jobData);
    const overrideResolution = overrideSettings.resolution || null;
    const channelDownloadGrouper = require('./channelDownloadGrouper');

    try {
      const groups = await channelDownloadGrouper.generateDownloadGroups(overrideResolution);

      if (!groups || groups.length === 0) {
        // No enabled channels or failed to resolve groups - fall back to single job behavior
        return await this.doSingleChannelDownloadJob(jobData, isNextJob);
      }

      const effectiveGlobalQuality =
        overrideResolution || configModule.config.preferredResolution || '1080';

      // We need grouping when:
      // - Multiple distinct groups exist (different quality or subfolders or filters)
      // - Any group has a custom subfolder
      // - Any group has a quality that differs from the effective global quality
      // - Any group has download filters (duration or title regex)
      const needsGrouping =
        groups.length > 1 ||
        groups.some((g) => g.subFolder !== null) ||
        groups.some((g) => g.quality !== effectiveGlobalQuality) ||
        groups.some((g) => g.filterConfig && g.filterConfig.hasGroupingCriteria && g.filterConfig.hasGroupingCriteria());

      if (needsGrouping) {
        logger.info({ groupCount: groups.length }, 'Using grouped downloads with resolved settings');
        return await this.doGroupedChannelDownloads(jobData, groups, isNextJob);
      }

      // Single group with uniform settings – reuse the existing single-job flow but
      // ensure we pass along the resolved quality so overrides are respected.
      const singleGroup = groups[0];
      const jobDataWithQuality = {
        ...jobData,
        effectiveQuality: singleGroup?.quality || effectiveGlobalQuality,
      };
      this.setJobDataValue(jobDataWithQuality, 'effectiveQuality', jobDataWithQuality.effectiveQuality);

      return await this.doSingleChannelDownloadJob(jobDataWithQuality, isNextJob);
    } catch (err) {
      console.error('Error generating channel download groups, falling back to single job:', err);
      return await this.doSingleChannelDownloadJob(jobData, isNextJob);
    }
  }

  /**
   * Trigger channel downloads, then enqueue auto-download for every enabled