psnpp-gist is a companion userscript for PSNP+ that syncs your game lists to GitHub Gists, keeping them in sync across browsers and devices.
Important
PSNP+ must be installed first.
- Install Tampermonkey or Violentmonkey
- Click here to install the script
- Confirm the install prompt
Warning
GitHub Releases is the only official source. Each release includes a .sha256 file. Verify it matches before trusting the script:
sha256sum psnpp-gist-sync.user.js
cat psnpp-gist-sync.user.js.sha256You need a GitHub account. GitHub Gist is the only storage option for now.
GitHub -> Settings -> Developer settings -> Personal access tokens -> Tokens (classic) -> Generate new token -> Generate new token (classic). Enable only the gist scope. Copy it.
Create a new (preferably secret) Gist at gist.github.com. The ID is the long hash at the end of the URL, after your username.
Open PSNP+ settings. You should see the Gist Sync section at the bottom:
- Paste your token in the GitHub PAT field
- Paste the Gist ID in the Add Gist field and click the download button
- Check the lists you want to sync, then save
That's it!
Each list gets its own file in the Gist ({uuid}.json), plus a psnpp-manifest.json that maps IDs to names. You can add multiple Gists if you need to.
On the game lists page a cloud button appears next to the delete button:
| State | Meaning |
|---|---|
| Spinning | Sync in progress |
| Blue cloud | Up to date |
| Red circle | Error -- hover to see why |
Synced lists get a ☁ suffix in the dropdown:
Changes push automatically after you save. On page load, the script pulls the latest from your Gist. Switching back to the tab re-pulls if the Gist was updated elsewhere.
Sync activity is logged to the browser console under [psnpp-gist].
v0.2.0 changed the storage format. After updating, make sure to add your Gist back in settings. Your lists will still be there, the config needs a refresh.
Found a bug? Open an issue on GitHub! Including any [psnpp-gist] errors from the browser console will help me fix it faster.
Built on top of PSNP+ by huskydev. None of this would work without it!
MIT. See LICENSE.