Unified audio and video tools for downloading and processing content from YouTube.
A single graphical application with tabbed interface containing three powerful tools:
- Load CSV files containing YouTube links
- Command-line support for auto-loading CSV files on startup
- View all available video/audio streams with quality information
- Select specific formats (video+audio, video only, or audio only)
- Customize output filenames using CSV field data
- Real-time download progress with console output display
- Visual progress bar and wait cursor during operations
- Select multiple video/audio files (MP4, WEBM, M4A, AVI, MOV, MKV, FLV, WMV)
- Batch conversion with progress tracking
- Configurable audio quality (128k, 192k, 256k, 320k)
- Automatic output to converted folder with same basename
- Real-time conversion log
- Uses FFmpeg for high-quality conversion
- Modify MP3, M4A, WAV, OGG, FLAC files
- Speed adjustment: -50% to +100% (tempo change without pitch change)
- Pitch adjustment: -12 to +12 semitones (change pitch without tempo change)
- Quick preset buttons for common modifications
- Batch processing with progress tracking
- Configurable audio quality (128k, 192k, 256k, 320k)
- Automatic output to converted_changed folder with descriptive suffixes
- Real-time modification log
- Uses FFmpeg for high-quality audio processing
- Configure download folder location
- Customize filename patterns for YouTube downloads
- Centralized settings management
- Single application to launch instead of three separate tools
- Seamless workflow between downloading, converting, and modifying
- Shared FFmpeg installation and management
- Consistent user interface across all tools
- Automatic virtual environment management
- Cross-platform support (Windows, Linux, Mac)
- Python 3.7 or higher
- Internet connection for downloading YouTube videos
- FFmpeg (required for video to MP3 conversion)
- Windows: Automatically downloaded when first needed (no admin rights required)
- Linux:
sudo apt-get install ffmpeg - Mac:
brew install ffmpeg
-
Launch Unified Application: Double-click
launchers/audio_tools_unified.bat- First run will automatically create virtual environment and install dependencies
- Subsequent runs will launch directly
-
Auto-load CSV: Drag and drop a CSV file onto the launcher, or:
launchers\audio_tools_unified.bat input\top100.csv
-
Make the launcher executable (first time only):
chmod +x launchers/audio_tools_unified.sh
-
Basic Launch:
./launchers/audio_tools_unified.sh
-
Auto-load CSV:
./launchers/audio_tools_unified.sh input/top100.csv
The original individual tools are still available for users who prefer separate applications:
Windows:
launchers/youtube_downloader.bat- YouTube downloader onlylaunchers/video_to_mp3_converter.bat- Video to MP3 converter onlylaunchers/audio_modifier.bat- Audio modifier onlylaunchers/mp3_to_video_converter.bat- MP3 to video converter onlylaunchers/video_editor.bat- Video editor for combining and arranging videoslaunchers/suno_style_browser.bat- Suno Style Browser for AI music cover generationlaunchers/cover_song_checker.bat- Cover Song Checker for copyright risk assessment before YouTube uploadlaunchers/song_style_analyzer.bat- Song Style Analyzer for extracting style information and lyrics from MP3 fileslaunchers/image_format_converter.bat- Image & Video Format Converter for aspect ratio and format conversionlaunchers/mp3_wav_to_flac_converter.bat- MP3/WAV to FLAC Converter for lossless audio conversion
Linux/Mac:
launchers/youtube_downloader.sh- YouTube downloader onlylaunchers/video_to_mp3_converter.sh- Video to MP3 converter onlylaunchers/audio_modifier.sh- Audio modifier onlylaunchers/mp3_to_video_converter.sh- MP3 to video converter onlylaunchers/video_editor.sh- Video editor for combining and arranging videoslaunchers/suno_style_browser.sh- Suno Style Browser for AI music cover generationlaunchers/cover_song_checker.sh- Cover Song Checker for copyright risk assessment before YouTube uploadlaunchers/song_style_analyzer.sh- Song Style Analyzer for extracting style information and lyrics from MP3 fileslaunchers/image_format_converter.sh- Image & Video Format Converter for aspect ratio and format conversionlaunchers/mp3_wav_to_flac_converter.sh- MP3/WAV to FLAC Converter for lossless audio conversion
-
Load CSV File
- Click "Select CSV File" and choose your CSV file
- Preview will show the file contents
- Sample file:
input/top100.csv
-
Select Video
- Select a video from the list
- Click "Fetch Available Streams"
-
Choose Stream
- Browse available streams organized by type:
- Video + Audio: Complete files ready to play
- Video Only: Video without audio track
- Audio Only: Audio files (MP3, M4A, etc.)
- View quality, file size, and codec information
- Select your preferred stream
- Browse available streams organized by type:
-
Download
- Click "Download Selected Stream"
- Watch the progress bar and wait cursor while downloading
- Real-time console output appears in the log window
- Files are saved to the
downloads/folder
-
Select Video/Audio Files
- Click "Select Video Files"
- Choose one or more video/audio files (MP4, WEBM, M4A, etc.)
- Files will appear in the selection list
- Default folder:
downloads/(where YouTube videos are saved)
-
Configure Settings (Optional)
- Choose output folder (default:
converted/) - Select audio quality: 128k, 192k, 256k, or 320k
- Higher quality = larger file size
- Choose output folder (default:
-
Convert to MP3
- Click "Convert to MP3"
- Progress bar shows conversion progress
- Log window displays detailed conversion information
- Output files saved with same basename as input
-
Select Audio Files
- Click "Select Audio Files"
- Choose one or more audio files (MP3, M4A, WAV, OGG, FLAC)
- Files will appear in the selection list
- Default folder:
converted/(where MP3 files are saved)
-
Configure Modifications
- Speed Adjustment: -50% to +100%
- Negative values slow down the audio
- Positive values speed up the audio
- Changes tempo without affecting pitch
- Pitch Adjustment: -12 to +12 semitones
- Negative values lower the pitch
- Positive values raise the pitch
- 12 semitones = 1 octave
- Changes pitch without affecting tempo
- Audio Quality: Select 128k, 192k, 256k, or 320k
- Speed Adjustment: -50% to +100%
-
Use Quick Presets (Optional)
- Slower -10%: Reduce speed by 10%
- Faster +10%: Increase speed by 10%
- Pitch -1: Lower pitch by 1 semitone
- Pitch +1: Raise pitch by 1 semitone
- Reset: Set both to 0 (no change)
-
Modify Audio Files
- Click "Modify Audio Files"
- Progress bar shows modification progress
- Log window displays detailed processing information
- Output files are saved with descriptive suffixes
- Configure Download Settings
- Change download folder location
- Customize filename pattern using CSV fields:
{Rank}- Rank number{Song Title}- Song title{Artist}- Artist name{Year}- Year{Views (Billions)}- View count
- Default pattern:
{Rank}_{Song Title}_{Artist}
A standalone tool for arranging and combining multiple video files:
- Drag-and-drop video arrangement: Visually arrange videos in a grid by dragging thumbnails
- Video preview: Preview combined videos before saving
- Frame export: Export first or last frame as PNG images
- Video combination: Combine multiple videos into a single output file
- Configurable grid: Adjust number of columns in the video grid
- Project management: Save and load video arrangements as project files
- System player fallback: Automatically falls back to system player when OpenCV GUI is not available
- FFmpeg integration: Uses FFmpeg for video processing and thumbnail generation
- Add Videos: Click "Add Videos" button or drag-and-drop video files from Explorer
- Arrange Videos: Drag video thumbnails to reorder them in the grid
- Adjust Grid: Change the number of columns using the "Grid Columns" spinner
- Preview: Click "Preview Combined Video" to preview the result
- Export: Click "Export Combined Video" to save the combined video file
- Save Project: Use File > Save Project to save your arrangement for later
- Video: MP4, WEBM, AVI, MOV, MKV, FLV, WMV, M4V
- Output: MP4
- Export first frame as PNG image
- Export last frame as PNG image
- Frames are saved in the same folder as the source video
Save your video arrangements as JSON project files:
- Stores video file paths and their order
- Grid column configuration
- Can be loaded later to resume editing
- FFmpeg for video processing (automatically managed)
- Optional: OpenCV for in-app video preview (falls back to system player if not available)
- Combine multiple short videos into one longer video
- Reorder video clips before uploading
- Extract thumbnails from videos
- Prepare video content for social media
- Create video compilations
Check copyright risk of cover songs before uploading to YouTube by analyzing existing cover video history.
- Manual Song Entry: Enter song title and artist manually
- CSV Import: Batch process multiple songs from CSV file
- AI-COVERS Integration: Scan and select songs from AI/AI-COVERS directory
- YouTube Search: Automatically searches for existing cover videos using yt-dlp
- Risk Assessment: Calculates risk level (GRUEN/GELB/ROT) based on:
- Number of existing covers
- Age of oldest cover
- Known problematic artists/publishers (Eminem, Drake, Universal Music, etc.)
- Results Display: Sortable table showing all analyzed songs with statistics
- Detail View: Double-click any result to see all found cover videos with details
- Copy Functionality: Right-click to copy song title or artist to clipboard
- CSV Export: Export all results to CSV file
-
Launch: Double-click
launchers/cover_song_checker.bat(Windows) orlaunchers/cover_song_checker.sh(Linux/Mac) -
Check Single Song:
- Enter song title and artist
- Click "Check Song"
- View results in table
-
Batch Processing:
- Click "Load CSV" to import songs from CSV file
- Or click "Select from AI-COVERS" to choose songs from AI-COVERS directory
- Or click "Scan All AI-COVERS" to analyze all songs automatically
-
View Details:
- Double-click any result to see all found cover videos
- View video titles, URLs, views, duration, and upload dates
-
Export Results:
- Click "Export Results to CSV" to save all results
- No Guarantee: Tool provides risk indicators only, not 100% guarantee
- Delayed Claims: Claims can come weeks or months after upload (as per real-world experience)
- Stylistic Changes: Even heavily modified AI covers can be detected and receive strikes
- YouTube Data API v3: For actual claim/strike detection, YouTube Data API v3 would be needed (not implemented)
- GRUEN (Low Risk): Many existing covers (>20) without strikes, covers exist for months/years
- GELB (Medium Risk): Moderate cover history, some caution advised
- ROT (High Risk): Few/no covers, known problematic artists, or very recent songs
A specialized tool for browsing music styles and generating AI-powered content for music covers, album artwork, and video loops.
The application features a clean, organized interface with three main sections:
Top Bar - Search and Filters:
- Search: General search across all style fields
- Style: Filter by specific style name
- Artists: Filter by sample artists
- Decade: Filter by decade range (e.g., "1970s", "1990s")
- Tempo: Filter by tempo/BPM
- Clear Filters: Reset all filter fields
- Reload: Refresh the CSV file (F5)
- Open CSV: Load a different CSV file
Left Panel - Style List (30% width):
- Scrollable list of all music styles from the loaded CSV
- Click any style to view detailed information
- Styles are sortable by clicking the column header
- Currently selected style is highlighted
Right Panel - Details and Song Management (70% width):
- Style Details Tab: View complete information about the selected style including mood, tempo, instrumentation, vocal style, sample artists, decade range, production notes, and prompt. Each field has a "Copy" button for easy copying.
- Song Details Tab: Complete workflow for creating AI covers:
- AI Cover Name: Generated or manually entered cover name
- Song Name: Original song title
- Artist: Original artist name
- Lyrics: Song lyrics with character counter (20,000 character limit)
- Styles: Input field for style names (comma-separated for multiple)
- Merged Style: AI-generated merged style description
- AI Results: Tabbed interface with:
- Album Cover Tab: Generated album cover prompt with copy button
- Video Loop Tab: Generated video loop prompt with copy button
- Album Cover Preview: Live preview of generated album cover images
- Video Options: Size (720x1280 or 1280x720) and duration (4, 8, or 12 seconds)
- Action Buttons: Two rows of workflow buttons (see Workflow section below)
Bottom Panel - Debug Output:
- Collapsible debug panel (Ctrl+D to toggle)
- Comprehensive logging of all operations
- Clear button to reset debug messages
- Shows API calls, responses, errors, and operation status
- Advanced Style Browser: Browse and filter music styles from CSV files with multi-field search and filtering
- Style Details Viewer: View complete style information with copyable fields for easy integration
- AI Cover Name Generation: Generate creative AI cover names based on song and style information
- Style Merging: Combine multiple music styles using AI to create unique merged style descriptions
- Album Cover Generation: Generate AI prompts and create album cover images using Azure OpenAI DALL-E 3
- Video Loop Generation: Generate AI prompts and create video loops for music visualizers using Azure video generation
- YouTube Description Export: Export SEO-optimized YouTube descriptions with hashtags and metadata
- Song Details Management: Save and load song details, styles, lyrics, and prompts as JSON files
- Azure AI Integration: Configure multiple Azure AI profiles for text, image, and video generation
- Live Preview: Preview generated album covers directly in the application interface
- Debug Output: Comprehensive debug logging for troubleshooting AI operations
- Keyboard Shortcuts: Quick access to common functions
Row 1 - Data & Style Operations:
- Clear All: Reset all song detail fields
- Save: Save song details to config (Ctrl+S)
- Load: Load song details from JSON file
- Merge Styles: Combine multiple styles using AI
- Transform Style: Transform style for viral potential using AI
- Merge+Transform Style: Merge selected style with input styles and transform
- Generate AI Cover Name: Create cover name from song and style
Row 2 - Media Generation & Export:
- Gen Album Cover Prompt: Generate album cover prompt
- Run Album Cover Prompt: Generate album cover image from prompt
- Gen Video Loop Prompt: Generate video loop prompt
- Run Video Loop Prompt: Generate video loop from prompt
- Export YouTube Description: Export complete YouTube description
- Browse Styles: Load a CSV file with music styles and use filters to find the perfect style
- Select Style: Click on a style in the left panel to view detailed information
- Enter Song Details: Fill in song name, artist, lyrics (up to 20,000 characters), and select styles
- Merge Styles: Enter multiple style names and use AI to merge them into a unique description
- Transform Style: Transform current styles, song name, and artist into a viral style description
- Generate AI Cover Name: Create a creative name for your AI cover
- Generate Album Cover: Create an AI prompt, review it, then generate the album cover image
- Generate Video Loop: Create an AI prompt and generate video loop for music visualization
- Export YouTube Description: Export complete YouTube description with SEO optimization
Before using AI features, configure Azure AI settings:
- Go to Settings > Azure AI Settings
- Configure three profiles:
- Text Profile: For style merging and prompt generation (GPT-4)
- Image Gen Profile: For album cover generation (DALL-E 3)
- Video Gen Profile: For video loop generation (Sora/ImageVideo)
- Enter your Azure endpoint, deployment name, subscription key, and API version
Menu Bar:
- Settings: Access Azure AI Settings dialog with three profile tabs (Text, Image Gen, Video Gen)
- Help: Access keyboard shortcuts and about information
Style Details Tab: All style information fields are displayed with copy buttons:
- Style: Style name
- Mood: Mood description
- Tempo (BPM): Tempo range
- Instrumentation: Instrument details
- Vocal Style: Vocal characteristics
- Sample Artists: Example artists for this style
- Decade Range: Time period (e.g., "1970s-1980s")
- Production Notes: Production style information
- Prompt: Style prompt for AI generation
Song Details Tab:
- Lyrics Field: Character counter shows current count / 20,000 limit with color coding (gray = normal, orange = approaching limit, red = over limit)
- AI Results Tabs: Switch between Album Cover and Video Loop prompts
- Album Cover Preview: Displays generated images at up to 512x512 pixels (auto-scaled for large images)
- Video Options: Dropdown menus for size and duration selection
The tool expects a CSV file with music style information. Default location: AI/suno/suno_sound_styles.csv
Example columns:
style: Style name (displayed in left panel list)mood: Mood descriptiontempo_bpm: Tempo in BPM (can be range like "120-140")instrumentation: Instrumentation detailsvocal_style: Vocal style descriptionsample_artists: Example artists (comma-separated)decade_range: Decade range (e.g., "1970s-1980s")production_notes: Production style notesprompt: Style prompt for AI generation
- Ctrl+S: Save song details
- Ctrl+D: Toggle debug output
- Ctrl+F: Focus search field
- F5: Reload CSV file
- Python 3.7 or higher
- Azure OpenAI account with access to:
- Text generation (GPT-4)
- Image generation (DALL-E 3)
- Video generation (Sora/ImageVideo)
- Internet connection for AI API calls
- Create AI-generated music covers with custom styles
- Generate album artwork for AI music projects
- Create video loops for music visualizers
- Export YouTube descriptions for music content
- Browse and explore music style databases
- Merge multiple music styles for unique compositions
A standalone tool for converting images and videos to different aspect ratios and formats:
- Aspect Ratio Conversion: Convert images/videos to common aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5)
- Custom Aspect Ratios: Define custom aspect ratios with width:height ratio
- Multiple Output Formats: Convert to JPG, PNG, or MP4 video
- Crop Position Control: Choose where to crop (center, top, bottom, left, right)
- Video Generation: Create MP4 videos from images with forward or forward-reverse looping
- Batch Processing: Convert multiple files at once
- Drag-and-Drop Support: Drag files directly from Explorer/Finder
- Input Format Detection: Automatically detects input image/video format
- Standard Resolutions: Pre-configured resolutions for each aspect ratio
- Select Files: Click "Select Image Files" or drag-and-drop image/video files
- Choose Aspect Ratio: Select from preset ratios or define a custom ratio
- Set Crop Position: Choose where the image should be cropped (center, top, bottom, left, right)
- Select Output Format: Choose JPG, PNG, or MP4
- Video Mode (MP4 only): Choose Forward or Forward+Reverse looping
- Convert: Click "Convert Selected Files" or "Convert All Files"
- Input: Images (JPG, PNG, BMP, GIF, TIFF, WEBP) | Videos (MP4, AVI, MOV, MKV, WEBM, FLV)
- Output: JPG, PNG, MP4
- 1:1 (Square): Perfect for Instagram posts (1080x1080, 720x720, 512x512)
- 16:9 (Landscape): Standard widescreen (1920x1080, 1280x720, 854x480)
- 9:16 (Portrait): Vertical mobile format (1080x1920, 720x1280, 540x960)
- 4:3 (Standard): Classic TV format (1920x1440, 1280x960, 640x480)
- 3:4 (Portrait Standard): Vertical classic format (1080x1440, 720x960, 540x720)
- 21:9 (Ultrawide): Cinematic widescreen (2560x1080, 1920x822)
- 9:21 (Tall): Ultra-tall portrait format (1080x2520, 720x1680)
- 5:4 (Classic): Traditional computer display (1280x1024, 800x640)
- 4:5 (Portrait Classic): Portrait classic format (1080x1350, 720x900)
Output files are saved in the same folder as the source file with an aspect ratio suffix:
- Example:
image.jpg→image_16x9.jpg - Example:
photo.png→photo_9x16.png
When output format is MP4:
- Creates a video from the image
- Forward Mode: Image displayed as static video frame
- Forward+Reverse Mode: Image loops forward then reverse for seamless playback
- Video duration matches the source video length (if input is video) or uses default duration
- Convert images for social media (Instagram, TikTok, YouTube Shorts)
- Prepare images for different screen formats
- Create video loops from static images
- Batch convert image collections to consistent aspect ratios
- Prepare content for mobile vs desktop viewing
- Python 3.7 or higher
- PIL/Pillow for image processing
- FFmpeg for video conversion (automatically managed on Windows)
- Optional: tkinterdnd2 for drag-and-drop support
A standalone tool for creating videos from MP3 files:
- Combine MP3 files with images or videos
- Image source: Create videos with static images as background
- Video source: Automatically loop existing videos to match MP3 duration
- Loop modes: Forward only or forward-reverse for seamless looping
- Multiple output qualities: Auto (smart defaults), 480p, 720p, 1080p, Mobile Portrait (9:16), Mobile Landscape (16:9), Instagram Square (1:1), Instagram Story (9:16), Portrait 2:3, Landscape 3:2, Image Size (uses original image dimensions)
- Flexible scaling modes: Stretch, Expand (with black bars), Truncate (crop to fit)
- Batch processing: Convert multiple MP3 files at once
- Configurable video codecs: H.264, H.265, VP9
- Automatic image dimension detection and display
- Settings persistence: Remembers your preferences and file selections between sessions
- Select MP3 Files: Choose one or more MP3 files to convert
- Choose Video Source:
- Image: Select a static image (JPG, PNG, etc.)
- Video: Select a video file to loop (MP4, WEBM, etc.) - video will be repeated to match MP3 length
- Configure Settings:
- Output folder location
- Video quality (Auto, 480p, 720p, 1080p, Mobile Portrait, Mobile Landscape, Instagram Square, Instagram Story, Portrait 2:3, Landscape 3:2, Image Size)
- Video codec (H.264, H.265, VP9)
- Scaling mode (Stretch, Expand, Truncate)
- Loop mode (for video sources): Forward only or Forward-Reverse
- Convert: Start the conversion process
- Auto: Smart defaults - uses image dimensions for image sources, 720p for video sources
- 480p: Standard definition (854x480)
- 720p: High definition (1280x720)
- 1080p: Full high definition (1920x1080)
- Mobile Portrait (9:16): Vertical mobile format (720x1280)
- Mobile Landscape (16:9): Horizontal mobile format (1280x720)
- Instagram Square (1:1): Square format for Instagram posts (1080x1080)
- Instagram Story (9:16): Vertical format for Instagram stories (1080x1920)
- Portrait 2:3: Traditional portrait format (720x1080)
- Landscape 3:2: Traditional landscape format (1080x720)
- Image Size: Uses original image dimensions (only available when image source is selected)
- Stretch: Fills the entire frame, may distort aspect ratio
- Expand: Fits content within frame, adds black bars (letterbox/pillarbox) to maintain aspect ratio
- Truncate: Crops content to fit frame exactly, may cut off parts of the image/video
The application automatically saves your preferences and restores them on startup:
- Output folder: Last selected output directory
- Video quality: Last selected quality setting
- Video codec: Last selected codec
- Scaling mode: Last selected scaling method
- Video source type: Image or video source preference
- Loop mode: Forward or forward-reverse preference
- File selections: Last selected image and video files (if they still exist)
- Image dimensions: Cached image dimensions for faster loading
Settings are stored in mp3_to_video_converter_settings.json in the project root.
- Create music videos with album artwork
- Generate video content for social media (Instagram, TikTok, YouTube Shorts)
- Convert audio podcasts to video format
- Create visualizers for music tracks
- Mobile-first content creation
- Social media marketing videos
A standalone tool for analyzing MP3 files to extract style information and lyrics for generative audio conditioning. This tool helps reverse-engineer style prompts and lyrics from existing songs for use with generative audio models like Suno V5 and Udio.
- Audio Transcription: Uses Azure Whisper API to transcribe audio and extract lyrics
- Style Extraction: AI-powered analysis to extract:
- Genre classification (primary genre, sub-genre, fusion tags)
- Mood and valence
- Instrumentation details
- Production quality characteristics
- Suno-style prompts (comma-separated tags)
- Negative prompts (things to avoid)
- Grid View: Results displayed in sortable table with genre, mood, duration, and vocals
- Detail View: Double-click any result to see complete analysis with tabs:
- Summary: All style and technical information
- Lyrics: Full transcribed lyrics with copy button
- Full JSON: Complete analysis data structure
- Drag-and-Drop Support: Drag MP3 files or folders directly from Explorer/Finder
- Batch Processing: Process multiple files or scan directories recursively
- Copy Functionality: Copy lyrics and usage suggestions to clipboard
- Export Options: Export results to JSON or CSV format
- Metadata Validation: Optional requirement for valid artist and song name in MP3 tags
-
Launch: Double-click
launchers/song_style_analyzer.bat(Windows) orlaunchers/song_style_analyzer.sh(Linux/Mac) -
Configure Azure Settings:
- Tool uses same Azure configuration as
suno_persona.py - Requires 'transcribe' profile for audio transcription
- Requires 'text' profile for style extraction
- Configure in
scripts/suno_persona_config.json
- Tool uses same Azure configuration as
-
Select Files:
- Click "Select Single MP3 File" for individual analysis
- Click "Select Directory (Recursive)" to scan folders
- Or drag and drop MP3 files/folders onto the file list
-
Configure Options:
- Enable/disable metadata requirement (requires valid artist and song name)
- Choose output format (JSON or CSV)
-
Start Analysis:
- Click "Start Analysis"
- Progress bar shows processing status
- Results appear in grid as they complete
- Use "Cancel" button to stop processing
-
View Details:
- Double-click any result row to open detail view
- Copy lyrics or usage suggestions using copy buttons
- View complete JSON structure
-
Export Results:
- Click "Export Results" to save as JSON or CSV
- JSON format includes complete analysis structure
- CSV format includes flattened data for spreadsheet use
Results follow the task specification format with:
- Input Metadata: File path, duration, format, artist, title
- Style Analysis: Prompt string, genre taxonomy, technical specs
- Lyric Analysis: Detected language, vocals presence, structured lyrics
- Usage Suggestions: Suno style prompt and negative prompt
- Python 3.7 or higher
- Azure OpenAI account with:
- Whisper deployment for transcription ('transcribe' profile)
- Text generation model for style analysis ('text' profile)
- Internet connection for Azure API calls
- MP3 files with valid metadata (optional, can be disabled)
- Extract style information from existing songs for AI music generation
- Create style prompts for generative audio models (Suno, Udio)
- Analyze song characteristics for music production
- Generate style tags and descriptions from audio files
- Prepare data for AI cover song generation
- Build style databases from music collections
- Style extraction quality depends on transcription accuracy
- Instrumental tracks may have limited style information
- Technical specs (BPM, key, time signature) are placeholders (would require audio analysis libraries)
- Uses same Azure configuration as
suno_persona.py- no separate config needed - Processing time depends on file length and Azure API response times
A standalone tool for converting MP3 and WAV audio files to FLAC (Free Lossless Audio Codec) format:
- Lossless Conversion: Convert MP3/WAV to high-quality FLAC format
- High Quality Output: 44.1 kHz sample rate, stereo, lossless compression
- Batch Processing: Convert multiple files at once
- Drag-and-Drop Support: Drag files directly from Explorer/Finder
- Progress Tracking: Real-time conversion progress and detailed logs
- Automatic Output: Files saved in same folder as input with .flac extension
- Select Files: Click "Select MP3/WAV Files" or drag-and-drop audio files
- Configure Settings (Optional):
- Set input folder (default:
converted/folder) - Output format is always FLAC 44.1 kHz (lossless)
- Set input folder (default:
- Convert: Click "Convert Selected Files" or "Convert All Files"
- Monitor Progress: Watch progress bar and log output
- Format: FLAC (Free Lossless Audio Codec)
- Sample Rate: 44.1 kHz
- Channels: Stereo (2 channels)
- Compression Level: 5 (default, balanced between size and speed)
- Output Location: Same folder as input file
- File Extension:
.flac
- Input: MP3, WAV
- Output: FLAC (lossless)
- Archive audio files in lossless format
- Convert compressed audio to lossless for editing
- Prepare audio files for professional audio work
- Create high-quality audio archives
- Convert downloaded MP3s to lossless format for storage
- Python 3.7 or higher
- FFmpeg for audio conversion (automatically managed on Windows)
- FLAC compression preserves 100% of audio quality (lossless)
- Smaller file size than WAV while maintaining identical audio quality
- Compatible with all major audio players and editing software
- Compression level 5 provides good balance between file size and encoding speed
- Download Videos: Use the YouTube Downloader tab to download videos from CSV lists
- Convert to MP3: Use the Video to MP3 Converter tab to extract audio from downloaded videos
- Modify Audio: Use the Audio Modifier tab to adjust speed and pitch as needed
- Convert to FLAC (Optional): Use the MP3/WAV to FLAC Converter for lossless archival
- Create Videos: Use the MP3 to Video Converter to create videos from MP3 files
- Format Images: Use the Image Format Converter to adjust aspect ratios for social media
- Edit Videos: Use the Video Editor to combine and arrange multiple videos
- Generate AI Content: Use the Suno Style Browser to create AI album covers and video loops for music projects
- Windows: If FFmpeg is not found, the app will offer to download it automatically
- Click "Yes" to download (approximately 80MB, no admin rights needed)
- Linux/Mac: Install FFmpeg using the command shown in the prompt:
- Linux:
sudo apt-get install ffmpeg - Mac:
brew install ffmpeg
- Linux:
- Slow down a song by 10%: Speed = -10%, Pitch = 0
- Speed up a song by 20%: Speed = 20%, Pitch = 0
- Lower pitch by 1 semitone: Speed = 0%, Pitch = -1
- Raise pitch by 2 semitones: Speed = 0%, Pitch = 2
- Slow down AND lower pitch: Speed = -10%, Pitch = -2
- Speed up AND raise pitch: Speed = 15%, Pitch = 1
Your CSV file should contain YouTube links. The downloader supports:
- Direct URLs:
https://www.youtube.com/watch?v=VIDEO_ID - Markdown format:
[https://www.youtube.com/watch?v=VIDEO_ID](https://www.youtube.com/watch?v=VIDEO_ID) - Search URLs:
https://www.youtube.com/results?search_query=Artist+-+Song+Title
Example CSV structure (from input/top100.csv):
"Rank","Song Title","Artist","Views (Billions)","Year","Video Link"
1,"Despacito","Luis Fonsi ft. Daddy Yankee",8.82,2017,"[https://www.youtube.com/watch?v=kJQP7kiw5Fk](https://www.youtube.com/watch?v=kJQP7kiw5Fk)"
stream-download-convert-tools/
├── venv/ # Virtual environment (auto-created)
├── input/ # Input CSV files
│ └── top100.csv # Sample YouTube links
├── downloads/ # Downloaded videos (auto-created)
├── converted/ # Converted MP3 files (auto-created)
├── converted_changed/ # Modified audio files (auto-created)
├── ffmpeg/ # FFmpeg portable (Windows, auto-downloaded)
├── docs/ # Documentation and screenshots
│ └── samplestart.png # Application screenshot
├── scripts/ # Python scripts
│ ├── stream_download_convert_tools_unified.py # Unified application (RECOMMENDED)
│ ├── youtube_downloader.py # Individual YouTube downloader
│ ├── video_to_mp3_converter.py # Individual Video to MP3 converter
│ ├── audio_modifier.py # Individual Audio modifier
│ ├── mp3_to_video_converter.py # Individual MP3 to Video converter
│ ├── video_editor.py # Individual Video Editor
│ ├── suno_style_browser.py # Suno Style Browser for AI music covers
│ ├── cover_song_checker.py # Cover Song Checker for copyright risk assessment
│ ├── song_style_analyzer.py # Song Style Analyzer for generative conditioning
│ ├── image_format_converter.py # Image & Video Format Converter
│ └── mp3_wav_to_flac_converter.py # MP3/WAV to FLAC Converter
├── launchers/ # Launcher scripts
│ ├── stream_download_convert_tools_unified.bat # Windows launcher (Unified - RECOMMENDED)
│ ├── stream_download_convert_tools_unified.sh # Linux/Mac launcher (Unified - RECOMMENDED)
│ ├── youtube_downloader.bat # Windows launcher (YouTube only)
│ ├── youtube_downloader.sh # Linux/Mac launcher (YouTube only)
│ ├── video_to_mp3_converter.bat # Windows launcher (Converter only)
│ ├── video_to_mp3_converter.sh # Linux/Mac launcher (Converter only)
│ ├── audio_modifier.bat # Windows launcher (Audio Modifier only)
│ ├── audio_modifier.sh # Linux/Mac launcher (Audio Modifier only)
│ ├── mp3_to_video_converter.bat # Windows launcher (MP3 to Video only)
│ ├── mp3_to_video_converter.sh # Linux/Mac launcher (MP3 to Video only)
│ ├── video_editor.bat # Windows launcher (Video Editor only)
│ ├── video_editor.sh # Linux/Mac launcher (Video Editor only)
│ ├── suno_style_browser.bat # Windows launcher (Suno Style Browser)
│ ├── suno_style_browser.sh # Linux/Mac launcher (Suno Style Browser)
│ ├── cover_song_checker.bat # Windows launcher (Cover Song Checker)
│ ├── cover_song_checker.sh # Linux/Mac launcher (Cover Song Checker)
│ ├── song_style_analyzer.bat # Windows launcher (Song Style Analyzer)
│ ├── song_style_analyzer.sh # Linux/Mac launcher (Song Style Analyzer)
│ ├── image_format_converter.bat # Windows launcher (Image Format Converter)
│ ├── image_format_converter.sh # Linux/Mac launcher (Image Format Converter)
│ ├── mp3_wav_to_flac_converter.bat # Windows launcher (MP3/WAV to FLAC Converter)
│ └── mp3_wav_to_flac_converter.sh # Linux/Mac launcher (MP3/WAV to FLAC Converter)
├── requirements.txt # Python dependencies
├── .gitignore # Git ignore rules
├── AGENTS.md # Developer/agent documentation
└── README.md # This file
You can auto-load a CSV file on startup:
- Windows: Drag and drop CSV file onto
audio_tools_unified.bat - Command line: Pass CSV file path as first argument to launcher
- The GUI will automatically load the CSV and display the video list in the YouTube Downloader tab
All operations show detailed console-style output in the GUI log window:
[INFO]- Informational messages[SUCCESS]- Successful operations[ERROR]- Error messages- Real-time yt-dlp download progress
- Progress bar: Animated progress indicator during operations
- Wait cursor: Mouse cursor changes to waiting state during busy operations
- Status messages: Current operation displayed above progress bar
If you encounter venv problems:
- Delete the
venv/folder - Re-run the launcher script
If downloads fail:
- Check your internet connection
- Verify the YouTube URL is valid
- Update yt-dlp: The launcher auto-updates dependencies
- Some videos may be geo-restricted or require authentication
If MP3 conversion fails:
- Ensure FFmpeg is installed and in system PATH
- Check that video files are not corrupted
- Try a different audio quality setting
- Verify sufficient disk space in output folder
Ensure tkinter is installed with Python:
- Windows: Included by default
- Linux: Install with
sudo apt-get install python3-tk - Mac: Included by default
Windows: The application will offer to download FFmpeg automatically (portable version, no admin rights needed).
Linux/Mac: If you get "FFmpeg not found" error:
- Install FFmpeg using the command shown in the error message
- Restart the application
- Test: Open terminal and type
ffmpeg -version
Manual Installation (all platforms):
- Download from https://ffmpeg.org/download.html
- Add to system PATH, or place in
ffmpeg/bin/folder within the project
- All launchers automatically manage virtual environments
- Downloaded files are saved to
downloads/folder by default - Converted MP3 files are saved to
converted/folder by default - Modified audio files are saved to
converted_changed/folder by default - The unified application uses
yt-dlpfor YouTube downloading (actively maintained) - All processing uses FFmpeg for high-quality audio/video operations
- Filename patterns sanitize special characters automatically
- Original video and audio files are never modified or deleted during processing
- Recommended: Use the unified application (
stream_download_convert_tools_unified) for the best experience - Legacy: Individual tools remain available for users who prefer separate applications
This software is provided for educational and personal use only. Users are responsible for:
- Complying with applicable copyright laws in their jurisdiction
- Respecting YouTube's Terms of Service
- Only downloading content they have legal rights to access
- Understanding fair use guidelines for their intended use
Important: This tool does not circumvent any digital rights management (DRM) or access controls. Users must ensure their use complies with all applicable laws and platform terms of service.
The authors disclaim any responsibility for misuse of this software.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- User Guide: See USER_GUIDE.md for comprehensive tutorials and usage instructions
- Developer Guide: See
AGENT.mdfor detailed development guidelines and project architecture