# Clivid - CLI Video Assistant
[](https://badge.fury.io/py/clivid)
[](https://pypi.org/project/clivid/)
[](https://opensource.org/licenses/MIT)
AI-powered video processing assistant that allows users to perform complex video operations using natural language commands. No more remembering complex FFmpeg syntax!
## 🚀 Features
- **Natural Language Interface**: Simply tell it what you want to do with your videos
- **Smart Parameter Extraction**: Automatically understands filenames, time ranges, resolutions, and formats
- **Multi-Step Operations**: Chain operations together (e.g., "extract audio from video.mp4 then use it in other.mp4")
- **Secure API Key Management**: Your Mistral AI API key is stored securely on your local machine
- **Comprehensive Video Operations**:
- Video trimming and cutting
- Format conversion (MP4, AVI, MOV, MKV, etc.)
- Audio extraction and replacement
- Video compression and resizing
- Video rotation and flipping
- Video merging and splitting
- And much more!
## 🛠️ Installation
### Prerequisites
1. **Python 3.7+** is required
2. **FFmpeg** must be installed on your system:
- **Windows**: Download from [https://ffmpeg.org/download.html](https://ffmpeg.org/download.html)
- **macOS**: `brew install ffmpeg`
- **Linux**: `sudo apt install ffmpeg` (Ubuntu/Debian) or `sudo yum install ffmpeg` (CentOS/RHEL)
### Install via pip
```bash
pip install clivid
```
### Get Your Mistral AI API Key
1. Go to [https://console.mistral.ai/](https://console.mistral.ai/)
2. Sign up or log in to your account
3. Navigate to 'API Keys' section
4. Create a new API key
5. Copy the key (you'll be prompted to enter it on first run)
## 🎯 Quick Start
After installation, run the assistant:
```bash
clivid
```
Or use the short alias:
```bash
cv
```
On first run, you'll be prompted to enter your Mistral AI API key. It will be saved securely for future use.
## 💬 Example Commands
The AI understands natural language! Here are some examples:
### Basic Operations
```
"Show me all video files"
"Get info about video.mp4"
"What's the resolution of my_video.mp4?"
```
### Video Editing
```
"Trim video.mp4 from 0:30 to 2:15"
"Cut the first 10 seconds from my_video.mp4"
"Resize video.mp4 to 720p"
"Convert video.mov to mp4"
"Compress my_video.mp4 with high compression"
```
### Audio Operations
```
"Extract audio from video.mp4"
"Extract audio from video.mp4 from 1:30 to 2:45 as MP3"
"Replace audio in video.mp4 with new_audio.mp3"
"Mix new_audio.mp3 with original audio in video.mp4"
```
### Advanced Multi-Step Operations
```
"Extract 50-60 seconds of video.mp4 as mp3 then use it in other_video.mp4"
"Get audio from 1:30 to 2:45 from source.mp4 then replace audio in target.mp4"
"Trim video.mp4 from 0:30 to 2:00 then compress it heavily"
```
### Other Operations
```
"Merge video1.mp4 and video2.mp4"
"Split video.mp4 into 3 equal parts"
"Rotate video.mp4 90 degrees clockwise"
"Flip video.mp4 horizontally"
```
## 🔧 Commands
- `help` - Show detailed examples and usage
- `history` - Show recent conversation history
- `reset api key` - Change your Mistral AI API key
- `clear` - Clear the screen
- `exit` or `quit` - Exit the application
## 🔒 Security
- Your Mistral AI API key is stored locally in `~/.clivid/config.json`
- The configuration file has restricted permissions for security
- No data is sent anywhere except to Mistral AI for natural language processing
## 🆘 Troubleshooting
### Common Issues
1. **"FFmpeg not found"**: Make sure FFmpeg is installed and in your system PATH
2. **"Invalid API key"**: Check your Mistral AI API key and internet connection
3. **"No video files found"**: Make sure you're in a directory with video files
### Getting Help
```bash
clivid
> help
```
This will show detailed examples and usage instructions.
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Built with [Mistral AI](https://mistral.ai/) for natural language processing
- Uses [FFmpeg](https://ffmpeg.org/) for video processing
- Inspired by the need for user-friendly video editing tools
## 📊 System Requirements
- **Python**: 3.7 or higher
- **FFmpeg**: Latest stable version
- **Operating System**: Windows, macOS, or Linux
- **Memory**: 1GB RAM minimum (more for large video files)
- **Storage**: Varies based on video file sizes
---
**Made with ❤️ for video creators and developers who want powerful, simple video processing tools.**
Raw data
{
"_id": null,
"home_page": "https://github.com/localhost969/clivid",
"name": "clivid",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "cli, video, processing, ffmpeg, natural, language, assistant, automation, clivid",
"author": "Donald Duck",
"author_email": "Donald Duck <themuskinrusk2022@proton.me>",
"download_url": "https://files.pythonhosted.org/packages/d0/d4/0de7ffea6a7d9cac06c3b5ba6dc01dc70e2c3adc7f7181eee40f4e213594/clivid-1.0.4.tar.gz",
"platform": null,
"description": "# Clivid - CLI Video Assistant\r\n\r\n[](https://badge.fury.io/py/clivid)\r\n[](https://pypi.org/project/clivid/)\r\n[](https://opensource.org/licenses/MIT)\r\n\r\nAI-powered video processing assistant that allows users to perform complex video operations using natural language commands. No more remembering complex FFmpeg syntax!\r\n\r\n## \ud83d\ude80 Features\r\n\r\n- **Natural Language Interface**: Simply tell it what you want to do with your videos\r\n- **Smart Parameter Extraction**: Automatically understands filenames, time ranges, resolutions, and formats\r\n- **Multi-Step Operations**: Chain operations together (e.g., \"extract audio from video.mp4 then use it in other.mp4\")\r\n- **Secure API Key Management**: Your Mistral AI API key is stored securely on your local machine\r\n- **Comprehensive Video Operations**:\r\n - Video trimming and cutting\r\n - Format conversion (MP4, AVI, MOV, MKV, etc.)\r\n - Audio extraction and replacement\r\n - Video compression and resizing\r\n - Video rotation and flipping\r\n - Video merging and splitting\r\n - And much more!\r\n\r\n## \ud83d\udee0\ufe0f Installation\r\n\r\n### Prerequisites\r\n\r\n1. **Python 3.7+** is required\r\n2. **FFmpeg** must be installed on your system:\r\n - **Windows**: Download from [https://ffmpeg.org/download.html](https://ffmpeg.org/download.html)\r\n - **macOS**: `brew install ffmpeg`\r\n - **Linux**: `sudo apt install ffmpeg` (Ubuntu/Debian) or `sudo yum install ffmpeg` (CentOS/RHEL)\r\n\r\n### Install via pip\r\n\r\n```bash\r\npip install clivid\r\n```\r\n\r\n### Get Your Mistral AI API Key\r\n\r\n1. Go to [https://console.mistral.ai/](https://console.mistral.ai/)\r\n2. Sign up or log in to your account\r\n3. Navigate to 'API Keys' section\r\n4. Create a new API key\r\n5. Copy the key (you'll be prompted to enter it on first run)\r\n\r\n## \ud83c\udfaf Quick Start\r\n\r\nAfter installation, run the assistant:\r\n\r\n```bash\r\nclivid\r\n```\r\n\r\nOr use the short alias:\r\n\r\n```bash\r\ncv\r\n```\r\n\r\nOn first run, you'll be prompted to enter your Mistral AI API key. It will be saved securely for future use.\r\n\r\n## \ud83d\udcac Example Commands\r\n\r\nThe AI understands natural language! Here are some examples:\r\n\r\n### Basic Operations\r\n```\r\n\"Show me all video files\"\r\n\"Get info about video.mp4\"\r\n\"What's the resolution of my_video.mp4?\"\r\n```\r\n\r\n### Video Editing\r\n```\r\n\"Trim video.mp4 from 0:30 to 2:15\"\r\n\"Cut the first 10 seconds from my_video.mp4\"\r\n\"Resize video.mp4 to 720p\"\r\n\"Convert video.mov to mp4\"\r\n\"Compress my_video.mp4 with high compression\"\r\n```\r\n\r\n### Audio Operations\r\n```\r\n\"Extract audio from video.mp4\"\r\n\"Extract audio from video.mp4 from 1:30 to 2:45 as MP3\"\r\n\"Replace audio in video.mp4 with new_audio.mp3\"\r\n\"Mix new_audio.mp3 with original audio in video.mp4\"\r\n```\r\n\r\n### Advanced Multi-Step Operations\r\n```\r\n\"Extract 50-60 seconds of video.mp4 as mp3 then use it in other_video.mp4\"\r\n\"Get audio from 1:30 to 2:45 from source.mp4 then replace audio in target.mp4\"\r\n\"Trim video.mp4 from 0:30 to 2:00 then compress it heavily\"\r\n```\r\n\r\n### Other Operations\r\n```\r\n\"Merge video1.mp4 and video2.mp4\"\r\n\"Split video.mp4 into 3 equal parts\"\r\n\"Rotate video.mp4 90 degrees clockwise\"\r\n\"Flip video.mp4 horizontally\"\r\n```\r\n\r\n## \ud83d\udd27 Commands\r\n\r\n- `help` - Show detailed examples and usage\r\n- `history` - Show recent conversation history\r\n- `reset api key` - Change your Mistral AI API key\r\n- `clear` - Clear the screen\r\n- `exit` or `quit` - Exit the application\r\n\r\n## \ud83d\udd12 Security\r\n\r\n- Your Mistral AI API key is stored locally in `~/.clivid/config.json`\r\n- The configuration file has restricted permissions for security\r\n- No data is sent anywhere except to Mistral AI for natural language processing\r\n\r\n## \ud83c\udd98 Troubleshooting\r\n\r\n### Common Issues\r\n\r\n1. **\"FFmpeg not found\"**: Make sure FFmpeg is installed and in your system PATH\r\n2. **\"Invalid API key\"**: Check your Mistral AI API key and internet connection\r\n3. **\"No video files found\"**: Make sure you're in a directory with video files\r\n\r\n### Getting Help\r\n\r\n```bash\r\nclivid\r\n> help\r\n```\r\n\r\nThis will show detailed examples and usage instructions.\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## \ud83d\ude4f Acknowledgments\r\n\r\n- Built with [Mistral AI](https://mistral.ai/) for natural language processing\r\n- Uses [FFmpeg](https://ffmpeg.org/) for video processing\r\n- Inspired by the need for user-friendly video editing tools\r\n\r\n## \ud83d\udcca System Requirements\r\n\r\n- **Python**: 3.7 or higher\r\n- **FFmpeg**: Latest stable version\r\n- **Operating System**: Windows, macOS, or Linux\r\n- **Memory**: 1GB RAM minimum (more for large video files)\r\n- **Storage**: Varies based on video file sizes\r\n\r\n---\r\n\r\n**Made with \u2764\ufe0f for video creators and developers who want powerful, simple video processing tools.**\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "CLI Video Assistant - AI-powered video processing with natural language interface",
"version": "1.0.4",
"project_urls": {
"Documentation": "https://github.com/localhost969/clivid#readme",
"Homepage": "https://github.com/localhost969/clivid",
"Source": "https://github.com/localhost969/clivid"
},
"split_keywords": [
"cli",
" video",
" processing",
" ffmpeg",
" natural",
" language",
" assistant",
" automation",
" clivid"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c7220eedbd9e3ce28febe6c948604e455dd2f15d12328e23da436b9da5481787",
"md5": "40f50abe9cfa23aaa9efcc1f2c817306",
"sha256": "445b7fbd013379719df1fd60aae0ed9e600bf5df61fcc7da0dd6e504efce5983"
},
"downloads": -1,
"filename": "clivid-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "40f50abe9cfa23aaa9efcc1f2c817306",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 54961,
"upload_time": "2025-08-13T09:57:31",
"upload_time_iso_8601": "2025-08-13T09:57:31.896912Z",
"url": "https://files.pythonhosted.org/packages/c7/22/0eedbd9e3ce28febe6c948604e455dd2f15d12328e23da436b9da5481787/clivid-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d0d40de7ffea6a7d9cac06c3b5ba6dc01dc70e2c3adc7f7181eee40f4e213594",
"md5": "a83254e27196e30210c163ecf76386cd",
"sha256": "f8e01688acfd771b60826688a3428f14ef997db2269d0efb63a2984dec702791"
},
"downloads": -1,
"filename": "clivid-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "a83254e27196e30210c163ecf76386cd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 42622,
"upload_time": "2025-08-13T09:57:33",
"upload_time_iso_8601": "2025-08-13T09:57:33.024233Z",
"url": "https://files.pythonhosted.org/packages/d0/d4/0de7ffea6a7d9cac06c3b5ba6dc01dc70e2c3adc7f7181eee40f4e213594/clivid-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-13 09:57:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "localhost969",
"github_project": "clivid",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
]
]
}
],
"lcname": "clivid"
}
JSON
