{"id":20833071,"url":"https://github.com/kfields/tyled","last_synced_at":"2025-05-08T01:40:56.347Z","repository":{"id":43239586,"uuid":"255525941","full_name":"kfields/tyled","owner":"kfields","description":"CLI utility for generating Tiled Tilesets","archived":false,"fork":false,"pushed_at":"2023-10-04T00:55:28.000Z","size":2400,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-27T21:38:01.236Z","etag":null,"topics":["python","tiled","tiled-map-editor"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kfields.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-14T06:14:44.000Z","updated_at":"2024-08-19T07:18:18.000Z","dependencies_parsed_at":"2022-09-08T15:51:34.182Z","dependency_job_id":null,"html_url":"https://github.com/kfields/tyled","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfields%2Ftyled","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfields%2Ftyled/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfields%2Ftyled/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfields%2Ftyled/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kfields","download_url":"https://codeload.github.com/kfields/tyled/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252983761,"owners_count":21835758,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","tiled","tiled-map-editor"],"created_at":"2024-11-18T00:14:10.603Z","updated_at":"2025-05-08T01:40:56.300Z","avatar_url":"https://github.com/kfields.png","language":"Python","readme":"# Tyled :butterfly:\n\nCLI utility for generating [Tiled](https://www.mapeditor.org/) Tilesets\n\n:notebook: [Documentation](https://tyled.readthedocs.io/en/latest/)\n\n:package: [Package](https://pypi.org/project/tyled/)\n\n## Installation\n\n### From PyPI\n\n#### TLDR - do this at your own risk\n\n        pip install tyled\n\n#### Recommended - pipX\n\nIf you don't already have it installed go to https://pypi.org/project/pipx/ for instructions\n\n        pipx install tyled\n\n\n### From GitHub\n\nClone the repository\n\n        git clone https://github.com/kfields/tyled.git\n        \nNavigate to the new directory which contains the repository\n\n        cd tyled\n\nCreate a Python 3 virtual environment called `env`\n\n        python3 -m venv env\n        \nActivate the environment\n\n        source env/bin/activate\n        \nInstall required packages\n\n        pip install -r requirements.txt\n\n## Commands\n\n### Bake\n\n        tyled bake mytileset.toml [--save/--no-save][--show/--no-show][--rotation/--no-rotation]\n\n#### Options\n\nDefault options are --save, --no-show, --no-rotation\n\n## Projects\n\nTyled Projects are defined using TOML files.\n\nAll Projects must at least have a name and type\n\n```toml\nname = 'mytileset'\ntype = 'collection'\n```\n\n### Options\n\nOptions may be defined within the project file.  Any options defined here will override the command line options\n\n```toml\n[options]\nrotation = true\n```\n\n## Tilesets\n\nTyled currently supports three different kinds of Tilesets:\n\n### Collection Tileset\n\nA Collection Tileset is composed of tiles with images stored in separate files\n\n```toml\nname = 'mytileset'\ntype = 'collection'\n\nfirstgid = 1\nsource = 'sticker-knight/map'\n```\n\nThis example will generate mytileset.tsx in the current working directory\n\n### Orthogonal Tileset\n\nAn Orthogonal Tileset is composed of tiles that have the same dimensions in one image file\n\n```toml\nname = 'mytileset'\ntype = 'orthogonal'\n\nfirstgid = 1\nsource = 'platformer/tiles'\ntilewidth = 128\ntileheight = 128\nspacing = 0\nmargin = 0\ncolumns = 12\n```\n\nThis example will generate mytileset.tsx and mytileset.png in the current working directory\n\n### Atlas Tileset\n\nAn Atlas Tileset is composed of tiles that do not have the same dimensions in one image file\n\n```toml\nname = 'mytileset'\ntype = 'atlas'\n\nfirstgid = 0\nsource = 'sticker-knight/map'\nwidth = 1024\nheight = 1024\nspacing = 0\nmargin = 0\n```\n\nThis example will generate mytileset.tsx and mytileset.png in the current working directory\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkfields%2Ftyled","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkfields%2Ftyled","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkfields%2Ftyled/lists"}