Pixel Shelf is a web server that can be used to track and organize your video game collection. With rich metadata, you can see all the details about a particular game in your collection at a glance, including cost breakdown, game progress, and the condition of the physical copy.
- NPM and Node.js
- SQLite3
- Node-Sass
- IGDB API Access Credentials
The provided Dockerfile will allow you to run Pixel Shelf in a container. Note that you will still need to provide your own IGDB credentials, Apple Maps key, and game rating icons for full functionality.
docker build -t pixel-shelf . && docker run -p 0.0.0.0:3000:3000 pixel-shelfOnce running, your instance will be accessible on your localhost at port 3000 by default. Navigate to it in your web browser of choice.
http://localhost:3000
- Clone or fork the repository
- Run
npm install - In the project folder, initialize the SQLite3 database with the following commands:
cd models
mkdir db
cat initdb.sql | sqlite3 db/pixelshelf.db- Run
npx node-sass --omit-source-map-url sass/styles.scss public/stylesheets/styles.cssfrom the project folder to build the CSS - Create folders for images and rating icons according to the following file structure: ./public/images/ratings
- Create a
config.jsonfile
{
"client_id": "igdb_client_id",
"client_secret": "igdb_client_secret",
"token": "igdb_token",
"maps-key-path": "path/to/maps.p8",
"maps-key-id": "key_id",
"maps-team-id": "team_id"
}- Run
npm startto run the web server on localhost:3000
Note: You must provide your own icons for game ratings.
E-ink clients can be setup to fetch data from the API. All e-ink logic is contained within the eink folder. At the moment, the Adafruit 2.13" Monochrome E-Ink Bonnet for Raspberry Pi is currently supported. Running the eink.py script with Python on the e-ink client will allow the application to display the size of your game collection on the screen. The buttons with cycle through the different screens, including wishlist size and game identification mode, allowing a USB barcode scanner to display the name of a scanned game (provided the UPC is in the database). Note that using a lower-model Pi, such as a Raspberry Pi Zero, will cause refresh rates to be slow. At the moment, one screen change make take around ten seconds on these models.
CSS framework provided by Bulma.
Auto-generated cover art, tags, ratings, and descriptions are from IGDB's API.
Maps are generated by Apple Maps via MapKit JS.
Charts are from Chart.js.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent