https://github.com/taylus/gameboy-graphics

Convert images to Game Boy color palettes using JavaScript or .NET
https://github.com/taylus/gameboy-graphics

asp-net-core azure-functions dotnet-core gameboy image-processing imagesharp

Last synced: 5 months ago
JSON representation

Convert images to Game Boy color palettes using JavaScript or .NET

• Host: GitHub
• URL: https://github.com/taylus/gameboy-graphics
• Owner: taylus
• Created: 2019-07-28T00:23:16.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-10-17T08:20:45.000Z (8 months ago)
• Last Synced: 2025-10-18T11:35:46.612Z (8 months ago)
• Topics: asp-net-core, azure-functions, dotnet-core, gameboy, image-processing, imagesharp
• Language: C#
• Homepage: https://taylus.github.io/gameboy-graphics/GBGraphics.StaticSite/
• Size: 1.56 MB
• Stars: 24
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# gbgfx 

Convert images into the Game Boy's color palette -- written in .NET Core using [ImageSharp](https://github.com/SixLabors/ImageSharp).

![sample input](screenshots/example_input.png "sample input")

![sample output](screenshots/example_output.png "sample output")

[![Build Status](https://travis-ci.org/taylus/gameboy-graphics.svg?branch=master)](https://travis-ci.org/taylus/gameboy-graphics)

[![Coverage Status](https://coveralls.io/repos/github/taylus/gameboy-graphics/badge.svg?branch=master)](https://coveralls.io/github/taylus/gameboy-graphics?branch=master)

This repository consists of a core library used by multiple different projects formats and served as an experiment in image processing on both the client and server using JavaScript, ASP.NET Core MVC, Blazor, and Azure Functions.

## Web application

[Click here for a live demo of the `GBGraphics.StaticSite` project.](https://legacy.codes/gameboy-graphics/GBGraphics.StaticSite/)

Alternatively, run the `GBGraphics.Web` project from Visual Studio or the .NET Core CLI:

![web app screenshot](screenshots/screenshot_webapp.png "web app screenshot")

## Command line usage

Run `GBGraphics.Console` from the command line:

```

gbgfx [-r] [-o output.png] input.png

```

`-r`

    Resize the output image to fit the Game Boy's screen (160 x 144 pixels).

`-o outfile`

    The name of the output file.

## Display images on a Game Boy

See here for instructions on how to [build a ROM](building_a_rom.md) which displays images produced by `gbgfx`.

![displaying images on a Game Boy](screenshots/running_on_gbc.jpg "displaying images on a Game Boy")