<h1 align="center">PS Vita Media Processor</h1>
<p align="center">
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.8%2B-blue.svg" alt="Python Version"></a>
<a href="https://github.com/R0salman/PSVMP/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
<a href="https://pypi.org/project/psvmp/"><img src="https://img.shields.io/pypi/v/psvmp.svg" alt="PyPI Version"></a>
<a href="https://github.com/R0salman/PSVMP"><img src="https://img.shields.io/badge/GitHub-Repository-black.svg?logo=github" alt="GitHub"></a>
</p>
A comprehensive media processing tool for PS Vita that downloads, converts, and transfers media files from various online sources directly to your PS Vita device.
---
## Features
* Multi-platform support: Mega.nz, YouTube, SoundCloud, and more
* Modern GUI interface with dark/light themes
* Command-line interface for advanced users
* Automatic media conversion for PS Vita compatibility
* Direct FTP transfer to your PS Vita
* Optimized output: video (960x544), audio (MP3 320kbps)
* Real-time progress tracking for downloads and conversions
* Smart file management with organized storage
* Built-in update checker
* Enhanced metadata handling for music files
* Optional automatic cleanup of temporary files
## Supported Sources
* **Mega.nz** — via `megatools`
* **YouTube** — via `yt-dlp`
* **SoundCloud** — audio-only support with metadata preservation
* **Other websites** — generic support via `yt-dlp`
## Requirements
- Python 3.8 or later
- FFmpeg
- yt-dlp
- megatools
- PyQt6 (for GUI interface)
- PS Vita with VitaShell (FTP enabled)
## Installation
### Quick Install (Recommended)
```bash
pip install psvmp
```
### System Dependencies
After installing via pip, you'll need to install system dependencies:
#### Windows
- [Download FFmpeg](https://ffmpeg.org/download.html) and add to PATH
- [Download megatools](https://megatools.megous.com/) and add to PATH
#### Linux (Ubuntu/Debian)
```bash
sudo apt update
sudo apt install ffmpeg megatools
```
#### macOS
```bash
brew install ffmpeg megatools
```
### Verify Installation
```bash
psvmp --check-deps
```
## PS Vita Setup
1. Install VitaShell on your PS Vita
2. Launch VitaShell and press `SELECT` to start the FTP server
3. Note the **IP** and **Port** address shown on your PS Vita
4. Ensure your computer and PS Vita are connected to the same Wi-Fi network
## Usage
### GUI Interface
Launch the graphical interface:
```bash
psvmp --gui
```
The GUI provides an intuitive interface with:
* Clean, modern design with theme options
* Easy URL input with paste button
* Real-time console output with color-coded messages
* Visual progress tracking
* File management tools
* Built-in update checker
### Command Line Interface
#### Basic Examples
Download and convert a YouTube video:
```bash
psvmp "https://www.youtube.com/watch?v=VIDEO_ID" --type video
```
Download and convert SoundCloud music:
```bash
psvmp "https://soundcloud.com/artist/track" --type music
```
Download from Mega.nz with custom Vita IP:
```bash
psvmp "https://mega.nz/file/..." --ip 192.168.1.100 --port 1337
```
Check version:
```bash
psvmp --version
```
## Command Line Options
```
positional arguments:
url URL of the media file (Mega.nz, YouTube, SoundCloud, etc.)
optional arguments:
-h, --help Show this help message and exit
--type {video,music} Type of media to process (default: video)
--ip IP PS Vita IP address (default: 192.168.1.7)
--port PORT PS Vita FTP port (default: 1337)
--check-deps Check if required dependencies are installed
--gui Launch the GUI interface
-v, --version Show version information and exit
```
## File Organization
The application uses an organized folder structure in your Documents directory:
```
Documents/PSvita media processer/
├── temp/ # Temporary downloads
└── converted/ # Processed files ready for Vita
```
## Output Locations
- **Videos**: `ux0:/video/shows/` (MP4 format)
- **Music**: `ux0:/music/` (MP3 format with embedded metadata)
## Technical Details
### Video Conversion
- **Resolution**: 960x544 (PS Vita native)
- **Codec**: H.264 Baseline Profile
- **Bitrate**: 1500k (max 2000k)
- **Audio**: AAC 128kbps, 44.1kHz
### Audio Conversion
- **Format**: MP3
- **Bitrate**: 320kbps
- **Sample Rate**: 44.1kHz
- **Metadata**: ID3v2.3 tags preserved and embedded
## Troubleshooting
### "Missing required tools" error
- Run `psvmp --check-deps`
- Follow the installation instructions for any missing dependencies
### FTP connection failed
- Confirm that VitaShell FTP server is running (press `SELECT` in VitaShell)
- Check that your PS Vita and PC are on the same network
- Verify that the IP address and port are correct
### Download failed
- Retry the command (some sites rate-limit)
- For Mega links, confirm the link is still valid
- Check your internet connection
### Conversion failed
- Ensure the downloaded file is not corrupted
- Confirm FFmpeg is installed and on your system path
- Try using a different media source
### GUI Issues
- Ensure PyQt6 is installed: `pip install PyQt6`
- Try running with `--gui` flag
- Check console output for detailed error messages
## Tutorial
For a comprehensive walkthrough, watch our tutorial video:
[PS Vita Media Processor Tutorial](https://www.youtube.com/watch?v=Ej24JAy4vIM)
## License
This project is licensed under the [MIT License](https://github.com/R0salman/PSVMP/blob/main/LICENSE).
## Acknowledgments
* VitaShell team for FTP server functionality
* FFmpeg team for media processing capabilities
* yt-dlp developers for download handling
* megatools developers for Mega.nz support
* PyQt team for the GUI framework
* PS Vita homebrew community for inspiration and support
## Support
* **GitHub Issues**: [Report bugs or request features](https://github.com/R0salman/PSVMP/issues)
* **Documentation**: [Full documentation](https://github.com/R0salman/PSVMP)
* **Community**: Join the PS Vita homebrew community discussions
---
<p align="center"><b>Made with ❤️ for the PS Vita community</b></p>
Raw data
{
"_id": null,
"home_page": "https://github.com/R0salman/PSVMP",
"name": "psvmp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "psvita, media, converter, download, youtube, soundcloud, mega",
"author": "0w0-wz5",
"author_email": "0w0-wz5 <salmanalmtyry522@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/59/47/cd0c0f106da6e39f23c3e4afda617282ade3bc8d50d48173a0507affa482/psvmp-2.0.1.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">PS Vita Media Processor</h1>\r\n\r\n<p align=\"center\">\r\n <a href=\"https://www.python.org/\"><img src=\"https://img.shields.io/badge/python-3.8%2B-blue.svg\" alt=\"Python Version\"></a>\r\n <a href=\"https://github.com/R0salman/PSVMP/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-green.svg\" alt=\"License\"></a>\r\n <a href=\"https://pypi.org/project/psvmp/\"><img src=\"https://img.shields.io/pypi/v/psvmp.svg\" alt=\"PyPI Version\"></a>\r\n <a href=\"https://github.com/R0salman/PSVMP\"><img src=\"https://img.shields.io/badge/GitHub-Repository-black.svg?logo=github\" alt=\"GitHub\"></a>\r\n</p>\r\n\r\nA comprehensive media processing tool for PS Vita that downloads, converts, and transfers media files from various online sources directly to your PS Vita device.\r\n\r\n---\r\n\r\n## Features\r\n\r\n* Multi-platform support: Mega.nz, YouTube, SoundCloud, and more\r\n* Modern GUI interface with dark/light themes\r\n* Command-line interface for advanced users\r\n* Automatic media conversion for PS Vita compatibility\r\n* Direct FTP transfer to your PS Vita\r\n* Optimized output: video (960x544), audio (MP3 320kbps)\r\n* Real-time progress tracking for downloads and conversions\r\n* Smart file management with organized storage\r\n* Built-in update checker\r\n* Enhanced metadata handling for music files\r\n* Optional automatic cleanup of temporary files\r\n\r\n## Supported Sources\r\n\r\n* **Mega.nz** \u2014 via `megatools`\r\n* **YouTube** \u2014 via `yt-dlp`\r\n* **SoundCloud** \u2014 audio-only support with metadata preservation\r\n* **Other websites** \u2014 generic support via `yt-dlp`\r\n\r\n## Requirements\r\n\r\n- Python 3.8 or later\r\n- FFmpeg\r\n- yt-dlp\r\n- megatools\r\n- PyQt6 (for GUI interface)\r\n- PS Vita with VitaShell (FTP enabled)\r\n\r\n## Installation\r\n\r\n### Quick Install (Recommended)\r\n\r\n```bash\r\npip install psvmp\r\n```\r\n\r\n### System Dependencies\r\n\r\nAfter installing via pip, you'll need to install system dependencies:\r\n\r\n#### Windows\r\n- [Download FFmpeg](https://ffmpeg.org/download.html) and add to PATH\r\n- [Download megatools](https://megatools.megous.com/) and add to PATH\r\n\r\n#### Linux (Ubuntu/Debian)\r\n```bash\r\nsudo apt update\r\nsudo apt install ffmpeg megatools\r\n```\r\n\r\n#### macOS\r\n```bash\r\nbrew install ffmpeg megatools\r\n```\r\n\r\n### Verify Installation\r\n\r\n```bash\r\npsvmp --check-deps\r\n```\r\n\r\n## PS Vita Setup\r\n\r\n1. Install VitaShell on your PS Vita\r\n2. Launch VitaShell and press `SELECT` to start the FTP server\r\n3. Note the **IP** and **Port** address shown on your PS Vita\r\n4. Ensure your computer and PS Vita are connected to the same Wi-Fi network\r\n\r\n## Usage\r\n\r\n### GUI Interface\r\n\r\nLaunch the graphical interface:\r\n\r\n```bash\r\npsvmp --gui\r\n```\r\n\r\nThe GUI provides an intuitive interface with:\r\n* Clean, modern design with theme options\r\n* Easy URL input with paste button\r\n* Real-time console output with color-coded messages\r\n* Visual progress tracking\r\n* File management tools\r\n* Built-in update checker\r\n\r\n### Command Line Interface\r\n\r\n#### Basic Examples\r\n\r\nDownload and convert a YouTube video:\r\n```bash\r\npsvmp \"https://www.youtube.com/watch?v=VIDEO_ID\" --type video\r\n```\r\n\r\nDownload and convert SoundCloud music:\r\n```bash\r\npsvmp \"https://soundcloud.com/artist/track\" --type music\r\n```\r\n\r\nDownload from Mega.nz with custom Vita IP:\r\n```bash\r\npsvmp \"https://mega.nz/file/...\" --ip 192.168.1.100 --port 1337\r\n```\r\n\r\nCheck version:\r\n```bash\r\npsvmp --version\r\n```\r\n\r\n## Command Line Options\r\n\r\n```\r\npositional arguments:\r\n url URL of the media file (Mega.nz, YouTube, SoundCloud, etc.)\r\n\r\noptional arguments:\r\n -h, --help Show this help message and exit\r\n --type {video,music} Type of media to process (default: video)\r\n --ip IP PS Vita IP address (default: 192.168.1.7)\r\n --port PORT PS Vita FTP port (default: 1337)\r\n --check-deps Check if required dependencies are installed\r\n --gui Launch the GUI interface\r\n -v, --version Show version information and exit\r\n```\r\n\r\n## File Organization\r\n\r\nThe application uses an organized folder structure in your Documents directory:\r\n\r\n```\r\nDocuments/PSvita media processer/\r\n\u251c\u2500\u2500 temp/ # Temporary downloads\r\n\u2514\u2500\u2500 converted/ # Processed files ready for Vita\r\n```\r\n\r\n## Output Locations\r\n\r\n- **Videos**: `ux0:/video/shows/` (MP4 format)\r\n- **Music**: `ux0:/music/` (MP3 format with embedded metadata)\r\n\r\n## Technical Details\r\n\r\n### Video Conversion\r\n- **Resolution**: 960x544 (PS Vita native)\r\n- **Codec**: H.264 Baseline Profile\r\n- **Bitrate**: 1500k (max 2000k)\r\n- **Audio**: AAC 128kbps, 44.1kHz\r\n\r\n### Audio Conversion\r\n- **Format**: MP3\r\n- **Bitrate**: 320kbps\r\n- **Sample Rate**: 44.1kHz\r\n- **Metadata**: ID3v2.3 tags preserved and embedded\r\n\r\n## Troubleshooting\r\n\r\n### \"Missing required tools\" error\r\n- Run `psvmp --check-deps`\r\n- Follow the installation instructions for any missing dependencies\r\n\r\n### FTP connection failed\r\n- Confirm that VitaShell FTP server is running (press `SELECT` in VitaShell)\r\n- Check that your PS Vita and PC are on the same network\r\n- Verify that the IP address and port are correct\r\n\r\n### Download failed\r\n- Retry the command (some sites rate-limit)\r\n- For Mega links, confirm the link is still valid\r\n- Check your internet connection\r\n\r\n### Conversion failed\r\n- Ensure the downloaded file is not corrupted\r\n- Confirm FFmpeg is installed and on your system path\r\n- Try using a different media source\r\n\r\n### GUI Issues\r\n- Ensure PyQt6 is installed: `pip install PyQt6`\r\n- Try running with `--gui` flag\r\n- Check console output for detailed error messages\r\n\r\n## Tutorial\r\n\r\nFor a comprehensive walkthrough, watch our tutorial video:\r\n[PS Vita Media Processor Tutorial](https://www.youtube.com/watch?v=Ej24JAy4vIM)\r\n\r\n## License\r\n\r\nThis project is licensed under the [MIT License](https://github.com/R0salman/PSVMP/blob/main/LICENSE).\r\n\r\n## Acknowledgments\r\n\r\n* VitaShell team for FTP server functionality\r\n* FFmpeg team for media processing capabilities\r\n* yt-dlp developers for download handling\r\n* megatools developers for Mega.nz support\r\n* PyQt team for the GUI framework\r\n* PS Vita homebrew community for inspiration and support\r\n\r\n## Support\r\n\r\n* **GitHub Issues**: [Report bugs or request features](https://github.com/R0salman/PSVMP/issues)\r\n* **Documentation**: [Full documentation](https://github.com/R0salman/PSVMP)\r\n* **Community**: Join the PS Vita homebrew community discussions\r\n\r\n---\r\n\r\n<p align=\"center\"><b>Made with \u2764\ufe0f for the PS Vita community</b></p>\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "PS Vita Media Processor - download, convert and transfer media",
"version": "2.0.1",
"project_urls": {
"Documentation": "https://github.com/R0salman/PSVMP#readme",
"Homepage": "https://github.com/R0salman/PSVMP",
"Issues": "https://github.com/R0salman/PSVMP/issues",
"Repository": "https://github.com/R0salman/PSVMP"
},
"split_keywords": [
"psvita",
" media",
" converter",
" download",
" youtube",
" soundcloud",
" mega"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a776e7ea3ac5989e19abc51d147e3cac1ca982369043625c4b1d33a0f1eb2279",
"md5": "a73a3a5d6dad1da446ef0055f47dbbd3",
"sha256": "d410f08bac2f55f5ab79d3fe253501c9167e859e9cdd0779e5a32ce4ade84739"
},
"downloads": -1,
"filename": "psvmp-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a73a3a5d6dad1da446ef0055f47dbbd3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18392,
"upload_time": "2025-08-19T21:44:30",
"upload_time_iso_8601": "2025-08-19T21:44:30.875068Z",
"url": "https://files.pythonhosted.org/packages/a7/76/e7ea3ac5989e19abc51d147e3cac1ca982369043625c4b1d33a0f1eb2279/psvmp-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5947cd0c0f106da6e39f23c3e4afda617282ade3bc8d50d48173a0507affa482",
"md5": "1d34cd16b2293757b77a069255b0f8a1",
"sha256": "1b76c6e3b19f04188161329e3d30991693e3edd04158ff7efcb2261b81a5ebfa"
},
"downloads": -1,
"filename": "psvmp-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "1d34cd16b2293757b77a069255b0f8a1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 20724,
"upload_time": "2025-08-19T21:44:32",
"upload_time_iso_8601": "2025-08-19T21:44:32.327668Z",
"url": "https://files.pythonhosted.org/packages/59/47/cd0c0f106da6e39f23c3e4afda617282ade3bc8d50d48173a0507affa482/psvmp-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-19 21:44:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "R0salman",
"github_project": "PSVMP",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "PyQt6",
"specs": [
[
"==",
"6.9.1"
]
]
},
{
"name": "pyqt6_sip",
"specs": [
[
"==",
"13.10.2"
]
]
},
{
"name": "Requests",
"specs": [
[
"==",
"2.32.4"
]
]
},
{
"name": "tqdm",
"specs": [
[
"==",
"4.67.1"
]
]
},
{
"name": "pyqtdarktheme",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "argparse",
"specs": [
[
">=",
"1.4.0"
]
]
}
],
"lcname": "psvmp"
}
JSON
