Bulk Image and Audio Merger

https://reactorcore.itch.io/bulk-image-and-audio-merger

A simple utility that automatically creates videos by pairing image files with audio files. Perfect for converting audio content like podcasts into a video format suitable for platforms like YouTube, especially when dealing with multiple files.

Note: Requires FFmpeg to process audio/video, get it with this:

• https://reactorcore.itch.io/ffmpeg-to-path-installer

Purpose

This tool was designed to simplify the process of converting audio files (like podcasts) into videos by automatically pairing them with static images you've prepared.

Instead of manually creating each video, you can process multiple files at once and let the program handle the conversion automatically. Even if its 100s or 1000s of podcasts or audio mixes you want to youtubify.

Key Features

• Bulk processing of multiple image-audio pairs
• Automatic matching of files by alphabetical/natural sort order (handles numbers correctly: file1, file2, file10)
• Supports multiple image formats: JPG, JPEG, PNG, WEBP, BMP, GIF, TIFF
• Supports multiple audio formats: MP3, WAV, OGG, FLAC, AAC, M4A, WMA
• Creates video files ready for YouTube upload
• Configurable video quality, resolution, and encoding settings via config.ini
• Resume capability - skip already processed files to resume interrupted batch jobs
• Multi-threaded processing for maximum speed
• Natural sorting ensures correct pairing (image1 with audio1, not image10)
• Detailed error logging to error_log.txt

How to Use

1. The program will automatically create a folder named images_and_audio_here on first run.

2. Place your audio files and corresponding images in this folder. Just dump them all there.

3. Files are paired by alphabetical/natural sort order. For best results, name them similarly:

   Example:

   PodcastEpisode1.mp3
   PodcastEpisode1.jpg
   PodcastEpisode2.mp3
   PodcastEpisode2.jpg
   

   Note: Files don't need matching names, but the program will warn you if they differ to help catch unintended pairings.

4. Run the program. It requires FFmpeg to be installed and available in your system PATH. Use this if you dont have it: https://reactorcore.itch.io/ffmpeg-to-path-installer

5. Review the processing queue to verify pairings are correct, then confirm by typing 'y' and pressing enter.

6. Wait for processing to complete. The program uses all available CPU cores for maximum speed.

7. Find your finished videos in the output_videos folder.

Configuration

Edit config.ini to customize video output settings. The file is auto-generated with detailed comments on first run. Key settings:

• Resolution: 240p to 1080p (default: 360p for audio content)
• FPS: 1-30 frames per second (default: 1 for static images)
• Video Bitrate: Controls quality vs file size (default: 1000k for 360p)
• Encoding Preset: ultrafast to slow, balances speed vs compression (default: ultrafast)
• Threads: Number of CPU cores to use (default: 0 = use all cores)
• Video Codec: libx264 (H.264) or libx265 (H.265/HEVC) (default: libx264)
• Audio Codec: aac, mp3, or copy (default: aac)
• Resume Mode: skip, overwrite, or ask (default: skip)

Tips

• Output files will be MP4 format, suitable for YouTube upload.
• Processing time depends on your computer's capabilities and the number/length of files.
• The program uses multi-threaded processing with all available CPU cores for maximum speed.
• Videos maintain the original image's aspect ratio.
• Use resume mode 'skip' (default) to continue interrupted batch processing without redoing completed videos.
• Check error_log.txt if any videos fail to process.

Troubleshooting

If you encounter any issues:

• Ensure FFmpeg is installed and available in your system PATH.
• Make sure there's an equal number of images and audio files in the input folder.
• Files are paired alphabetically, not by matching names. Use natural number sorting for correct pairing (file1, file2, not file01, file02).
• You can mix different image formats (JPG, PNG, etc.) and audio formats (MP3, WAV, etc.) - the program handles them all.
• Make sure you have enough disk space for the output videos. Videos usually have large filesizes.
• Check error_log.txt for detailed error information if processing fails.
• You can use a combination of Advanced Renamer, Notepad++ and "Shift+Right-Click > Copy Path" of selected files in File Explorer to rename hundreds or thousands of files efficiently.

Technical Details

Architecture

• BulkImageAudioMerger.py: Main program that handles video creation
• config_generator.py: Creates and manages config.ini with defaults
• config.ini: User-editable configuration file (auto-generated)

Dependencies

• Python 3.x
• moviepy (video editing library)
• Pillow/PIL (image processing)
• FFmpeg (must be in system PATH)

Processing

• Uses MoviePy with FFmpeg backend for video encoding
• Pillow compatibility patch for ANTIALIAS (supports Pillow 10+)
• Concurrent processing using ThreadPoolExecutor with configurable worker threads
• Natural sorting algorithm correctly orders files with numbers
• Detailed error logging with timestamps and full tracebacks
• Output videos named after audio files for easy identification

---

Author & Links

If you like this, try my other stuff too!

• Games, Tools: https://reactorcore.itch.io
• Dev Blog: https://www.patreon.com/ReactorcoreGames
• Links: http://www.reactorcoregames.com
• mailto:reactorcoregames@gmail.com

Enjoy!

• Reactorcore

---

Itch.io Infos:

Title: Bulk Image and Audio Merger

Subtitle: Bulk convert audio files to YouTube-ready videos automatically

Description: Automatically convert your audio files into YouTube-ready videos by pairing them with static images! Perfect for turning podcasts, audio episodes, or music tracks into video format in bulk. Simply match your audio files with corresponding images, and let the program handle the rest. Ideal for content creators who need to process multiple audio files without the hassle of manual video editing.

Tags: utility, video, audio, converter, tool, batch, automation, windows, free, multimedia