Skip to content
/ PSVMP Public

A tool that automatically downloads, converts, and transfers videos and music to your PS Vita.

License

Notifications You must be signed in to change notification settings

R0salman/PSVMP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PS Vita Media Processor Logo

Python Version License PyPI Version


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 download and conversion progress
  • 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

Method 1: PyPI Installation (Recommended)

pip install psvmp

Method 2: Manual Installation

1. Clone the repository

git clone https://github.com/R0salman/PSVMP.git
cd PSVMP

2. Install Python dependencies

pip install tqdm yt-dlp PyQt6

3. Install system dependencies

Windows
Linux (Ubuntu/Debian)
sudo apt update
sudo apt install ffmpeg megatools
pip install yt-dlp PyQt6
macOS
brew install ffmpeg megatools
pip install yt-dlp PyQt6

4. Verify installation

python psmedia.py --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:

python psmedia.py --gui

The GUI provides an intuitive interface with the following features:

  • Clean, modern design with dark/light theme options
  • Paste button for easy URL input
  • Real-time console output with color-coded messages
  • Progress tracking with visual feedback
  • File management tools (open output folder, delete files)
  • Built-in update checker
  • One-click processing workflow

Command Line Interface

Basic Examples

Download and convert a YouTube video:

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

Download and convert SoundCloud music:

python psmedia.py "https://soundcloud.com/artist/track" --type music

Download from Mega.nz with custom Vita IP:

python psmedia.py "https://mega.nz/file/..." --ip 192.168.1.100 --port 1337

Check version:

python psmedia.py --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

Tutorial

Watch the full tutorial on how to use PSVMP:

Watch the tutorial video

File Organization

The application now 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 python psmedia.py --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

License

This project is licensed under the MIT License.

Acknowledgments

  • Thanks to the VitaShell team for the FTP server functionality.
  • Thanks to the FFmpeg team for media processing.
  • Thanks to the yt-dlp developers for download handling.
  • Thanks to the megatools developers for Mega.nz support.
  • Thanks to the PyQt team for the GUI framework.

Made with ❤️ for the PS Vita community