Skip to content

About

Create a quiz with pixelated images.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Pixel Quiz

A Progressive Web App that turns a handful of photos into a pixelated guessing game. Pick five or more images, watch each one dissolve into big blocks, and guess what is hiding behind them. Everything runs 100% in the browser — your images never leave the device.

▶ Live app: https://trashbytes.github.io/pixel-quiz/

Pixel Quiz


How to play

Pixel Quiz is perfect for birthdays, weddings and other get-togethers — a fun way to find out how well someone really knows their friends.

You need:

  • a screen (TV, projector or monitor) — a laptop or tablet works too
  • a few photos of friends — at least 5
  • one person, or a whole team, ready to guess

The game:

  1. Select at least 5 images from your device (.jpg, .jpeg or .png) and start the game. The first photo appears heavily pixelated.
  2. While the timer runs, the player(s) try to guess who is in the picture.
  3. The longer they take, the more the image reveals itself — and the fewer points they keep.
  4. As soon as someone shouts a name (or "stop"), tap the image to pause the timer, then reveal the full picture with Reveal image.
  5. Were they right? Tap CORRECT or WRONG to score the round.
  6. Once every photo has been played, the game shows a final score.

A great way to hang rewards or forfeits off point thresholds — or just play for fun.


Features

  • 🖼️ Build a quiz from 5+ of your own photos
  • 🧩 Progressive pixelation, revealed block by block on a timer
  • 🏆 Scoring based on how few reveal steps you needed
  • ⏸️ Pause screen with right/wrong guessing flow
  • 🖥️ Fullscreen mode for playing on a TV or projector
  • 📴 Fully offline-capable via a service worker — installable as a PWA
  • 🔒 No uploads, no server: all processing happens on-device

How it works

Images are downscaled to a maximum of 1024px with image-blob-reduce, then rendered to a canvas that is progressively resized with Pica.js. Each step shrinks the canvas to a fraction of its size and stretches it back up with nearest-neighbour scaling, which produces the blocky pixel look. Points are tracked per reveal step and updated as the timer runs.


Tech

  • Mithril.js — tiny UI framework
  • Pica.js — high-quality resize
  • image-blob-reduce — client-side downscaling
  • SCSS + Material Design Icons
  • Service worker for offline support

Project structure

index.html          Entry point
manifest.json       PWA manifest
service.min.js      Service worker (offline cache)
main.min.css/js     Built bundles used by the app
css/                SCSS sources & icon webfont
js/                 JS sources (app.js, background.js, ...)
images/             App assets (icons, cover image)

Running locally

Because the app uses a service worker, it needs to be served over HTTPS or localhost — opening index.html directly won't work.

# any static file server, e.g.
python -m http.server 8080
# then open http://localhost:8080

History

Pixel Quiz was originally built in 2021 and hosted at pixel-quiz.app. In 2026 it was revived and republished: the code was reworked to run on a GitHub Pages project page (relative paths, .nojekyll) and put back online here. The revival was done with OpenCode.


Credits

About

Create a quiz with pixelated images.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages