psvmp 3.0.4

PS Vita Media Processor - download, convert and transfer media

PS Vita Media Processor

A media processing tool for PS Vita that downloads, converts, and transfers media files from various online sources directly to your PS Vita device.

---

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
• PS Vita with VitaShell (FTP enabled)

Installation

Quick Install (Recommended)

pip install psvmp

System Dependencies

After installing via pip, you'll need to install system dependencies:

Windows

• Download FFmpeg and add to PATH
• Download megatools and add to PATH

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install ffmpeg megatools

macOS

brew install ffmpeg megatools

Verify Installation

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

Command Line Interface

Basic Examples

Download and convert a YouTube video:

psvmp "https://www.youtube.com/watch?v=VIDEO_ID" --type video

Download and convert SoundCloud music:

psvmp "https://soundcloud.com/artist/track" --type music

Download from Mega.nz with custom Vita IP:

psvmp "https://mega.nz/file/..." --ip 192.168.1.100 --port 1337

Check version:

psvmp --version

Command Line Options

usage: psvmp [-h] [--type {video,music}] [--ip IP] [--port PORT]
             [--check-deps] [-v] [-u] [--history] [--history-clear]
             [--history-limit HISTORY_LIMIT] [--config]
             [--config-set KEY=VALUE] [--config-show]
             [url]

PS Vita Media Processor

positional arguments:
  url                   URL of the media file (Mega.nz, YouTube, SoundCloud,
                        etc.)

options:
  -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
  -v, --version         Show version information and exit
  -u, --update          Check for updates and exit
  --history             Show download history
  --history-clear       Clear download history
  --history-limit HISTORY_LIMIT
                        Number of history entries to show (default: 10)

configuration options:
  --config, -c          Show configuration file location and current settings
  --config-set KEY=VALUE
                        Set configuration value (can be used multiple times)
  --config-show         Show current configuration

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

Tutorial

For a comprehensive walkthrough, watch our tutorial video: PS Vita Media Processor Tutorial

License

This project is licensed under the MIT 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
• PS Vita homebrew community for inspiration and support

Support

• GitHub Issues: Report bugs or request features
• Documentation: Full documentation
• Community: Join the PS Vita homebrew community discussions

---

Made with ❤️ for the PS Vita community