A CLI program for converting ZX Spectrum SCR files to normal image formats such as PNG, GIF, and JPG.
Once the program is installed (see below) a SCR file can be converted with the following command:
./scrconv -scr="/path/to/game.scr"
By default format=png, scale=1 and border=true, so a 320x240 PNG image is
created in the same directory as the SCR file, with the filename game.png.
Usage of ./scrconv:
-scr string
Input .SCR filename
-format string
Image format: gif, jpg, png (default "png")
-scale int
Scale factor, max: 4 (default 1)
-border
Add a border to the image (default true)
-border-colour int
Border Colour, values: 0 - 15 (default: 0)
-auto-border
EXPERIMENTAL: Auto Detect Border Colour
-v Show version number
The scaling generates an image in one of the following resolutions:
scale | size | + border
------+----------+----------
1 | 256x192 | 320x240 (default)
2 | 512x384 | 640x480
3 | 768x576 | 960x720
4 | 1024x768 | 1280x960
When the border option is enabled, setting a border-colour will change
the colour of the border. The value should be one of the 16 ZX Spectrum
normal/bright colours; a value between 0-15. The default colour is black.
# | Colour | # | Colour
---+------------+-----+---------------
0 | Black | 8 | Black
1 | Blue | 9 | Bright Blue
2 | Red | 10 | Bright Red
3 | Magenta | 11 | Bright Magenta
4 | Green | 12 | Bright Green
5 | Cyan | 13 | Bright Cyan
6 | Yellow | 14 | Bright Yellow
7 | White | 15 | Bright White
EXPERIMENTAL
When setting the auto-border the border colour will be auto-detected based on
the most common colour in the image. This setting overrides any value given in
the border-colour.
go install github.com/mrcook/scrconv/cmd/scrconv@latest
To install the program after manually cloning the repository:
cd scrconv
go install ./cmd/scrconv
Copyright (c) 2021-2023 Michael R. Cook. All rights reserved.
This work is licensed under the terms of the MIT license. For a copy, see https://opensource.org/licenses/MIT.