# kitao/pyxel

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/kitao-pyxel).**

17,547 stars · 925 forks · Rust · NOASSERTION

## Links

- GitHub: https://github.com/kitao/pyxel
- awesome-repositories: https://awesome-repositories.com/repository/kitao-pyxel.md

## Description

Pyxel is a Python-based retro game engine designed for creating pixel-art applications with vintage aesthetics. It functions as a pixel art framework that emulates classic hardware limitations through fixed-resolution displays, constrained color palettes, and a 2D tilemap engine for rendering scaled sprites and grid-based game worlds.

The engine features a dedicated MML audio synthesizer that uses Macro Language notation to compose and play back retro-style sound sequences. It also includes capabilities for seed-based background music generation and the playback of raw PCM audio data for custom sound effects.

The system provides a broader set of tools for media and physics, including TMX map imports, tilemap collision detection, and custom font rendering. Additional capabilities cover sprite transformations, screen capture, and a headless mode for executing logic and audio playback without a graphical user interface.

## Tags

### Game Development

- [Retro-Constrained Engines](https://awesome-repositories.com/f/game-development/game-engines-frameworks/game-engines/game-development-engines/retro-constrained-engines.md) — Provides a simplified retro engine designed for pixel-art applications with constrained vintage specifications. ([source](https://kitao.github.io/pyxel-user-examples/))
- [Pixel Art Frameworks](https://awesome-repositories.com/f/game-development/pixel-art-frameworks.md) — Provides a complete framework for creating pixel-art applications with vintage hardware limitations.
- [Game Loops](https://awesome-repositories.com/f/game-development/engine-architecture/game-loops.md) — Ships a fixed-timestep game loop to ensure consistent gameplay speed across different hardware.
- [Pixel Tilemap Engines](https://awesome-repositories.com/f/game-development/game-engines-frameworks/2d-engines/pixel-tilemap-engines.md) — Ships a 2D tilemap engine for rendering scaled sprites and importing TMX maps.
- [Retro Game Engines](https://awesome-repositories.com/f/game-development/retro-game-engines.md) — Implements a Python-based retro game engine for creating pixel-art applications with a vintage aesthetic.
- [Tilemap and Sprite Integration](https://awesome-repositories.com/f/game-development/game-engines-frameworks/2d-engines/2d-game-frameworks/tilemap-and-sprite-integration.md) — Integrates TMX tilemaps and scaled sprites to create structured 2D game worlds.
- [Collision Detection](https://awesome-repositories.com/f/game-development/physics-engines/collision-detection.md) — Implements collision detection between game objects and grid-based tilemap entries. ([source](https://github.com/kitao/pyxel/blob/main/CHANGELOG.md))
- [Retro Sound Design](https://awesome-repositories.com/f/game-development/retro-sound-design.md) — Enables classic gaming sound design via MML notation and PCM audio streaming.
- [TMX Map Imports](https://awesome-repositories.com/f/game-development/tmx-map-imports.md) — Supports loading map data from external TMX XML files into the tilemap system. ([source](https://github.com/kitao/pyxel/blob/main/CHANGELOG.md))

### Graphics & Multimedia

- [Macro Language Music Notation](https://awesome-repositories.com/f/graphics-multimedia/macro-language-music-notation.md) — Allows defining musical sequences and sounds using a text-based Macro Language notation. ([source](https://github.com/kitao/pyxel/blob/main/CHANGELOG.md))
- [Audio Synthesis](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/audio-processing-systems/audio-synthesis.md) — Includes an audio synthesis system that generates wave forms in real-time from MML notation.
- [Raw Audio Streamers](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback/raw-audio-streamers.md) — Provides an interface for streaming raw PCM audio samples to produce custom sound effects. ([source](https://github.com/kitao/pyxel/blob/main/CHANGELOG.md))
- [Sprite Manipulation Tools](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/sprite-manipulation-tools.md) — Supports drawing images with custom rotation and scaling transformations on the screen. ([source](https://github.com/kitao/pyxel/blob/main/CHANGELOG.md))

### Artificial Intelligence & ML

- [Deterministic Seeded Generation](https://awesome-repositories.com/f/artificial-intelligence-ml/generative-audio-engines/deterministic-seeded-generation.md) — Creates deterministic background music tracks using a seed-based procedural audio engine.
- [Deterministic Background Music](https://awesome-repositories.com/f/artificial-intelligence-ml/generative-music-agents/deterministic-background-music.md) — Generates deterministic background music tracks using a seed-based generator. ([source](https://github.com/kitao/pyxel/blob/main/CHANGELOG.md))

### Development Tools & Productivity

- [Rapid Prototyping Environments](https://awesome-repositories.com/f/development-tools-productivity/rapid-prototyping-environments.md) — Provides a simplified environment for rapidly prototyping interactive graphics and logic.

### User Interface & Experience

- [Raster Primitives](https://awesome-repositories.com/f/user-interface-experience/drawing-tools/raster-primitives.md) — Implements raster primitives for efficient pixel manipulation and sprite rendering.
- [Integer-Based Pixel Grids](https://awesome-repositories.com/f/user-interface-experience/layout-density-utilities/resolution-independent-engines/coordinate-grids/integer-based-pixel-grids.md) — Uses an integer-based pixel grid coordinate system to maintain a vintage low-resolution aesthetic.

### Part of an Awesome List

- [Game Engines and Frameworks](https://awesome-repositories.com/f/awesome-lists/devtools/game-engines-and-frameworks.md) — Retro-style game engine for Python.