asetools


Nameasetools JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummaryTools to work with Aseprite files
upload_time2024-07-11 06:09:07
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseApache 2.0
keywords aseprite image conversion
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Asetools

[Aseprite][] is a wonderful pixelart tool. Unfortunately its license is not OSI compliant, even if the source code is available. This makes it complicated to rely on the tool being available everywhere it's needed. This is a problem for CI servers or open-source application stores like F-Droid.

Asetools are open-source command-line tools to work with Aseprite images.

[Aseprite]: https://aseprite.com

## Tools

### asesplit

The `asesplit` tool turns .ase images into .png. It can extract individual layers and/or slices, trim and rotate them.

<!-- [[[cog
from subprocess import run
p = run(["asesplit", "--help"], check=True, capture_output=True, text=True)
print(f"```\n{p.stdout}```")
]]] -->
```
usage: asesplit [-h] [--split-layers] [--split-slices] [--trim]
                [--rotate ANGLE] [--dry-run]
                ase_file format

Turn an Aseprite file into one or several png files.

positional arguments:
  ase_file
  format          Define the name of the generated files. Supported keywords:
                  {title}, {layer}, {frame}, {slice}

options:
  -h, --help      show this help message and exit
  --split-layers
  --split-slices
  --trim
  --rotate ANGLE  Rotate image by ANGLE degrees counter-clockwise
  --dry-run
```
<!-- [[[end]]] -->

### aseinfo

The `aseinfo` tool gives you information about the content of a .ase file.

<!-- [[[cog
from subprocess import run
p = run(["aseinfo", "--help"], check=True, capture_output=True, text=True)
print(f"```\n{p.stdout}```")
]]] -->
```
usage: aseinfo [-h] [-j] ase_file

Display info about an aseprite file

positional arguments:
  ase_file

options:
  -h, --help  show this help message and exit
  -j, --json  JSON output
```
<!-- [[[end]]] -->

## Installation

The recommended way to install is using [pipx][].

```
pipx install asetools
```

[pipx]: https://pipx.pypa.io/stable/

## Tests

You can run tests using `pytest`. Just run `pytest` in this directory.

## Warning

Asetools works well for me: it has been used for years now in [Pixel Wheels](https://agateau.com/projects/pixelwheels), but its support for .ase files is limited to the subset of Aseprite features I use. In particular, it currently only supports sprites with a color palette.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "asetools",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "aseprite, image, conversion",
    "author": null,
    "author_email": "Aurelien Gateau <mail@agateau.com>",
    "download_url": "https://files.pythonhosted.org/packages/43/b5/7dd62bb9ef25690e01f82feb3d86ce580ebc965baf7aa9e042f73ea431cf/asetools-0.1.1.tar.gz",
    "platform": null,
    "description": "# Asetools\n\n[Aseprite][] is a wonderful pixelart tool. Unfortunately its license is not OSI compliant, even if the source code is available. This makes it complicated to rely on the tool being available everywhere it's needed. This is a problem for CI servers or open-source application stores like F-Droid.\n\nAsetools are open-source command-line tools to work with Aseprite images.\n\n[Aseprite]: https://aseprite.com\n\n## Tools\n\n### asesplit\n\nThe `asesplit` tool turns .ase images into .png. It can extract individual layers and/or slices, trim and rotate them.\n\n<!-- [[[cog\nfrom subprocess import run\np = run([\"asesplit\", \"--help\"], check=True, capture_output=True, text=True)\nprint(f\"```\\n{p.stdout}```\")\n]]] -->\n```\nusage: asesplit [-h] [--split-layers] [--split-slices] [--trim]\n                [--rotate ANGLE] [--dry-run]\n                ase_file format\n\nTurn an Aseprite file into one or several png files.\n\npositional arguments:\n  ase_file\n  format          Define the name of the generated files. Supported keywords:\n                  {title}, {layer}, {frame}, {slice}\n\noptions:\n  -h, --help      show this help message and exit\n  --split-layers\n  --split-slices\n  --trim\n  --rotate ANGLE  Rotate image by ANGLE degrees counter-clockwise\n  --dry-run\n```\n<!-- [[[end]]] -->\n\n### aseinfo\n\nThe `aseinfo` tool gives you information about the content of a .ase file.\n\n<!-- [[[cog\nfrom subprocess import run\np = run([\"aseinfo\", \"--help\"], check=True, capture_output=True, text=True)\nprint(f\"```\\n{p.stdout}```\")\n]]] -->\n```\nusage: aseinfo [-h] [-j] ase_file\n\nDisplay info about an aseprite file\n\npositional arguments:\n  ase_file\n\noptions:\n  -h, --help  show this help message and exit\n  -j, --json  JSON output\n```\n<!-- [[[end]]] -->\n\n## Installation\n\nThe recommended way to install is using [pipx][].\n\n```\npipx install asetools\n```\n\n[pipx]: https://pipx.pypa.io/stable/\n\n## Tests\n\nYou can run tests using `pytest`. Just run `pytest` in this directory.\n\n## Warning\n\nAsetools works well for me: it has been used for years now in [Pixel Wheels](https://agateau.com/projects/pixelwheels), but its support for .ase files is limited to the subset of Aseprite features I use. In particular, it currently only supports sprites with a color palette.\n",
    "bugtrack_url": null,
    "license": "Apache 2.0",
    "summary": "Tools to work with Aseprite files",
    "version": "0.1.1",
    "project_urls": {
        "Homepage": "https://gitlab.com/agateau/asetools",
        "Repository": "https://gitlab.com/agateau/asetools"
    },
    "split_keywords": [
        "aseprite",
        " image",
        " conversion"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e69894d762a47c67e503c5f1db849a2aca4841899e251d5261307541671df88a",
                "md5": "e292b1e469967a715072be793c9eac03",
                "sha256": "5a48e9b0866d7586420aeb3d0ef16aa9c59a191bb5620de143e3cf0a314019cf"
            },
            "downloads": -1,
            "filename": "asetools-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e292b1e469967a715072be793c9eac03",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 11693,
            "upload_time": "2024-07-11T06:09:05",
            "upload_time_iso_8601": "2024-07-11T06:09:05.386872Z",
            "url": "https://files.pythonhosted.org/packages/e6/98/94d762a47c67e503c5f1db849a2aca4841899e251d5261307541671df88a/asetools-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "43b57dd62bb9ef25690e01f82feb3d86ce580ebc965baf7aa9e042f73ea431cf",
                "md5": "59c540a9517302a225968149246cf5da",
                "sha256": "4a32dc2379a8f5a31ded1fc214d97787382bf7e2e00e6bf960d1e426f29064a0"
            },
            "downloads": -1,
            "filename": "asetools-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "59c540a9517302a225968149246cf5da",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 12091,
            "upload_time": "2024-07-11T06:09:07",
            "upload_time_iso_8601": "2024-07-11T06:09:07.489339Z",
            "url": "https://files.pythonhosted.org/packages/43/b5/7dd62bb9ef25690e01f82feb3d86ce580ebc965baf7aa9e042f73ea431cf/asetools-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-11 06:09:07",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "agateau",
    "gitlab_project": "asetools",
    "lcname": "asetools"
}
        
Elapsed time: 0.26863s