# Avatar Changer

Thank you for downloading **Avatar Changer**!  
This tool lets you **view, manage, and change** your PlayStation Network avatar. It supports your **owned avatars** and a curated catalog of **free/global avatars**.

---

## ⚠️ IMPORTANT: READ BEFORE USING

- **WINDOWS DEFENDER / ANTIVIRUS**  
  Security tools may flag unsigned desktop utilities as suspicious (**false positive**).  
  If you trust this app and downloaded it from the official page, add the app folder to your AV/Defender **exclusion list** to avoid blocks or deletions.

- **PSN TERMS**  
  You are responsible for any action on your account. Use the tool in compliance with PSN **Terms of Service** and **Community Code of Conduct**.

- **USE AT YOUR OWN RISK**  
  The author is not responsible for account actions or consequences arising from the use of this tool.

- **NPSSO SECURITY**  
  Your NPSSO token is **sensitive** (like a password). It is **not stored** after closing the app.

---

## ✨ MAIN FEATURES

- Modern **dark UI** with immediate feedback.
- **Profile preview**: shows your Online ID and current avatar.
- **Set Default Avatar** (official PSN default).
- **Owned Avatars Gallery**
  - Download/Update your avatar collection from PSN.
  - Smart sync: downloads new items, removes obsolete ones.
  - Local preview grid with smooth thumbnails.
- **Free Avatar Gallery**
  - Browse a catalog of ~**383** free/global avatars.
- **Ownership check** when you try to set a non-free avatar (from your local gallery).
- Built-in **caching** for free avatars & thumbnails during the session (fast reopen).
- Robust networking (timeouts/retries) and responsive UI (background threads).

---

## 🚀 QUICK START

### 1) Get your NPSSO token
1. Log into your PSN account in a web browser.  
2. Visit: `https://ca.account.sony.com/api/v1/ssocookie`  
3. You’ll see: `{"npsso":"YOUR_64_CHARACTER_CODE_HERE"}`  
4. Copy the **64-character** value (NPSSO).

### 2) Log in
1. Launch `Avatar Changer.exe`.  
2. Paste NPSSO into the **Login (NPSSO)** field and click **Login**.  
3. On success, you’ll see your **Online ID** and **current avatar**.

### 3) Use the galleries
- **Owned avatars**
  - Click **🔄 Download/Update Gallery** to sync.
  - Click on an avatar to set it (the tool verifies ownership before applying).
- **Free/global avatars**
  - Click **Browse Free Avatars**.
  - The first open shows a spinner and loads thumbnails with a **progress counter**.
- **Set Default Avatar**
  - Click **Set Default Avatar** to revert to the Default PSN avatar.

> After applying an avatar, the app briefly waits and refreshes your profile preview.

---

## 📂 FILES & STORAGE

- **Working data (one-file build)**  
  While running, the app uses a working directory under:  
  `%LocalAppData%\amethxst.dev\Avatar_Changer\`

- **Local avatars (per account)**  
  Synced items are kept under:  
  `%LocalAppData%\amethxst.dev\Avatar_Changer\UserAvatars\<YourOnlineID>\*.png`

> You can remove these folders safely; they will be recreated when necessary.

---

## 🔒 PRIVACY

- Your NPSSO token is **never saved** to disk.  
- No personal data is collected or transmitted.  
- On first successful login, the app sends a tiny anonymous **usage ping** to the developer’s site to keep a usage counter. **No NPSSO / PSN ID / personal data** is included.

---

## ⚙️ TIPS & TROUBLESHOOTING

- **Access token error**: ensure the NPSSO is exactly **64 characters** and still valid (re-generate if needed).  
- **Spinner shows but nothing loads**: check your Internet connection and firewall/AV exclusions.  
- **“Not responding” during first open of Free Gallery**: the app preloads image plugins; wait a moment—the UI remains responsive thereafter.  
- **Avatar doesn’t change immediately on PSN app/console**: allow a short delay; the app auto-refreshes your profile preview.

---

## 📜 DISCLAIMER

No formal support is provided. Use at your own risk.  
The author is not affiliated with Sony Interactive Entertainment.