> psychoraw --help
psychoraw --help
> psychoraw --version
PsychoRaw v1.0.1 (2026) - Universal Raw Image Analyzer and Converter
Documentation overview This section provides practical information about usage, compatibility, external tools, examples, and ways to troubleshoot common errors. It is divided into the following topics: About, Installation, Usage, Commands, Conversion, Rotation & Zoom, Formats, Metadata, Tools, Examples, and Errors.
ABOUT
PsychoRaw is a command-line tool for analyzing and converting Raw camera files.
It provides metadata extraction, image information, and conversion capabilities.
> psychoraw IMG_1234.ARW
File: IMG_1234.ARW
Brand: Sony
Width: 6000 px
Height: 4000 px
Orientation: Landscape
Aspect Ratio: 1.500
File Size: 24.53 MB (25,723,456 bytes)
INSTALLATION
Requirements:
- Python 3.7+ (or Windows executable)
- Optional: ExifTool, MediaInfo, FFmpeg
Directory Structure:
.
├── psychoraw.exe
├── exiftool.exe (optional)
├── mediainfo.exe (optional)
├── ffmpeg.exe (optional)
├── ffprobe.exe (optional)
├── FFMPEG\
├── ExifTool\
└── MediaInfo\
BASIC USAGE
> psychoraw <input_file> [options]
Quick Examples:
> psychoraw IMG.ARW        # Basic analysis
> psychoraw IMG.CR3 --info # Show all information
> psychoraw IMG.NEF -c png # Convert to PNG
COMMAND REFERENCE
General Options:
OPTION DESCRIPTION
--help, -h, /? Show help
--help-tools, -ht Show tools status
--version, -v Show version
--tools, -t Show detected tools
--silent, -s Silent mode
Information Options:
OPTION DESCRIPTION
--info, -i All information
--info-all, -ia All collected info
--info-hve, -ihv Orientation only
--info-wh, -iwh Width & height
--info-size, -is File size
--info-Raw, -ir Sensor dimensions
--exif-all All EXIF data
--psycho, -ps Full metadata dump
CONVERSION
COMMAND FORMAT
-c png, --convert png PNG
-c jpg, --convert jpg JPEG
-c jpeg, --convert jpeg JPEG
-c webp, --convert webp WEBP
Settings: PNG=6, JPEG=95, WEBP=90
ROTATION & ZOOM
Rotation (positive = clockwise, negative = counter-clockwise):
> psychoraw IMG.ARW -c jpg --rotate 90     # Rotate 90° CW
> psychoraw IMG.ARW -c jpg --rotate -90    # Rotate 90° CCW
> psychoraw IMG.ARW -c jpg -r 180          # Rotate 180°
Zoom / Scale (positive = enlarge, negative = shrink):
> psychoraw IMG.ARW -c png --zoom 150      # 150% (enlarge)
> psychoraw IMG.ARW -c png --zoom -50      # 50% (shrink)
> psychoraw IMG.ARW -c png --scale 1.5     # Factor 1.5 = 150%
> psychoraw IMG.ARW -c png -sc 0.75        # Factor 0.75 = 75%
Values: 100=original, 200=double, 50=half
SUPPORTED RAW FORMATS
EXTENSION MANUFACTURER
.ARWSony
.CR2Canon
.CR3Canon
.NEFNikon
.DNGAdobe/Leica/Pentax/Samsung/DJI
.RAFFujifilm
.RW2Panasonic
.ORFOlympus/OM System
.PEFPentax
.SRWSamsung
.3FRHasselblad
.FFFHasselblad
.NRWNikon
.GPRGoPro
.IIQPhase One
.X3FSigma/Foveon
.DCRKodak
.MEFMamiya
.MOSLeaf/Creo
.ERFEpson
.CS1Sinar
.CZ1Zeiss
.K25Kodak
.KDCKodak
.SRFSamsung
.RawGeneric
METADATA
Standard EXIF: Camera, Model, Lens, FocalLength, Aperture,
Shutter, ISO, Date/Time, Age, GPS
> psychoraw IMG.ARW --psycho        # Full metadata dump
> psychoraw IMG.ARW --exif-all      # All EXIF data
EXTERNAL TOOLS
ExifTool: https://exiftool.org/
MediaInfo: https://mediaarea.net/en/MediaInfo
FFmpeg: https://ffmpeg.org/
Updates:
> psychoraw --update-tools          # Update all
> psychoraw --update-ffmpeg         # Update FFmpeg
> psychoraw --update-exiftool       # Update ExifTool
> psychoraw --update-mediainfo      # Update MediaInfo
EXAMPLES
> psychoraw IMG.ARW --info-hve                      # Orientation only
> psychoraw IMG.CR3 -c png                          # Convert CR3 to PNG
> psychoraw IMG.ARW -c jpg --rotate 90 --zoom 150   # Rotate + zoom
> psychoraw IMG.CR3 -c png -r -90 -z 50             # Rotate -90° + shrink 50%
TROUBLESHOOTING
[ERROR] File not found
Check path. Use quotes for spaces.
[ERROR] Unsupported Raw format
Check supported formats list.
[WARN] ExifTool not found
Install: https://exiftool.org/
[WARN] MediaInfo not found
Install: https://mediaarea.net/en/MediaInfo
[WARN] FFmpeg/FFprobe not found
Install: https://ffmpeg.org/download.html
Error Logging:
> psychoraw IMG.ARW --ErrorLog=error.log
> psychoraw IMG.ARW --NoErrWarning
PsychoRaw v1.0.1 (2026) | https://psychoraw.lol
↑