| Name | audio2video JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | Convert audio files with static images to video format for YouTube and social media |
| upload_time | 2025-07-10 05:30:37 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
audio
video
conversion
youtube
moviepy
podcast
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# audio2video
[](https://badge.fury.io/py/audio2video)
[](https://pypi.org/project/audio2video/)
[](https://opensource.org/licenses/MIT)
**Convert audio files with static images to video format for YouTube and social media**
Transform your podcasts, NotebookLM audio, or any audio content into engaging videos by combining them with custom thumbnails. Perfect for content creators who want to upload audio content to YouTube or other video platforms.
## ✨ Features
- 🎵 **Multiple audio formats**: WAV, MP3, FLAC, AAC
- 🖼️ **Multiple image formats**: PNG, JPG, JPEG, BMP, GIF
- 📹 **High-quality output**: Optimized MP4 videos for web platforms
- ⚡ **Fast processing**: Efficient conversion using MoviePy
- 🛠️ **Simple CLI**: Easy-to-use command-line interface
- 📱 **Platform ready**: YouTube, TikTok, Instagram compatible output
## 🚀 Quick Start
### Installation
```bash
pip install audio2video
```
### Basic Usage
```bash
# Convert audio + image to video
audio2video -a podcast.wav -i thumbnail.png -o output.mp4
# Using short flags
audio2video -a audio.mp3 -i image.jpg -o video.mp4
# Enable verbose output
audio2video -a audio.wav -i image.png -o output.mp4 --verbose
```
### Advanced Options
```bash
# Specify output quality (18=high, 23=medium, 28=web)
audio2video -a audio.wav -i image.png -o output.mp4 --crf 18
# Set custom resolution
audio2video -a audio.wav -i image.png -o output.mp4 --resolution 1920x1080
# Set frames per second
audio2video -a audio.wav -i image.png -o output.mp4 --fps 30
```
## 📖 Use Cases
### 🎙️ Podcast to YouTube
Transform your podcast episodes into YouTube-ready videos with custom artwork.
### 🤖 NotebookLM Content
Convert AI-generated podcast content from NotebookLM into shareable video format.
### 📚 Educational Content
Create video lectures from audio recordings with presentation slides or graphics.
### 🎵 Music Releases
Combine music tracks with album artwork for music platform uploads.
## 💡 Examples
### Batch Processing
```bash
# Process multiple files
for audio in *.wav; do
audio2video -a "$audio" -i default_thumbnail.png -o "videos/${audio%.wav}.mp4"
done
```
## 🛠️ Development
### Prerequisites
- Python 3.9+
- FFmpeg (automatically handled by MoviePy)
### Local Installation
```bash
# Clone repository
git clone https://github.com/KaoruBB/audio2video.git
cd audio2video
# Install with uv (recommended)
uv pip install -e .
# Or with pip
pip install -e .
```
### Running Tests
```bash
pytest tests/
```
### Development with uv
```bash
# Run directly from source
uv run audio2video -a test.wav -i test.png -o test.mp4
# Install dependencies
uv pip install -r requirements.txt
```
## 📋 Command Line Options
```
usage: audio2video [-h] -a AUDIO -i IMAGE -o OUTPUT [--crf CRF]
[--resolution RESOLUTION] [--fps FPS] [--verbose]
Convert audio files with static images to video format
required arguments:
-a, --audio AUDIO Input audio file (WAV, MP3, FLAC, AAC)
-i, --image IMAGE Input image file (PNG, JPG, JPEG, BMP, GIF)
-o, --output OUTPUT Output video file (MP4)
optional arguments:
-h, --help Show this help message and exit
--crf CRF Video quality (18=high, 23=medium, 28=web) [default: 23]
--resolution RESOLUTION
Output resolution (e.g., 1920x1080) [default: 1920x1080]
--fps FPS Frames per second [default: 1]
--verbose Enable verbose output
```
## 🤝 Contributing
We welcome contributions! Please feel free to submit issues and pull requests.
### Ways to Contribute
- 🐛 Report bugs
- ✨ Request features
- 🔧 Submit pull requests
- 📝 Improve documentation
- 🧪 Add tests
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Built with [MoviePy](https://zulko.github.io/moviepy/) for video processing
- Inspired by the need to convert NotebookLM podcasts to YouTube videos
- Thanks to the open-source community for the amazing tools
## 🔗 Related Projects
- [moviepy](https://github.com/Zulko/moviepy) - Video editing library
- [ffmpeg-python](https://github.com/kkroening/ffmpeg-python) - FFmpeg wrapper
- [youtube-upload](https://github.com/tokland/youtube-upload) - YouTube upload automation
## 📞 Support
- 📖 [Documentation](https://github.com/KaoruBB/audio2video/wiki)
- 🐛 [Issue Tracker](https://github.com/KaoruBB/audio2video/issues)
- 💬 [Discussions](https://github.com/KaoruBB/audio2video/discussions)
---
⭐ **Star this repo if you find it useful!**
Made with ❤️ for content creators who want to bring their audio to the visual world.
Raw data
{
"_id": null,
"home_page": null,
"name": "audio2video",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "audio, video, conversion, youtube, moviepy, podcast",
"author": null,
"author_email": "Kaoru Babasaki <kaorubabasaki@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/73/a8/d6dcfd88f670e39ddb9164534528880ada6539ddf538cae6c6cf56fcbb15/audio2video-0.1.1.tar.gz",
"platform": null,
"description": "# audio2video\n\n[](https://badge.fury.io/py/audio2video)\n[](https://pypi.org/project/audio2video/)\n[](https://opensource.org/licenses/MIT)\n\n**Convert audio files with static images to video format for YouTube and social media**\n\nTransform your podcasts, NotebookLM audio, or any audio content into engaging videos by combining them with custom thumbnails. Perfect for content creators who want to upload audio content to YouTube or other video platforms.\n\n## \u2728 Features\n\n- \ud83c\udfb5 **Multiple audio formats**: WAV, MP3, FLAC, AAC\n- \ud83d\uddbc\ufe0f **Multiple image formats**: PNG, JPG, JPEG, BMP, GIF\n- \ud83d\udcf9 **High-quality output**: Optimized MP4 videos for web platforms\n- \u26a1 **Fast processing**: Efficient conversion using MoviePy\n- \ud83d\udee0\ufe0f **Simple CLI**: Easy-to-use command-line interface\n- \ud83d\udcf1 **Platform ready**: YouTube, TikTok, Instagram compatible output\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\npip install audio2video\n```\n\n### Basic Usage\n\n```bash\n# Convert audio + image to video\naudio2video -a podcast.wav -i thumbnail.png -o output.mp4\n\n# Using short flags\naudio2video -a audio.mp3 -i image.jpg -o video.mp4\n\n# Enable verbose output\naudio2video -a audio.wav -i image.png -o output.mp4 --verbose\n```\n\n### Advanced Options\n\n```bash\n# Specify output quality (18=high, 23=medium, 28=web)\naudio2video -a audio.wav -i image.png -o output.mp4 --crf 18\n\n# Set custom resolution\naudio2video -a audio.wav -i image.png -o output.mp4 --resolution 1920x1080\n\n# Set frames per second\naudio2video -a audio.wav -i image.png -o output.mp4 --fps 30\n```\n\n## \ud83d\udcd6 Use Cases\n\n### \ud83c\udf99\ufe0f Podcast to YouTube\nTransform your podcast episodes into YouTube-ready videos with custom artwork.\n\n### \ud83e\udd16 NotebookLM Content\nConvert AI-generated podcast content from NotebookLM into shareable video format.\n\n### \ud83d\udcda Educational Content\nCreate video lectures from audio recordings with presentation slides or graphics.\n\n### \ud83c\udfb5 Music Releases\nCombine music tracks with album artwork for music platform uploads.\n\n## \ud83d\udca1 Examples\n### Batch Processing\n```bash\n# Process multiple files\nfor audio in *.wav; do\n audio2video -a \"$audio\" -i default_thumbnail.png -o \"videos/${audio%.wav}.mp4\"\ndone\n```\n\n## \ud83d\udee0\ufe0f Development\n\n### Prerequisites\n- Python 3.9+\n- FFmpeg (automatically handled by MoviePy)\n\n### Local Installation\n```bash\n# Clone repository\ngit clone https://github.com/KaoruBB/audio2video.git\ncd audio2video\n\n# Install with uv (recommended)\nuv pip install -e .\n\n# Or with pip\npip install -e .\n```\n\n### Running Tests\n```bash\npytest tests/\n```\n\n### Development with uv\n```bash\n# Run directly from source\nuv run audio2video -a test.wav -i test.png -o test.mp4\n\n# Install dependencies\nuv pip install -r requirements.txt\n```\n\n## \ud83d\udccb Command Line Options\n\n```\nusage: audio2video [-h] -a AUDIO -i IMAGE -o OUTPUT [--crf CRF] \n [--resolution RESOLUTION] [--fps FPS] [--verbose]\n\nConvert audio files with static images to video format\n\nrequired arguments:\n -a, --audio AUDIO Input audio file (WAV, MP3, FLAC, AAC)\n -i, --image IMAGE Input image file (PNG, JPG, JPEG, BMP, GIF)\n -o, --output OUTPUT Output video file (MP4)\n\noptional arguments:\n -h, --help Show this help message and exit\n --crf CRF Video quality (18=high, 23=medium, 28=web) [default: 23]\n --resolution RESOLUTION\n Output resolution (e.g., 1920x1080) [default: 1920x1080]\n --fps FPS Frames per second [default: 1]\n --verbose Enable verbose output\n```\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please feel free to submit issues and pull requests.\n\n### Ways to Contribute\n- \ud83d\udc1b Report bugs\n- \u2728 Request features\n- \ud83d\udd27 Submit pull requests\n- \ud83d\udcdd Improve documentation\n- \ud83e\uddea Add tests\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- Built with [MoviePy](https://zulko.github.io/moviepy/) for video processing\n- Inspired by the need to convert NotebookLM podcasts to YouTube videos\n- Thanks to the open-source community for the amazing tools\n\n## \ud83d\udd17 Related Projects\n\n- [moviepy](https://github.com/Zulko/moviepy) - Video editing library\n- [ffmpeg-python](https://github.com/kkroening/ffmpeg-python) - FFmpeg wrapper\n- [youtube-upload](https://github.com/tokland/youtube-upload) - YouTube upload automation\n\n## \ud83d\udcde Support\n\n- \ud83d\udcd6 [Documentation](https://github.com/KaoruBB/audio2video/wiki)\n- \ud83d\udc1b [Issue Tracker](https://github.com/KaoruBB/audio2video/issues)\n- \ud83d\udcac [Discussions](https://github.com/KaoruBB/audio2video/discussions)\n\n---\n\n\u2b50 **Star this repo if you find it useful!**\n\nMade with \u2764\ufe0f for content creators who want to bring their audio to the visual world.\n",
"bugtrack_url": null,
"license": null,
"summary": "Convert audio files with static images to video format for YouTube and social media",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://github.com/KaoruBB/audio2video/wiki",
"Homepage": "https://github.com/KaoruBB/audio2video",
"Issues": "https://github.com/KaoruBB/audio2video/issues",
"Repository": "https://github.com/KaoruBB/audio2video.git"
},
"split_keywords": [
"audio",
" video",
" conversion",
" youtube",
" moviepy",
" podcast"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "101fcb7fb9da2ceea20df11aab29cea0920e1c265db559293c0200fced5db5b3",
"md5": "50743b49546a7028a6844b1ef3954c6a",
"sha256": "91a31af94d82566c47fdff62a33e42a4e4abf2936db08317e767b3485e7171bc"
},
"downloads": -1,
"filename": "audio2video-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "50743b49546a7028a6844b1ef3954c6a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6522,
"upload_time": "2025-07-10T05:30:36",
"upload_time_iso_8601": "2025-07-10T05:30:36.739081Z",
"url": "https://files.pythonhosted.org/packages/10/1f/cb7fb9da2ceea20df11aab29cea0920e1c265db559293c0200fced5db5b3/audio2video-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "73a8d6dcfd88f670e39ddb9164534528880ada6539ddf538cae6c6cf56fcbb15",
"md5": "3fc8ea9d5e3cee534edacc2c5a82369a",
"sha256": "7a97f406e2d97af6ee64c418c6d4eeeaf4b928b798e420997ed1318c92330a21"
},
"downloads": -1,
"filename": "audio2video-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "3fc8ea9d5e3cee534edacc2c5a82369a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 7173,
"upload_time": "2025-07-10T05:30:37",
"upload_time_iso_8601": "2025-07-10T05:30:37.777442Z",
"url": "https://files.pythonhosted.org/packages/73/a8/d6dcfd88f670e39ddb9164534528880ada6539ddf538cae6c6cf56fcbb15/audio2video-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-10 05:30:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "KaoruBB",
"github_project": "audio2video",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "audio2video"
}
