# PlayStation Gallery

Thank you for downloading **PlayStation Gallery**! This application allows you to easily view, download, and share your game captures (screenshots and video clips) directly from your PC.

---

## ⚠️ IMPORTANT: PLEASE READ BEFORE USING!

- **WINDOWS DEFENDER / ANTIVIRUS**: Your antivirus software, especially Windows Defender, may flag this application as a potential threat (false positive). This can happen with tools that interact with online services or are not digitally signed by a large publisher. If you trust this application and have downloaded it from a reliable source, consider adding the application (`galleria.exe`) to your antivirus exclusion list to prevent it from being blocked.

- **USE AT YOUR OWN RISK**: The developer is not responsible for any issues or consequences arising from the use of this application.
- **NPSSO TOKEN SECURITY**: Treat your NPSSO token as sensitive information (like a password). It is **NOT stored** by the application and is required every time you launch it.
- **PSN API LIMITS**: The application is designed for normal usage. Avoid excessive reloading or repeated actions to prevent temporary API blocks from Sony.

---

## ✨ MAIN FEATURES

• Modern, dark-themed user interface.
• **Automatic Grouping**: Your media is automatically organized into folders by game.
• **Game Search**: Quickly find a specific game's media folder.
• **Integrated Media Viewer**:
    - **Image Viewer**: View full-resolution screenshots with zoom and pan.
    - **Video Player**: Play your video clips with standard controls (play/pause, timeline slider).
• **One-Click Downloads**: Easily download your screenshots and video clips to your computer.
• **Direct Sharing**: Share your media directly with your PSN friends or in your groups without leaving the application. The sharing dialog includes:
    - Recent friends and groups lists (MAX 20).
    - A "Load More" button for groups to see more than the initial 10.
    - A user search function to find any PSN user.
• **Media Filters**: Filter the view within a game folder to show "All", "Images", or "Videos".

---

## 🚀 QUICK START GUIDE

### Step 1: Obtain Your NPSSO Token

- Open your web browser and log in at: https://my.playstation.com
- In a new tab of the **same browser**, navigate to: `https://ca.account.sony.com/api/v1/ssocookie`
- You will see a response like:
  `{"npsso":"YOUR_64_CHARACTER_CODE_HERE"}`
- Carefully copy **only the 64-character NPSSO token**.

### Step 2: Use PlayStation Gallery

- Launch the application (`galleria.exe`).
- Paste your NPSSO token into the "Enter your NPSSO Token" field.
- Click **Login**.

### Step 3: Browse and Manage Your Media

- Once logged in, the application will load and display all your games that have associated media.
- Use the **Search game...** bar at the top to filter the game list.
- **Click on a game folder** to view all the screenshots and video clips for that game.
- Inside a game folder:
    - Use the **All / Images / Videos** buttons at the top right to filter the content.
    - Hover over a media card to see its title.
    - Click **View** (for images) or **▶ Play** (for videos) to open the media in a full-size viewer.
    - Click the **Download (↓)** button to save the media to your PC.
    - Click the **Share (→)** button to open the PSN sharing dialog.

### Step 4: Share Your Media

- In the sharing dialog:
    - Select one or more friends or groups from the lists.
    - The groups list has a **Load More** button to fetch more of your recent groups.
    - Use the search bar on the left to find a specific PSN user by their Online ID if they are not in your recent lists.
    - Click **Share** to send the media to all selected recipients.

---

## 🔒 DATA & PRIVACY

- Your NPSSO token is **never saved** or stored on your computer. You must enter it each time you run the application.
- The application does not store any personal information.
- At login, a simple, anonymous **ping request** is sent to the developer's website to count the number of active users. This is the **only external data sent** by the application and does not include your NPSSO, PSN ID, or any other personal data.
- Always obtain your NPSSO token directly from the official Sony URL:
  `https://ca.account.sony.com/api/v1/ssocookie`

---

**No formal support provided.**
Use this application at your own risk. The author is not responsible for any actions taken or their consequences.