{"id":15015487,"url":"https://github.com/codetorex/spritex","last_synced_at":"2025-07-21T22:33:54.089Z","repository":{"id":57470343,"uuid":"102976545","full_name":"codetorex/spritex","owner":"codetorex","description":"A simple tool for extracting sprites from full frames. Useful for AI projects.","archived":false,"fork":false,"pushed_at":"2017-09-15T02:19:24.000Z","size":223,"stargazers_count":29,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-18T13:45:54.737Z","etag":null,"topics":["artificial-intelligence","kivy","kivy-framework","python3","tools"],"latest_commit_sha":null,"homepage":null,"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/codetorex.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":"2017-09-09T18:30:52.000Z","updated_at":"2024-08-27T22:42:26.000Z","dependencies_parsed_at":"2022-09-19T10:01:53.459Z","dependency_job_id":null,"html_url":"https://github.com/codetorex/spritex","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/codetorex/spritex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetorex%2Fspritex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetorex%2Fspritex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetorex%2Fspritex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetorex%2Fspritex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codetorex","download_url":"https://codeload.github.com/codetorex/spritex/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codetorex%2Fspritex/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266393207,"owners_count":23922329,"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","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["artificial-intelligence","kivy","kivy-framework","python3","tools"],"created_at":"2024-09-24T19:47:32.173Z","updated_at":"2025-07-21T22:33:54.059Z","avatar_url":"https://github.com/codetorex.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# spritex\nA simple tool for extracting sprites from full frames. Useful for AI projects. Made using Python 3, Kivy, pillow and numpy.\n\n\n## Installation\n\n### PyPI\n\n```pip install spritex```\n\nAfter running this command ```spritex``` command should be accessible from terminal.\n\n### For development and git cloning\n\nThere is ```install.sh``` which will create a symbolic link from \"bin/spritex\" to \"/usr/local/bin\" folder. Which enables ```spritex``` command to be executed from terminal.\n\n### Dependencies\n* numpy==1.12.1\n* Kivy\u003e=1.10.0\n* pillow\u003e=2.1.0\n\nYou can install dependencies via pip: \n\n```pip install -r requirements.txt --upgrade```\n\n#### Arch Linux\nYou can install dependencies via pacman.\n\n```sudo pacman -S python-pillow python-kivy python-numpy```\n\n## Usage\nYou can open image files through ```spritex path.png```. If you use SDL2 backend you can drag and drop image files on to application window.\n\n### General functionality\n* Toggle grid: Shows pixel grid when zoomed in. \n    * Zoom should be at least 8 screen pixels = 1 image pixel.\n* Select region: Allows you to select a rectangular region in image via mouse drag and drop. \n    * After a region selected roughly, it is possible to fine tune by arrow keys. \n* Copy Region to Clipboard: Copies the selected region coordinates to clipboard in **(y1,x1,y2,x2)** format.\n\n### Keyboard shortcuts\n\n* Without any modifiers arrow keys will move selection around by 1 px.\n* With Ctrl modifier selection will grow on bottom and right side by 1 px.\n* With Alt modifier selection will grow on top and left side by 1 px.\n* With shift modifier all operations will do 5px.\n\n### Extract Operations\n* Sprite: will create an image from selection into same folder of source image. \n    * *Useful at creating training data for ANN classifiers.*\n* Unique colors: will extract unique colors of the selection relative to rest of the image. Output will be (unique color count)x1 image and will be saved into same folder with source. \n    * *Useful at locating simple objects that represented by unique colors from screen frame.* \n* Unique sprite: will extract an image that is same size of selection but unique colors only.\n    * *Useful at locating simple objects that represented by unique colors at unique positions from screen frame.*\n* Transparent sprite: will extract an transparent image from multiple images of same folder. Mismatching pixels will be discarded and transparent.\n    * *Useful at extracting exact sprite. When background is animating but sprite is not moving.*\n\n#### Overlays Functionality\n\nDynamically updates the selection window with selected operation. Useful for previewing the output.\n\n### Screenshots\n\n![Screenshot](https://github.com/codetorex/spritex/raw/screenshots/screenshot00.png?raw=true \"Screenshot\")\n\n![Screenshot](https://github.com/codetorex/spritex/raw/screenshots/screenshot01.png?raw=true \"Screenshot\")","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodetorex%2Fspritex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodetorex%2Fspritex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodetorex%2Fspritex/lists"}