Contents

1. Advanced Settings
2. Command-line Options
3. Qt-specific Options
4. Headless Version

Usage

Simply run qcma. At first run, you will have to set contents folders, similarly to the original CMA.

Advanced Settings

• Offline Mode: If you disable this then the PS Vita can use Qcma to check for updates and download firmware updates from the Internet. Keep it enabled if you don't want to upgrade. (Enabled by Default)
  In both online and offline mode, a psp2-updatelist.xml file placed in the Update folder has priority over the embedded xml file, or the one retrieved from the Internet. To update to a specific version, place the corresponding updatelist and pup files in the Update folder and start the update via USB.
• Skip Metadata Extraction: The initial scan will be A LOT faster by omiting some info when doing the initial scan. For example you will not be able to see ID3 info for mp3 files, resolution and duration for movies and game names for psp savedatas.
• Disable USB Monitoring: Qcma won't be able to connect to the PS Vita using a USB cable.
• Disable Wi-Fi Monitoring: Qcma won't be able to connect to the PS Vita via WiFi.
• Skip Photo Scanning: The initial scan will become faster by omitting the contents of the Photo folder.
• Skip Video Scanning: The initial scan will become faster by omitting the contents of the Video folder.
• Skip Music Scanning: The initial scan will become faster by omitting the contents of the Music folder.
• CMA protocol selection: Qcma by default uses the Latest CMA protocol. Toggle this setting to Manual if you are on an older firmware, or to Custom if you're ahead of the curve.
• CMA protocol version: If you are on an older firmware, you need to change this setting to match your firmware. If your firmware version isn't listed, use the next listed version that is older than yours.
• CMA custom version: If you're ahead of the curve, use this to enter a custom CMA protocol.

Command-line Options

--with-debug: Debug output; create hex dumps of every transaction
--verbose: Activate verbose logging
--set-locale: Force a different locale. For example

qcma --set-locale es # Run QCMA in Spanish
qcma --set-locale ja # Run QCMA in Japanese

Qt-specific Options

Qt-specific options of note include:
-style= style, sets the application GUI style. Possible values are motif, windows, and platinum. If you compiled Qt with additional styles or have additional styles as plugins these will be available to the -style command line option.
-style style, is the same as listed above.
-stylesheet= stylesheet, sets the application styleSheet. The value must be a path to a file that contains the Style Sheet. Note: Relative URLs in the Style Sheet file are relative to the Style Sheet file's path.
-stylesheet stylesheet, is the same as listed above.
-reverse, sets the application's layout direction to Qt::RightToLeft
-graphicssystem, sets the backend to be used for on-screen widgets and QPixmaps. Available options are raster and opengl.
For a complete list of options, see the relevant Qt documentation
For look and feel customization, see the Stylesheet customizing and reference documentation.

Headless Version

There is a qcma_cli binary that doesn't need a X session running (useful for servers). The daemon provides minimal interaction via unix signals. Here are some usage examples:

Send a signal to refresh the database

kill -HUP $(pgrep qcma_cli)

Send a signal to stop the daemon

kill $(pgrep qcma_cli)