[PR #1669] [FEAT] Added --list-tracks option to display available tracks in media files #2381

New Issue

claunia · 2026-01-29T17:21:50Z

claunia commented

2026-01-29 17:21:50 +00:00

Original Pull Request: https://github.com/CCExtractor/ccextractor/pull/1669

State: closed
Merged: No

In raising this pull request, I confirm the following (please check boxes):

I have read and understood the contributors guide.
I have checked that another pull request for this purpose does not exist.
I have considered, and confirmed that this submission will be valuable to others.
I accept that this submission may not be used, and the pull request closed at the will of the maintainer.
I give this submission freely, and claim no ownership to its content.
I have mentioned this change in the changelog.

My familiarity with the project is as follows (check one):

I have never used CCExtractor.
I have used CCExtractor just a couple of times.
I absolutely love CCExtractor, but have not contributed previously.
I am an active contributor to CCExtractor.

This PR adds a new command-line option --list-tracks that allows users to list all available tracks in an input file and exit without processing the file for subtitle extraction.

When working with complex media files that contain multiple tracks, it's often difficult to know which track contains the subtitles you want to extract. This feature provides a simple way to explore the file structure before running a full extraction, making it easier to:

Identify which streams contain subtitle data
Determine the appropriate track numbers for extraction
Save time by avoiding trial and error with multiple extraction attempts

Implementation

Added a list_tracks_only flag to the options structure
Implemented functionality to handle the flag in processing pipeline
Added proper command-line argument handling in Rust wrapper
Placed the option in the "Options that affect what will be processed" section

Example Usage

ccextractor video.mp4 --list-tracks

This will display information about available tracks in the file rather than extracting subtitles.

Testing

The feature has been tested with various media file formats including MP4, MKV, and TS files containing multiple subtitle tracks. It correctly lists available tracks and exits without performing extraction.
Distribution Used: Fedora Linux

TS Files:

MKV Files:

MP4 Files:

**Original Pull Request:** https://github.com/CCExtractor/ccextractor/pull/1669 **State:** closed **Merged:** No --- **In raising this pull request, I confirm the following (please check boxes):** - [x] I have read and understood the [contributors guide](https://github.com/CCExtractor/ccextractor/blob/master/.github/CONTRIBUTING.md). - [x] I have checked that another pull request for this purpose does not exist. - [x] I have considered, and confirmed that this submission will be valuable to others. - [x] I accept that this submission may not be used, and the pull request closed at the will of the maintainer. - [x] I give this submission freely, and claim no ownership to its content. - [x] **I have mentioned this change in the [changelog](https://github.com/CCExtractor/ccextractor/blob/master/docs/CHANGES.TXT).** **My familiarity with the project is as follows (check one):** - [ ] I have never used CCExtractor. - [ ] I have used CCExtractor just a couple of times. - [ ] I absolutely love CCExtractor, but have not contributed previously. - [x] I am an active contributor to CCExtractor. --- This PR adds a new command-line option --list-tracks that allows users to list all available tracks in an input file and exit without processing the file for subtitle extraction. When working with complex media files that contain multiple tracks, it's often difficult to know which track contains the subtitles you want to extract. This feature provides a simple way to explore the file structure before running a full extraction, making it easier to: - Identify which streams contain subtitle data - Determine the appropriate track numbers for extraction - Save time by avoiding trial and error with multiple extraction attempts Implementation - Added a list_tracks_only flag to the options structure - Implemented functionality to handle the flag in processing pipeline - Added proper command-line argument handling in Rust wrapper - Placed the option in the "Options that affect what will be processed" section Example Usage ``` ccextractor video.mp4 --list-tracks ``` This will display information about available tracks in the file rather than extracting subtitles. # Testing The feature has been tested with various media file formats including MP4, MKV, and TS files containing multiple subtitle tracks. It correctly lists available tracks and exits without performing extraction. Distribution Used: Fedora Linux ### TS Files: ![image](https://github.com/user-attachments/assets/3d441584-f44b-4143-a280-835eb38c1efb) ### MKV Files: ![image](https://github.com/user-attachments/assets/a0af800d-00ce-4a86-ac65-67b7579c1824) ### MP4 Files: ![image](https://github.com/user-attachments/assets/9bd6c344-1335-4dc9-b19c-a4a38930874a)

claunia added the pull-request label 2026-01-29 17:21:50 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/ccextractor#2381