mirror of
https://github.com/ApfelTeeSaft/Itemzflow.git
synced 2026-08-26 19:23:39 +00:00
2f5a732d3bc0dd286c569aa940e0489ebf70b7e0
ItemzFlow
Lead Developer (besides the obv)
Third-Party Libraries
- FTPS4
- dr_mp3
- liborbisAudio
- Orbis SQLite
- OrbisDev SDK
- OOSDK for PRXs
- JSMN (MIT)
- INI Parser (Apache License 2.0)
- RSA Verify (ARMmbed) (Apache License 2.0)
- OpenSSL/MD5 (Apache License 2.0)
- BusyBox (GPLv2)
- LibPNG
- log.c
- Game Dumper
- libjbc
- yaml-cpp
- taglib
- Libz
Refs
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 |
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
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 settings file is ONLY for internal use by the Store devs
however it also has a ini at /system/vsh/app/ITEM00002/daemon.ini with the following ini values
[Daemon]
version=0x1001// Daemon version for Store, Official version is always > 0x1000
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.login 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 | /user/app/ITEM00001/logs/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 |
Official Discord server
Invite: https://discord.gg/GvzDdx9GTc
Game Patches
- Downloads from GoldHEN online database via the app or manual install via zip file
- Supported formats:
jsonfilename must be(TITLE_ID).json, i.eCUSA00547.json - json per game filepath:
/data/GoldHEN/patches/json/(TITLE_ID).json
Patch Syntax
Syntax:
{ "type": "", "addr": "", "value": "" }
Patch types
type |
Info | Value (example) |
|---|---|---|
byte |
Hex, 1 byte | "0x00" |
bytes16 |
Hex, 2 bytes | "0x0000" |
bytes32 |
Hex, 4 bytes | "0x00000000" |
bytes64 |
Hex, 8 bytes | "0x0000000000000000" |
bytes |
Hex, any size (no spaces) | "####" |
float32 |
Float, single | "1.0" |
float64 |
Float, double | "1.0" |
utf8 |
String, UTF-8* | "string" |
utf16 |
String, UTF-16* | "string" |
- Note: Strings are automatically null terminated.
Example patch
{
"patch": [
{
"title": "Example Game Title",
"app_titleid": [
"EXAMPLE01",
"EXAMPLE02"
],
"app_ver": "00.34",
"app_elf": "eboot.bin",
"patch_ver": "1.0",
"name": "Example Name",
"author": "Example Author",
"note": "Example Note",
"patch_list": [
{ "comment": "This is a code comment, improves code readability." },
{ "type": "bytes", "addr": "0x00000000", "value": "0102030405060708", "comment": "Code comment at end of line is also supported." },
{ "type": "utf8", "addr": "0x00000000", "value": "Hello World" }
]
}
]
}
Donations
We accept the following methods
- Ko-fi
- BTC: 3MEuZAaA7gfKxh9ai4UwYgHZr5DVWfR6Lw
if you donate and dont want to the message anymore created this folder after donating ``
Credits
- Flatz
- SocraticBliss
- TheoryWrong
- Znullptr
- Xerpi
- TOXXIC407
- Masterzorag
- Psxdev/BigBoss
- Specter
- Sleirsgoevy
- AlAzif
- BigBoss
- bucanero (Game Saves)
- illusion (Game Patches/Trainers)
Languages
C
58.2%
C++
41%
Makefile
0.7%