{"id":21253912,"url":"https://github.com/cleverdevil/skyfall","last_synced_at":"2025-07-01T09:34:45.122Z","repository":{"id":262346838,"uuid":"886946711","full_name":"cleverdevil/Skyfall","owner":"cleverdevil","description":"Skydiver game for AWS re:Invent 2024 written with Python, pygame, and Amazon Q Developer","archived":false,"fork":false,"pushed_at":"2024-11-26T19:16:28.000Z","size":472,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-30T06:45:36.418Z","etag":null,"topics":[],"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/cleverdevil.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-11T22:34:19.000Z","updated_at":"2024-11-26T19:16:32.000Z","dependencies_parsed_at":"2024-11-12T00:25:33.221Z","dependency_job_id":"7a9a4cb2-e496-48cf-b644-17e6dd5c85c0","html_url":"https://github.com/cleverdevil/Skyfall","commit_stats":null,"previous_names":["cleverdevil/skyfall"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cleverdevil/Skyfall","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cleverdevil%2FSkyfall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cleverdevil%2FSkyfall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cleverdevil%2FSkyfall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cleverdevil%2FSkyfall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cleverdevil","download_url":"https://codeload.github.com/cleverdevil/Skyfall/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cleverdevil%2FSkyfall/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262936598,"owners_count":23387405,"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":[],"created_at":"2024-11-21T03:53:27.477Z","updated_at":"2025-07-01T09:34:45.077Z","avatar_url":"https://github.com/cleverdevil.png","language":"Python","readme":"Skyfall\n=======\nSkyfall is a simple game written in [Python](https://python.org) using the\nexcellent [Pygame](https://pygame.org) project. The game allows the player to\ncontrol a falling skydiver, dodging helicopters, and collecting points for\nflying through the clouds. The game is designed to be run on a macOS computer or\non the web, and was built for [Mission](https://missioncloud.com)'s 2024 AWS\nre:Invent contest on the show floor.\n\nInstallation\n------------\nFirst, I recommend creating and activating a Python `virtualenv`, using Python\n3.10 or higher. Then, you can simply run:\n\n`pip install .`\n\nThis will download all of the dependencies and install them into your virtual\nenvironment, enbabling you to run the game or build a distributable version as a\nbinary or on the web.\n\nRunning Locally\n---------------\nIf you want to run the game from the CLI, after installation you can simply run:\n\n`python main.py`\n\nYou control the Skydiver using the arrow keys on your keyboard. By default, when\nrunning locally, the game maintains a leaderboard inside an\n[SQLite](https://sqlite.org) database. The leaderboard will be displayed\nin-game, and you can also print it out locally by running:\n\n`sqlite3 leaderboard.db \u003c results.sql`\n\nThe output is in an ASCII tabular format.\n\nBuilding\n--------\n\n### Distributable Binary\nSkyfall's included `Makefile` has a target named `app` that uses\n[PyInstaller](https://pyinstaller.org) to create a distributable binary for\nmacOS. In their infinite wisdom, Apple has locked down the ability to run\nself-built apps without going through a massive number of hoops, which I have\ndecided to skip, which makes things a bit less user-friendly, but is good\nenough.\n\nTo build, run: `make app`. Inside the `application` folder will be a few shell\nscripts and a hidden `.Skyfall.app` bundle. You can run the game by either\ndouble clicking on `Skyfall`, or by executing it from the CLI. You can view the\nlatest leaderboard by double-clicking on `Leaderboard` or running it from the\nCLI. It drops a text file onto your desktop.\n\n### For the Web\nSkyfall's included `Makefile` has a target named `web` that uses\n[Pygbag](https://github.com/pygame-web/pygbag) to compile the game to\nWebAssembly to play on the web. Simply run `make web`, and it will build the\n`wasm` and serve it on `localhost`. The files can be copied to a web server to\nmake publicly available.\n\nThe web version works great both with keyboard and touch interfaces on phones\nand tablets. When using touch, simply touch the left or right side of the screen\nto move the skydiver.\n\nNOTE: the web build does not feature a leaderboard.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcleverdevil%2Fskyfall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcleverdevil%2Fskyfall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcleverdevil%2Fskyfall/lists"}