⚠️ This project is currently pre-alpha and should be considered a WIP: breaking changes are to be expected frequently, and most functionality is missing/partially implemented!
Trophies.gg is a lightweight, self-hosted trophy tracker for PSN. The entire web app (including the backend, frontend, and persistent storage/database) is published as a single zero-dependency Docker image!
Trophies.gg is distributed as a Docker image. The steps involve performing SQL migrations (this needs to happen on a fresh install or when upgrading to a new version), fetching data from PSN, and then starting the server:
# Pull the Trophies.gg Docker image
$ docker pull ghcr.io/lukecarr/trophies
# Setup an environment variable pointing to where your Trophies.gg database will persist
$ export DATABASE_PATH=/path/to/your/folder
# Perform migrations
$ docker run -it -v $DATABASE_PATH:/data ghcr.io/lukecarr/trophies migrate
# Obtain an NPSSO token (see README section) from PSN
$ export NPSSO=<your NPSSO token>
# Fetch data from PSN
$ docker run -it -e NPSSO=$NPSSO -v $DATABASE_PATH:/data ghcr.io/lukecarr/trophies fetch
# Obtain a RAWG API key (if you want game metadata, background images, etc.)
$ export RAWG_API_KEY=<your API key>
# Launch the server on port 3000 (-p 3000:3000) in detached mode (-d)
$ docker run -d -e NPSSO=$NPSSO -e RAWG_API_KEY=$RAWG_API_KEY -v $DATABASE_PATH:/data ghcr.io/lukecarr/trophiesYou can find a comprehensive list of Docker image tags here.
In the examples directory, you can find different scenarios for deploying Trophies.gg.
The trophies binary (the Docker image entrypoint) is actually a CLI application that can perform many different operations (including running the all-in-one web server).
The trophies serve subcommand starts the Trophies.gg server. This is a combined server that includes both the backend and web-based frontend.
This subcommand is the default Dockerfile command.
The trophies migrate subcommand performs SQL migrations. This command needs to be invoked after a fresh installation of Trophies.gg or an update that introduces new database requirements.
This trophies fetch subcommand loads games, trophy lists, and trophy completion data from PSN.
Trophies.gg uses environment variables to configure the application. Below, you can find details on the different environment variables that Trophies.gg looks for and what they are used to configure.
This is your PSN NPSSO token which is used to interact with the PSN API and fetch information on games, trophy lists, and trophy completion.
Your NPSSO token can be obtained by following these steps:
- Visit the PlayStation website and sign in with your PSN account.
- Cccess this page in the same browser session to obtain your NPSSO token.
The NPSSO token should return a response that looks like this:
{ "npsso": "<64 character token>" }Copy the token value (not including the quote characters) and use this as the value of the NPSSO environment variable.
The RAWG API is used by Trophies.gg to obtain accompanying game metadata, including background images, Metacritic scores, and genre information.
You can sign up for a free account using the link above and obtain an API key limited to 20K monthly requests.
Trophies.gg caches results from the RAWG API to reduce API consumption (and keep you within their free tier limits).
Once you've obtained an API key, include it as an environment variable and enjoy beautiful game art and extra metadata!
By default, Trophies.gg will make a request to GitHub's API on startup to check for new releases.
If you wish to disable this logic, please set the DISABLE_NEW_VERSION_CHECK variable to any value.
Thanks goes to these wonderful people ([emoji key][allcontributors-emoji):
Trophies.gg uses Semantic Versioning v2.0.0.
Trophies.gg is distributed under the Apache 2.0 license.