Skip to content

Group TV into single folder#18

Merged
Betanu701 merged 4 commits intofeature-utilize-dvd-label-batch-processingfrom
feature/move-tv-to-single-folder
Oct 19, 2025
Merged

Group TV into single folder#18
Betanu701 merged 4 commits intofeature-utilize-dvd-label-batch-processingfrom
feature/move-tv-to-single-folder

Conversation

@Betanu701
Copy link
Copy Markdown
Owner

This pull request introduces a new opt-in feature for organizing TV series discs under a parent series folder, alongside comprehensive documentation updates and supporting code changes. The main goal is to improve folder structure consistency for multi-disc TV series, making libraries more organized and compatible with media servers. The changes include a new configuration option (GROUP_TV_DISCS_UNDER_SERIES), database migration, logic updates for folder creation, and extensive documentation for both users and developers.

New Feature: TV Series Folder Grouping

  • Added a GROUP_TV_DISCS_UNDER_SERIES configuration option that, when enabled, groups all discs of a TV series under a parent folder named after the series (with year), with each disc as a subfolder. This works independently or in combination with the existing USE_DISC_LABEL_FOR_TV feature. [1] [2]

Database and Model Updates

  • Introduced a new database migration to add the GROUP_TV_DISCS_UNDER_SERIES boolean column to the config table and updated the model in config.py accordingly. [1] [2] [3]

Folder Structure Logic

  • Modified the ripper logic in arm_ripper.py to construct output paths based on the new configuration, ensuring discs are grouped under the correct parent folder when the feature is enabled. [1] [2]
  • Added a utility function get_tv_series_parent_folder to standardize parent folder naming for grouped TV series discs.

Documentation Enhancements

  • Significantly expanded the user documentation to explain the new feature, its configuration, example folder structures for all combinations of options, troubleshooting, and best practices. The documentation now clearly differentiates between disc label naming and series grouping, with detailed examples and migration guidance. [1] [2] [3] [4] [5] [6]

These changes together make TV series management more predictable and user-friendly, especially for users with large, multi-disc collections.

@Betanu701 Betanu701 requested a review from Copilot October 19, 2025 19:58
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR introduces an opt-in feature to organize TV series discs under parent series folders, improving library structure for multi-disc collections. The changes include a new configuration option (GROUP_TV_DISCS_UNDER_SERIES), database migration, updated folder creation logic, and comprehensive documentation explaining both disc label naming and series grouping features.

Key Changes:

  • Added GROUP_TV_DISCS_UNDER_SERIES configuration option that works independently or with existing USE_DISC_LABEL_FOR_TV feature
  • Implemented folder grouping logic in ripper to create hierarchical structures like /tv/Breaking Bad (2008)/Breaking_Bad_S1D1/
  • Expanded documentation with detailed examples covering all feature combinations, troubleshooting guidance, and best practices

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
test/unittest/test_group_tv_discs.py Comprehensive unit tests for parent folder generation and integration scenarios with both features
setup/arm.yaml Added configuration option with detailed comments explaining the new grouping feature
arm_wiki/Using-Disc-Label-for-TV-Series.md Significantly expanded documentation covering feature combinations, examples, troubleshooting, and technical details
arm/ui/comments.json Added UI tooltip for the new configuration option
arm/ripper/utils.py New utility function to generate standardized parent folder names for TV series
arm/ripper/arm_ripper.py Updated path construction logic to include parent folder when grouping is enabled
arm/models/config.py Added database column for new configuration option
arm/migrations/versions/b2c3d4e5f6g7_config_add_group_tv_discs_under_series.py Database migration to add the new configuration column
arm/migrations/versions/version Updated migration version reference
CHANGELOG.md Documented the new feature with usage details

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Copilot AI and others added 3 commits October 19, 2025 20:21
Co-authored-by: Betanu701 <5798012+Betanu701@users.noreply.github.com>
…delines

Fix code style and linting issues for feature-utilize-dvd-label-batch-processing
@Betanu701 Betanu701 merged commit ba8d7af into feature-utilize-dvd-label-batch-processing Oct 19, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants