{"id":45338935,"url":"https://github.com/acpayers-alt/raising-hell-cardputer","last_synced_at":"2026-04-11T18:12:10.057Z","repository":{"id":337203054,"uuid":"1150124550","full_name":"acpayers-alt/raising-hell-cardputer","owner":"acpayers-alt","description":"Open-source virtual pet firmware for the M5Stack Cardputer.","archived":false,"fork":false,"pushed_at":"2026-04-07T08:31:13.000Z","size":40439,"stargazers_count":56,"open_issues_count":0,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-04-07T10:22:42.131Z","etag":null,"topics":["arduino","cardputer","embedded-game","esp32","firmware","m5stack","virtual-pet"],"latest_commit_sha":null,"homepage":"","language":"C++","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/acpayers-alt.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-04T22:57:39.000Z","updated_at":"2026-04-07T08:31:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/acpayers-alt/raising-hell-cardputer","commit_stats":null,"previous_names":["acpayers-alt/raising-hell-cardputer"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/acpayers-alt/raising-hell-cardputer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acpayers-alt%2Fraising-hell-cardputer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acpayers-alt%2Fraising-hell-cardputer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acpayers-alt%2Fraising-hell-cardputer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acpayers-alt%2Fraising-hell-cardputer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/acpayers-alt","download_url":"https://codeload.github.com/acpayers-alt/raising-hell-cardputer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acpayers-alt%2Fraising-hell-cardputer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31690179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-11T13:07:20.380Z","status":"ssl_error","status_checked_at":"2026-04-11T13:06:47.903Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["arduino","cardputer","embedded-game","esp32","firmware","m5stack","virtual-pet"],"created_at":"2026-02-21T10:03:00.097Z","updated_at":"2026-04-11T18:12:10.052Z","avatar_url":"https://github.com/acpayers-alt.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Raising Hell — Cardputer ADV Edition\n\nA Tamagotchi-style virtual pet game for the M5Stack Cardputer ADV (ESP32).\n\nRaise your infernal companion through multiple life stages, feed it, play mini-games, manage sleep cycles, survive decay, and maybe… resurrect what should not be resurrected.\n\n![Latest Release](https://img.shields.io/github/v/release/acpayers-alt/raising-hell-cardputer)\n![Platform](https://img.shields.io/badge/platform-Cardputer%20ADV-orange)\n![License](https://img.shields.io/github/license/acpayers-alt/raising-hell-cardputer)\n\n![Raising Hell](media/rh_multicards.JPG)\n\n\n------------------------------------------------------------\nHardware Target\n------------------------------------------------------------\n\n- M5Stack Cardputer ADV\n- ESP32 (240 MHz)\n- SD card (required for assets)\n\n\n------------------------------------------------------------\nControls\n------------------------------------------------------------\n\nArrow Keys  - Navigate\n\nEnter/G       - Confirm\n\nEsc         - Menu\n\nDel/Q\n\nGO          - Screen Off/On\n\nShake Your cardputer to wake the screen\n\nHold GO     - Power Menu\n\n/           - Console\n\nKeyz Z-M are hotkeys for all the tabs\n\n(Some mini-games may use alternate input behavior.)\n\nAlternate Navigation - E,A,S,D and O,J,K,L - allows for one handed navigation\n\n\n------------------------------------------------------------\nPlanned Features\n------------------------------------------------------------\n\nloading screen for games\n\nshake sensitivity settings\n\nscreen flashes same color as alert LED (maybe even shows pet status)\n\ncreate log file as txt on sdcard for user upload\n\nadd heartbeat sequence to death flow\n\nClock Mode\n\nHuman reasable/editable settings file for easy recovery\n\n\n------------------------------------------------------------\nProject Structure\n------------------------------------------------------------\n\nsrc/        (all .cpp and .h files)\n\nassets/     Image Files\n\ndocs/       Licensing, Changelog, Contrib\n\ntools/      Asset Manifest Generator and other Dev Tools\n\n\n------------------------------------------------------------\nInstallation\n------------------------------------------------------------\n\nRaising Hell runs on the **M5Stack Cardputer ADV**.\n\nThere are three ways to install the game depending on your setup.\n\n---\n\n# 1. Install via M5Launcher (Recommended)\n\nThis is the easiest way to install Raising Hell directly from the Cardputer.\n\n### Steps\n\n1. Install **M5Launcher** on your Cardputer if it is not already installed.\n2. Connect the device to **Wi-Fi**.\n3. Open **M5Launcher**.\n4. Browse the application list and locate **Raising Hell**.\n5. Select the game and choose **Install**.\n\nAfter installation:\n\n- Launch the game from the launcher.\n- On first boot the game will **automatically provision required assets via OTA**.\n\nNo manual asset downloads are required.\n\n---\n\n# 2. Install using M5Burner\n\nYou can install the firmware from a computer using **M5Burner**.\n\n### Requirements\n\n- M5Burner installed on your computer\n- USB connection to the Cardputer ADV\n\n### Steps\n\n1. Connect the Cardputer ADV to your computer via USB.\n2. Open **M5Burner**.\n3. Search for **Raising Hell**.\n4. Select the application.\n5. Click **Burn**.\n6. Wait for flashing to complete.\n\nAfter the first launch:\n\n- The game will **download required assets automatically via OTA**.\n\n---\n\n# 3. Manual Firmware Install (Advanced)\n\nAdvanced users can manually flash the firmware using **PlatformIO or esptool**.\n\n### Step 1 — Download firmware\n\nDownload the latest firmware binary from the **GitHub Releases page**:\n\nhttps://github.com/acpayers-alt/raising-hell-cardputer/releases\n\n### Step 2 — Flash firmware\n\nFlash the firmware to the device.\n\nExample using PlatformIO:\n\n```bash\npio run -t upload\n```\n\nOr using esptool:\n\n```bash\nesptool.py --chip esp32s3 --port /dev/ttyACM0 write_flash 0x10000 firmware.bin\n```\n\n### Step 3 — Launch the game\n\nAfter booting the firmware:\n\n- The game will automatically **provision its asset pack via OTA**.\n\n---\n\n# First Boot Behavior\n\nOn first launch Raising Hell will:\n\n- Check for required game assets  \n- Download missing assets automatically  \n- Store assets on the SD card  \n\nThis process only occurs once.\n\n---\n\n# Hardware Support\n\nCurrently supported hardware:\n\nM5Stack Cardputer ADV\n\nThe original first-generation Cardputer has not been tested and may not work correctly.\n\n---\n\n# Troubleshooting\n\nIf the game fails to start:\n\n- Ensure an **SD card is installed**\n- Ensure the device has **Wi-Fi connectivity** for asset provisioning\n- Restart the device after flashing\n\n\n------------------------------------------------------------\nDevelopment Direction\n------------------------------------------------------------\n\nThis project is under active architectural cleanup and refactor toward:\n\n- Modular state architecture\n- Strict include hygiene\n- Removal of legacy globals\n- Separation of platform and gameplay logic\n- Open-source readiness\n\n\n------------------------------------------------------------\nArduino IDE Settings\n------------------------------------------------------------\n\nRecommended configuration:\n\nBoard: M5Cardputer\nFlash Mode: QIO 80MHz\nFlash Size: 4MB (32Mb)\nPartition Scheme: Huge APP (3MB No OTA / 1MB SPIFFS)\nCPU Frequency: 240MHz (WiFi)\nUpload Speed: 921600\n\n\n------------------------------------------------------------\nBuilding From Source\n------------------------------------------------------------\n\n1. Clone the repository.\n2. Copy the assets folder contents to an SD card.\n3. Open raising_hell_cpADV.ino in the Arduino IDE.\n4. Select the board settings listed above.\n5. Compile and upload.\n\n   \n------------------------------------------------------------\nKnown Limitations\n------------------------------------------------------------\n\n- Requires SD card\n- Designed specifically for Cardputer ADV hardware\n- Not optimized for alternate ESP32 boards\n\n\n------------------------------------------------------------\nLicense\n------------------------------------------------------------\n\nCode is licensed under the MIT License.\nSee the LICENSE file for details.\n\nAssets licensing is described in ASSETS_LICENSE.md.\n\n\n------------------------------------------------------------\nAuthor\n------------------------------------------------------------\n\nAaron Ayers\n\nIf you build this, fork it, improve it, or port it — I’d love to see it.\n\n\n------------------------------------------------------------\nScreenshots\n------------------------------------------------------------\n![Raising Hell](media/Raising_Hell_Credits.JPG)\n![Choose Your Pet](media/Raising_Hell_Choose.JPG)\n![Hatch Your Pet](media/Raising_Hell_Hatch.JPG)\n![NameYour Pet](media/Raising_Hell_Name.JPG)\n![Meet Your Pet](media/Raising_Hell_Meet.JPG)\n![Care for Your Pet](media/Raising_Hell_Care.JPG)\n![Raise Your Pet](media/Raising_Hell_Raise.JPG)\n![Neglect Your Pet](media/Raising_Hell_Neglect.JPG)\n![Mourn Your Pet](media/Raising_Hell_Mourn.JPG)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facpayers-alt%2Fraising-hell-cardputer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facpayers-alt%2Fraising-hell-cardputer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facpayers-alt%2Fraising-hell-cardputer/lists"}