ItemzFlow PS4

ItemzFlow
General
Author	LightningMods
Type	Utilities
Version	1.06
License	GPL-3.0
Last Updated	2024/06/27
Links
Download
Website
Source
Support Author

ItemzFlow is an open-source alternate menu for the PS4 with a beautiful interface. It offers additional functionality that is directly accessible for each game, such as a dumper, a possibility to access/activate patches and trainers, some repair tools (e.g., to avoid losing all of your fpkg content in case of PS4 data corruption), theme support, and more.

Usage

Settings

the ini file is either loaded by the app dir or from USB0 when the app is booted

Settings Layout

INI Key	Description
Dumper_option	0 = ALL 1 = BASE Game only 2 = Patch only
Sort_By	-1 is NA 0 = Alpha order by TID 1 = Alpha order by App Name
Sort_Cat	Sort category
cover_message	Shows cover message on app startup
MP3_Path	FS Path to a folder of MP3s or a single MP3 to play on loop
Dumper_Path	Dump path
TTF_Font	TTF Font the store will try to use (embedded font on fail)
Show_Buttons	Shows IF buttons on the screen
Enable_Theme	ONLY Active if you have a theme enabled
Image_path	background PNG image
Reflections	Enables cover reflections in IF
Home_Redirection	Enables the Home Menu Redirect
Daemon_on_start	Disables the Daemon from auto connecting with the app
Image_path	Background Image
Show_install_prog	Enables the Store PKG/APP install Progress
Fuse_IP	PC NFS Share in format nfs://IP/share_name

setting.ini example

[Settings]
Dumper_option=0 
Sort_By=-1
Sort_Cat=0 
cover_message=1 
MP3_Path=/mnt/usb0/music 
Dumper_Path=/mnt/usb0 
TTF_Font=/mnt/usb0/myfont.ttf
Show_Buttons=1 
Enable_Theme=1 
Image_path=/mnt/usb0/pic.png 
Reflections=1 
Home_Redirection=1 
Daemon_on_start=0 
Show_install_prog=1 
Fuse_IP=nfs://192.1.2.3/nfs_share

NFS Share format

The NFS formatted string can be entered in the app using the in-app keyboard or set in the settings.ini file

nfs://PC_IP/share_name

or if your share name is /

PC_IP

Itemzflow Log

• If the app crashes or mentions "a FATAL Signal" send this log to us via the discord below or via GH Issues /user/app/ITEM00001/logs/itemzflow_app.log

Daemon

The itemz daemon is installed when you open the app for the first time at /system/vsh/app/ITEM00002 it gets updated ONLY by Itemzflow

The daemon folder is ONLY for internal use by the Itemzflow devs it is hash checked by the loader to ensure the daemon is always up to date with the PKG

Dumper details

• Dumper log is at /user/app/ITEM00001/logs/if_dumper.log
• Dumper WILL ONLY dump to the first USB it finds (most likely USB0)
• Dumper will try to use the same Language as Itemzflow
• If the dumper gets stuck on a file make SURE both discs and ALL Languages are installed if available BEFORE Dumping
• If your dump has failed then provide us the log /user/app/ITEM00001/logs/if_dumper.log in our discord below

Languages

• The Itemzflow's Langs. repo is HERE
• The Itemzflow uses the PS4's System software Lang setting

Themes

• You can download custom themes released in the Itemzflow Themes Repo
• You can also make your own custom themes by following these instructions.

IMPORTANT the Theme files must HAVE the exact filename as listed below

Filename	Description
btn_o.png	O Button (67x68)
btn_x.png	X Button (67x68)
btn_tri.png	Triangle Button (67x68)
btn_sq.png	square Button (67x68)
btn_r1.png	R1 Button (309x152)
btn_l1.png	L1 Button (120x59)
btn_l2.png	L2 Button (120x105)
btn_options.png	Options Button (145x84)
btn_up.png	D-Pad Up Button (32x32)
btn_down.png	D-Pad Down Button (32x32)
btn_left.png	D-Pad Left Button (32x32)
btn_right.png	D-Pad Right Button (32x32)
font.ttf	Theme Font
background.png	Background Image
shader.bin	PS4 GLES Compiled Shader
theme.ini	Theme Info

Theme INI Config

INI Key	Description
Name	Theme Name
Author	Who Made it
Date	Date it was made on
Version	Theme Version Number
Image	1 if your Theme has a background image, 0 if not
Font	1 = Theme has font.ttf 0 = It doesnt
Shader	1 = Has Shader bin 0 = It doesnt

Example Theme config

[THEME]
Name=Example Theme
Author=Example Author
Date=10/16/2022
Version=1.00
Image=1
Font=1
Shader=0

App logs and their paths

Service	PS4 Path
Itemzflow main app	/user/app/ITEM00001/logs/itemzflow_app.log
Dumper	/user/app/ITEM00001/logs/if_dumper.log
Itemz Loader	/user/app/ITEM00001/logs/loader.log
Itemz Daemon	/data/itemzflow_daemon/daemon.log
libfuse	/data/itemzflow_daemon/libfuse.log

On USB (only on failure or crash)

Service	USB Path
Itemzflow main app	/mnt/usb<USB_NUMBER>/itemzflow/crash.log
Dumper	/mnt/usb<USB_NUMBER>/itemzflow/dumper.log
Itemz Loader	/mnt/usb<USB_NUMBER>/itemzflow/loader.log
Itemz Daemon	/mnt/usb<USB_NUMBER>/itemzflow/daemon.log

Game Patches

