# VSRS
A library and command line tool to rescale MSX/ViennaSweeper skins.
Skins are tilemaps for Minesweeper clones. The format was originally
established by Curtis Bright for MSX - Vienna MineSweeper uses a generalized
version of it to support arbitrary square sizes (and, of course, skins).
Requires Pillow.
Requires an image viewer for the `-s` flag (see below).
## Usage
For detailed usage instructions, run the tool with `-h`:
```
$ vsrs -h
usage: vsrs.py [-h] [-s] [-b BACKGROUND] [-o OUTPUT] input output_size
Resize MSX/Vienna MineSweeper skins
positional arguments:
input input file to be scaled or html color code formatted like #rrggbb. If a color code is passed, generate a template for that output size using this as a foreground color
output_size output square size, in pixels
options:
-h, --help show this help message and exit
-s, --show show the generated skin in a popup
-b, --background BACKGROUND
background color for skin
-o, --output OUTPUT write output to file OUTPUT
Happy Sweeping!
$
```
### Examples
Scale `in.bmp` to a 33px square size skin and show it in a popup:
```
$ vsrs in.bmp 33 -s
```
Scale `in.bmp` to a 33px square size skin and save it in `out.bmp`:
```
$ vsrs in.bmp 33 -o out.bmp
```
Make a template for a 33px square size skin, using `#ff0000` for the elements and `#0000ff` for the background color, show the result in a popup, and also save it in `out.bmp`:
```
$ vsrs "#ff0000" 33 -o out.bmp -b "#0000ff"
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ralokt/vsrs/",
"name": "vsrs",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "minesweeper, vsweep, viennasweeper, vienna minesweeper",
"author": "Thomas Kolar",
"author_email": "ralokt@ralokt.at",
"download_url": "https://files.pythonhosted.org/packages/65/17/1c69784b3629e7251b2bd8116f315b8bf9d50cdd32c3de174fcf798be700/vsrs-0.1.0.tar.gz",
"platform": "all",
"description": "# VSRS\n\nA library and command line tool to rescale MSX/ViennaSweeper skins.\n\nSkins are tilemaps for Minesweeper clones. The format was originally\nestablished by Curtis Bright for MSX - Vienna MineSweeper uses a generalized\nversion of it to support arbitrary square sizes (and, of course, skins).\n\nRequires Pillow.\n\nRequires an image viewer for the `-s` flag (see below).\n\n## Usage\n\nFor detailed usage instructions, run the tool with `-h`:\n```\n$ vsrs -h\nusage: vsrs.py [-h] [-s] [-b BACKGROUND] [-o OUTPUT] input output_size\n\nResize MSX/Vienna MineSweeper skins\n\npositional arguments:\n input input file to be scaled or html color code formatted like #rrggbb. If a color code is passed, generate a template for that output size using this as a foreground color\n output_size output square size, in pixels\n\noptions:\n -h, --help show this help message and exit\n -s, --show show the generated skin in a popup\n -b, --background BACKGROUND\n background color for skin\n -o, --output OUTPUT write output to file OUTPUT\n\nHappy Sweeping!\n$\n```\n\n### Examples\n\nScale `in.bmp` to a 33px square size skin and show it in a popup:\n```\n$ vsrs in.bmp 33 -s\n```\n\nScale `in.bmp` to a 33px square size skin and save it in `out.bmp`:\n```\n$ vsrs in.bmp 33 -o out.bmp\n```\n\nMake a template for a 33px square size skin, using `#ff0000` for the elements and `#0000ff` for the background color, show the result in a popup, and also save it in `out.bmp`:\n```\n$ vsrs \"#ff0000\" 33 -o out.bmp -b \"#0000ff\"\n```\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Library and command line tool to rescale MSX/ViennaSweeper skins",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/ralokt/vsrs/"
},
"split_keywords": [
"minesweeper",
" vsweep",
" viennasweeper",
" vienna minesweeper"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "08b5ef11bd86c96c3b6689e6f3861188de8414fc13769b5a74bc377a66166753",
"md5": "64693cff2124ec45fa1ee39d1e6829c8",
"sha256": "9d7051b67dd7400b507c9ca7575f51482bfef0bf3365a8dcf8660cd061d5a6b6"
},
"downloads": -1,
"filename": "vsrs-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "64693cff2124ec45fa1ee39d1e6829c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6485,
"upload_time": "2025-08-18T00:32:43",
"upload_time_iso_8601": "2025-08-18T00:32:43.995550Z",
"url": "https://files.pythonhosted.org/packages/08/b5/ef11bd86c96c3b6689e6f3861188de8414fc13769b5a74bc377a66166753/vsrs-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "65171c69784b3629e7251b2bd8116f315b8bf9d50cdd32c3de174fcf798be700",
"md5": "c92d85e3be35aa00d91625c35d9f3297",
"sha256": "015f9f9db46676ec7ea0723bbd9b8645e310b9bb599c3225a50d7adfb6a13b08"
},
"downloads": -1,
"filename": "vsrs-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "c92d85e3be35aa00d91625c35d9f3297",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13514,
"upload_time": "2025-08-18T00:32:45",
"upload_time_iso_8601": "2025-08-18T00:32:45.647196Z",
"url": "https://files.pythonhosted.org/packages/65/17/1c69784b3629e7251b2bd8116f315b8bf9d50cdd32c3de174fcf798be700/vsrs-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-18 00:32:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ralokt",
"github_project": "vsrs",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"tox": true,
"lcname": "vsrs"
}
JSON
