MP4 Audio Extractor

A simple application to extract audio tracks from MP4 video files. Available in both GUI and command-line versions. Built using the Model-View-Controller (MVC) architecture for better modularity and maintainability.

Features

• Extract audio from a single MP4 file or batch process an entire folder
• Save as MP3 or AAC format
• Simple, user-friendly interface
• Output files are saved in the same location as the input files

Requirements

• Python 3.6 or higher (with tkinter for the GUI version)
• FFmpeg installed and available in the system PATH

Installation

1. Ensure you have Python 3.6+ installed
2. Download and install FFmpeg from ffmpeg.org
3. Add FFmpeg to your system PATH
4. Clone or download this repository

Architecture

The application is built using the Model-View-Controller (MVC) architecture:

• Model: Handles the core audio extraction logic and FFmpeg interaction
• View: Provides the user interface (both GUI and CLI versions)
• Controller: Connects the model and views, handling the application logic

Usage

GUI Version

Note: The GUI version requires tkinter, which is included with most Python installations but may need to be installed separately on some systems.

Here is a screenshot of the main window:

1. Run the GUI application:

   python mp4_audio_extractor_gui.py
   

   Or use the module directly:

   python -m mp4_audio_extractor
   

2. Use the "Select File" button to choose a single MP4 file, or "Select Folder" to select a directory containing MP4 files.

3. Choose the desired output format (MP3 or AAC).

4. Click "Convert Audio" to start the extraction process.

5. The status of the conversion will be displayed in the status area.

Command-Line Version

The command-line version is available for systems without tkinter or for users who prefer a CLI.

1. Process a single file:

   python mp4_audio_extractor_cli.py path/to/video.mp4 [--format mp3|aac]
   

   Or use the module directly:

   python -m mp4_audio_extractor --cli path/to/video.mp4 [--format mp3|aac]
   

2. Process all MP4 files in a folder:

   python mp4_audio_extractor_cli.py path/to/folder [--format mp3|aac]
   

3. Get help:

   python mp4_audio_extractor_cli.py --help
   

Notes

• The application requires FFmpeg to be installed and available in the system PATH.
• When extracting to AAC format, the application attempts to copy the audio stream without re-encoding (assuming the source audio is AAC).
• When extracting to MP3 format, the application uses the libmp3lame codec with a bitrate of 192kbps.
• The application will automatically fall back to CLI mode if tkinter is not available.

Project Structure

root/
├── docs/                   # Documentation
│   ├── prd.md              # Product Requirements Document
│   ├── techstack.md        # Technology Stack Recommendation
│   ├── backend.md          # Backend Implementation Guide
│   ├── frontend.md         # Frontend Implementation Guide
│   ├── flow.md             # System Flow Documentation
│   ├── status.md           # Project Status Report
│   └── user_guide.md       # User Guide
│
├── mp4_audio_extractor/
│   ├── __init__.py         # Package initialization
│   ├── __main__.py         # Entry point when run as a module
│   ├── AudioExtractorController.py       # GUI/CLI Controller component
│   ├── AudioProcessingUtils.py           # Audio processing utilities
│   ├── view_gui.py         # GUI interface
│   └── view_cli.py         # CLI interface
│
├── scripts/                # Utility scripts
│   └── generate_test_media.py  # Script to generate test media files
│
├── tests/                  # Unit tests
│   ├── test_media/         # Test media files
│   │   ├── sample_base_2s.mp4                  # Base 2s sample .mp4 file
│   │   ├── sample_base_2s_corrupted_header.mp4 # Corrupted by modifying header
│   │   ├── sample_base_2s_corrupted_middle.mp4 # Corrupted by modifying middle
│   │   └── sample_base_5s.mp4                  # Base 5s sample .mp4 file
│   │
│   ├── test_utils/         # Test utilities
│   │   └── TestMediaGenerator.py
│   │
│   └── test_audio_processing_utils.py  # Tests for AudioProcessingUtils
│    
├── LICENSE                 # License file     
├── mp4_audio_extractor_gui.py  # Thin wrapper for GUI entry point
├── mp4_audio_extractor_cli.py  # Thin wrapper for CLI entry point
├── README.md               # This file
├── requirements.txt        # List of dependencies
└── setup.py                # Setup script for packaging

License

MIT License