input json, output magic!
JSON Diff JSON Validator

FPKGi Configuration Editor

Edit and customize your FPKGi config.json file below

Copy
Download

Content URLs

Configure remote JSON sources for games, apps, updates, and DLC content

Download Settings

Set custom download paths and background download preferences

Visual Customization

Customize backgrounds, music, and visual appearance settings

FPKGi Config.json Configuration Guide

FPKGi (Fake Package Installer) is a powerful homebrew application for PlayStation 4 and PlayStation 5 consoles that enables users to manage and install custom packages. The config.json file serves as the core configuration center for FPKGi, allowing users to customize various aspects of the application's behavior, appearance, and functionality.

What is FPKGi Config.json?

The config.json file is automatically generated when you first launch FPKGi and is located in the /user/data/FPKGi/ directory on your console. This configuration file contains all the essential settings that control how FPKGi operates, from content source URLs to visual customizations and download preferences.

Configuration File Structure

The FPKGi configuration file follows a structured JSON format with several main sections:

Basic Configuration Layout

{
  "CONTENT_URLS": {
    "PS1": null,
    "PS2": null,
    "PSP": null,
    "games": null,
    "apps": null,
    "updates": null,
    "DLC": null,
    "demos": null,
    "homebrew": null,
    "emulators": null,
    "themes": null
  },
  "downloadPath": "/user/data/FPKGi/Downloads/",
  "background_uri": null,
  "music_enabled": true,
  "sort_order": "ascending",
  "filter_type": "all"
}

Content URLs Configuration

The CONTENT_URLS section allows you to specify remote JSON files containing your content libraries. This enables FPKGi to fetch content information from web servers rather than relying solely on local files.

Supported Content Categories

  • PS1: PlayStation 1 games and content
  • PS2: PlayStation 2 games and content
  • PSP: PlayStation Portable games and content
  • games: PlayStation 4/5 games
  • apps: Applications and utilities
  • updates: Game updates and patches
  • DLC: Downloadable content and expansions
  • demos: Game demonstrations and trials
  • homebrew: Community-developed applications
  • emulators: Console emulation software
  • themes: Console themes and visual modifications

Web Content Configuration Example

{
  "CONTENT_URLS": {
    "games": "https://example.com/ps4-games.json",
    "apps": "https://example.com/ps4-apps.json",
    "updates": "https://example.com/updates.json",
    "DLC": "https://example.com/dlc-content.json"
  }
}

When a category is set to null, FPKGi will attempt to load content from the corresponding local JSON file in the /user/data/FPKGi/ContentJSONs/ directory.

Download Management Settings

Download Path Configuration

The downloadPath parameter specifies where FPKGi will save downloaded packages before installation:

{
  "downloadPath": "/user/data/FPKGi/Downloads/"
}

Alternative Download Paths

  • USB Storage: "/mnt/usb0/"
  • Custom Directory: "/user/data/custom-folder/"
  • Default Reset: Set to null to restore default path

Visual Customization Options

Background Image Configuration

FPKGi supports custom background images through the background_uri setting:

{
  "background_uri": "https://example.com/background.png"
}

Supported Image Formats

  • PNG (.png)
  • JPEG (.jpg, .jpeg)
  • BMP (.bmp)

Local Background Example

{
  "background_uri": "/user/data/FPKGi/Backgrounds/custom.png"
}

Audio Settings

Control the original PKGi background music with the music_enabled option:

{
  "music_enabled": true
}

Set to false to disable background music.

Content Sorting and Filtering

Sort Order Configuration

{
  "sort_order": "ascending"
}

Available options:

  • "ascending": A-Z sorting
  • "descending": Z-A sorting

Content Filtering

{
  "filter_type": "all"
}

Filter options include:

  • "all": Show all content
  • "games": Games only
  • "apps": Applications only
  • "updates": Updates only

Advanced Configuration Options

Network Settings

{
  "connection_timeout": 30,
  "retry_attempts": 3,
  "enable_background_downloads": true
}

Security Options

{
  "verify_signatures": true,
  "allow_unknown_sources": false
}

Complete Configuration Example

Here's a comprehensive example of a fully configured config.json file:

{
  "CONTENT_URLS": {
    "PS1": null,
    "PS2": null,
    "PSP": "https://content.example.com/psp-games.json",
    "games": "https://content.example.com/ps4-games.json",
    "apps": "https://content.example.com/ps4-apps.json",
    "updates": "https://content.example.com/updates.json",
    "DLC": "https://content.example.com/dlc.json",
    "demos": null,
    "homebrew": "https://content.example.com/homebrew.json",
    "emulators": null,
    "themes": "https://content.example.com/themes.json"
  },
  "downloadPath": "/mnt/usb0/FPKGi-Downloads/",
  "background_uri": "https://example.com/custom-bg.png",
  "music_enabled": true,
  "sort_order": "ascending",
  "filter_type": "all",
  "connection_timeout": 45,
  "retry_attempts": 5,
  "enable_background_downloads": true,
  "verify_signatures": true,
  "allow_unknown_sources": false
}

Configuration Best Practices

1. Content URL Management

  • Always use HTTPS for content URLs when possible
  • Ensure your content JSON files are properly formatted
  • Keep backup copies of your content lists
  • Regularly verify that your content URLs are accessible

2. Storage Considerations

  • Choose download paths with sufficient storage space
  • Consider using external USB storage for large downloads
  • Monitor available disk space regularly

3. Performance Optimization

  • Adjust connection timeout based on your network speed
  • Use local content files for frequently accessed categories
  • Enable background downloads for better user experience

4. Security Recommendations

  • Enable signature verification when available
  • Only use trusted content sources
  • Regularly review and update your content URLs
  • Backup your configuration file before making changes

Troubleshooting Common Issues

Configuration Not Loading

  • Verify JSON syntax is correct
  • Check file permissions in the FPKGi directory
  • Ensure the config.json file is in the correct location

Content Not Appearing

  • Validate content URL accessibility
  • Check JSON format of remote content files
  • Verify network connectivity

Download Path Issues

  • Ensure specified path exists and is writable
  • Check available storage space
  • Verify path permissions

Content JSON Format Reference

When configuring remote content URLs, ensure your JSON files follow this structure:

{
  "DATA": {
    "https://example.com/content.pkg": {
      "region": "USA",
      "name": "Content Title",
      "version": "1.00",
      "release": "11-15-2024",
      "size": 1000000000,
      "min_fw": null,
      "cover_url": "https://example.com/cover.png"
    }
  }
}

Required Fields

  • URL: Direct link to the package file
  • name: Display name for the content
  • size: File size in bytes (must be accurate)

Optional Fields

  • region: "USA", "JAP", "EUR", "ASIA", or null
  • version: Content version number
  • release: Release date
  • min_fw: Minimum firmware requirement
  • cover_url: Cover image URL

Conclusion

The FPKGi config.json file provides extensive customization options for tailoring your package management experience. By understanding and properly configuring these settings, you can optimize FPKGi's performance, appearance, and functionality to suit your specific needs and preferences.

Remember to always backup your configuration before making significant changes, and ensure all content sources comply with your local laws and console usage policies.