{"id":20122319,"url":"https://github.com/adriagual/marvel-snap-bot","last_synced_at":"2026-03-15T08:04:22.874Z","repository":{"id":65228879,"uuid":"583975137","full_name":"AdriaGual/marvel-snap-bot","owner":"AdriaGual","description":"A computer vision bot made with OpenCV and ADB.","archived":false,"fork":false,"pushed_at":"2023-02-26T10:05:52.000Z","size":16226,"stargazers_count":109,"open_issues_count":27,"forks_count":26,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-09T14:22:03.289Z","etag":null,"topics":["adb","android","automation","opencv","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdriaGual.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-31T18:08:10.000Z","updated_at":"2025-03-23T07:10:13.000Z","dependencies_parsed_at":"2024-11-13T19:47:16.367Z","dependency_job_id":null,"html_url":"https://github.com/AdriaGual/marvel-snap-bot","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/AdriaGual%2Fmarvel-snap-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdriaGual%2Fmarvel-snap-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdriaGual%2Fmarvel-snap-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdriaGual%2Fmarvel-snap-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdriaGual","download_url":"https://codeload.github.com/AdriaGual/marvel-snap-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252721086,"owners_count":21793749,"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":["adb","android","automation","opencv","python3"],"created_at":"2024-11-13T19:37:06.290Z","updated_at":"2026-03-15T08:04:17.837Z","avatar_url":"https://github.com/AdriaGual.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://www.marvelsnap.com\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/25803231/210183311-556aafb7-1690-4a17-a958-9c622d8f6f07.png\" alt=\"Markdownify\" width=\"200\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  Marvel Snap Bot\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eA computer vision bot made with \u003ca href=\"https://opencv.org/\" target=\"_blank\"\u003eOpenCV\u003c/a\u003e and \u003ca href=\"https://developer.android.com/studio/command-line/adb\" target=\"_blank\"\u003eADB\u003c/a\u003e.\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"www.python.org\"\u003e\n    \u003cimg src=\"https://badgen.net/badge/python/3.8/pink?icon=terminal\"\n         alt=\"Python\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/github/repo-size/AdriaGual/marvel-snap-bot\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/repo-size/AdriaGual/marvel-snap-bot\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/v/nine\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n    \u003cimg src=\"https://badgen.net/pypi/license/pip\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#key-features\"\u003eKey Features\u003c/a\u003e •\n  \u003ca href=\"#how-to-use\"\u003eHow To Use\u003c/a\u003e •\n  \u003ca href=\"#improvements\"\u003eImprovements\u003c/a\u003e\n\u003c/p\u003e\n\n![Animation](https://user-images.githubusercontent.com/25803231/210187037-1d01c383-95ff-481a-99e3-566fe0e93715.gif)\n\n![Capture](https://user-images.githubusercontent.com/25803231/210183326-e543da5a-ef14-44e5-8cd5-770eec453c02.PNG)\n\n## Key Features\n\n- Card detection\n  - Detect player cards on live time\n- Automate the decision making\n- Mana consumption tracked\n- Fields with different priorities and constraints\n- ADB Support (Bluestacks, any version)\n- Global utils to apply for other computer vision bots\n- Calculate the power of the cards\n- Farm missions\n- Farm season pass\n- Play kazoo decks with applied logic\n- Quick usage\n\n## How To Use\n\nTo clone and run this application, you'll need [Git](https://git-scm.com), [OpenCV](https://opencv.org/), [Bluestacks](https://www.bluestacks.com/es/index.html) and [Python 3](https://www.python.org/).\nFrom your command line:\n\n```bash\n# Clone this repository\n$ git clone https://github.com/AdriaGual/marvel-snap-bot\n\n# Go into the repository\n$ cd marvel-snap-bot\n\n# Install dependencies\n$ pip install -r requirements.txt\n\n# Edit the config.py file\nadb_path: Absolute path to where you can execute ADB\nproject_path: Absolute path to the project\nimages_folder: Absolute path to the images folder\nfields_folder: Absolute path to the fields images folder\nmana_folder: Absolute path to the mana images folder\nturns_folder: Absolute path to the turns folder\ndata_folder: Absolute path to the card images folder\ntmp_path: Absolute path to a tmp folder\n\n# Make sure that Bluestacks has the ADB enabled\nSettings -\u003e Advanced -\u003e Android Debug Bridge (ADB)\n\n# Check if you have the correct resolution\nThe script is made to work on 1600x900 resolution\n```\n## Add the images to the each folder\nYou can grab them from the emulator, there is an option on the script to get the info in real time. Just change the False parameter from the functions get_my_hands_cards and get_fields.\n![image](https://user-images.githubusercontent.com/25803231/211024589-c4545e4b-523c-40f0-b1c1-3302bf1ed83b.png)\n\n## Card images structure folder\nRemember that this cards need its values entered manually on the cp_list.py file\n\n![image](https://user-images.githubusercontent.com/25803231/211023744-f587976f-be89-41a8-a798-619c8209d29e.png)\n\n## Images structure folder\n![image](https://user-images.githubusercontent.com/25803231/211023945-26312bae-9ac6-437e-82f8-18c1d9140d94.png)\n\n```bash\n# Run the bot\n$ python start.py\n```\n\n\u003e **Note**\n\u003e In order to see the bot start, you must install the game (Marvel Snap Bot) on Bluestacks and start it.\n\n## Improvements\n\nThere are plenty of improvements still, here's a bunch of:\n\n- Fields should be detected automatically\n- The points of each field is not tracked, it can be done with pytesseract\n- The cards on the player field don't show the power\n- Detect the enemy cards on the field\n- Keep track of the winrate of a session\n\n## License\n\nMIT\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadriagual%2Fmarvel-snap-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadriagual%2Fmarvel-snap-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadriagual%2Fmarvel-snap-bot/lists"}