• Downloads from online database via the app or manual install via zip file
• Supported formats: yaml filename must be (TITLE_ID).yml, i.e CUSA00547.yml
• Startup patches only supports eboot.bin for now. PRs are very welcome to support games that use multple elf.
• YML per game filepath: /data/GoldHEN/patches/yml/(TITLE_ID).yml

Patch Syntax

Syntax:

{ "type": "", "addr": "", "value": "" }

Types:

• byte: 1 byte
• bytes16: 2 bytes
• bytes32: 4 bytes
• bytes64: 8 bytes
• bytes: array of bytes (no spaces)
• utf8: utf8 string
• utf16: utf16 string

Examples:

{ "type": "byte", "addr": "0x01271464", "value": "0x01" },
{ "type": "bytes", "addr": "0x00402d90", "value": "31c0c3" }

Media

New PS4 Itemzflow Game Manager Preview (MODDED WARFARE)

Screenshots

Changelog

v1.06

• Added (experimental) Fake Game support (load dumps from USB or local storage, supports NFS, requires external fake signing)
• Added Firmware info and Compatibility details to the retail game updates feature
• Added the option to have PKGs installed in the background through Itemzflow's PKG installer (File Browser Option)
• Itemzflow will now keep the last 3 logs (last 3 itemzflow launches)
• Added more info for certain error codes (i.e patch installer will tell you if you are blocking Sonys CDN etc)
• Improved stock itemzflow performance
• Fixed a memory leak that would cause issues if a lot of games were on the console
• Added a progress bar for downloading covers
• Fixed an issue causing Itemzflow to crash if you tried to download game covers with the API blocked (i.e DNS)
• Improved the itemz-daemon Fuse startup (wont stall trying to auto-connect to the last NFS share if unavail.)
• 1.05 HOTFIXs
  • Fixed an issue that would cause the app to crash when using/selecting trainers
  • Fixed an issue causing the "Upload itemzflow logs" not to appear in the settings
  • Added a prompt to explain the issue when uploading the logs manually via settings (not from crashing)
  • Disabled all C++ exceptions (allows my custom crash handler to work on FW 5.50+)

v1.05

• Fuse (NFS) support for 11.00
• Replaced the Game Saves option with the option to download retail game updates
• Fixed dumping patches from external storage
• The Dumper will ask if you want to generate the GP4 at the end of the dump
• The Dump All option will now try to dump any loaded DLCs (to dump DLCs not yet loaded use the Dump DLC option)
• The Dumper should now cancel dumping if the app is resumed twice (resumed again while dumping) instead of restarting
• The Dumper will now display the time it took to dump a game in the last message
• Added the ability to upload Itemzflows logs via triangle in the settings menu (internet required)
• Upon crash you will now have to option to Itemzflows logs for review (internet required)
• Itemzflow will now pre-load app icons after launching
• Game playtime has been moved to its own itemzflow thread (should increase perf)
• the Itemz-daemon will now record playtime for both mini (homebrew) and big apps (games) open
• Added more files to the GP4 blacklist to improve compatibility with Sonys PKG tools
• Fixed the favorites category
• Improved media app detection
• Improved code quality

v1.04

• Fixed dumping DLCs and AC w/o data
• Added an Install all PKGs option for folders with more than 1 PKG
• Installing a PKG will no longer boot you back to settings
• Carried over some improvements from the PS5 version of IF
• Replaced reg. vectors for ThreadSafeVectors
• Added the Chinese lang files
• Fixed a bug that would cause the Utility thread to deadlock
• Fixed a Bug that caused the daemon not to give a backtrace on 9.00

v1.03

• Added a screen saver (with alternating text every 5 mins) when idling for 15 mins or if the controller is turned off
• Itemzflow now accepts and backups game saves in Apollo's Decrypted save format for portability
• Added 3 dpad speeds (to all directions) depending on how long you have held the button
• Screen saver shows IP address, FW, temp, itemzflow version and current theme info
• Install a PKG or dump a game directly to your PC using /hostapp when connected to an NFS share
• Added the Remote app virtual app to itemzflow's app menu when connected to an NFS Share
• Added specific vapp menus instead of showing the traditional game menu
• Added an option to stop music, hovering over background music in settings press square to stop and remove the music
• Added Fuse NFS PC IP to the settings menu
• NFS setting accepts other share names using the following format nfs://PC_IP/share_name
• Added libfuse (with patches) and a modified version of fuse-nfs by @sahlberg to the itemz-daemon (big thanks to @SocraticBliss)
• Added Fuse related RPC commands
• [HOT FIX] fixed the Store API by including the prx in the pkg
• Improved game dumper progress
• Removed the Reflections setting (can still be enabled manually and will continue to work if previously enabled)
• Daemon now saves every NFS IP after successful connection for auto connection
• Fixed move to and restore from USB in the game menus
• Improved the PS button redirect
• @illusion0001 moved game patches from using tinyjson to pugixml
• Improved Itemz-daemons RPC functions and Itemzflow's IPC functions
• Added vapp launch events
• Fuse currently only supports 9.00 and 5.05 goldhen or unreleased mira update, all fws
• Fixed a few bugs

v1.02

• First Release.

Credits

• Flatz
• SocraticBliss
• TheoryWrong
• Znullptr
• Xerpi
• TOXXIC407
• Masterzorag
• Psxdev/BigBoss
• Specter
• SocraticBliss
• Sleirsgoevy
• AlAzif
• BigBoss
• bucanero (Game Saves)
• illusion (Game Patches/Trainers)
• Pharaoh2k (Apps/Games/DLCs Databases Recovery)

External links

• PKG-Zone- https://pkg-zone.com/details/ITEM00001
• Github - https://github.com/LightningMods/Itemzflow