https://github.com/ps2homebrew/opl-launcher
https://github.com/ps2homebrew/opl-launcher
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/ps2homebrew/opl-launcher
- Owner: ps2homebrew
- Created: 2021-07-06T12:19:32.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-12-10T11:32:16.000Z (over 2 years ago)
- Last Synced: 2025-04-17T01:35:26.199Z (about 1 month ago)
- Language: C
- Size: 28.3 KB
- Stars: 23
- Watchers: 4
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# OPL-Launcher
[](https://github.com/ps2homebrew/OPL-Launcher/actions?query=workflow%3ACI)
OPL-Launcher reads `hdd0:/__common/OPL/conf_hdd.cfg` to launch `$OPL/OPNPS2LD.ELF`.
You can inject OPL-Launcher into APA using, i.e. [HDL Dump](https://github.com/ps2homebrew/hdl-dump):
```cmd
hdl_dump.exe modify_header hdd:
```
To do so, You must also prepare few files for the injection process:
1. Signed executable which You can make by [this application](https://www.psx-place.com/resources/kelftool-fmcb-compatible-fork.1104/)
```cmd
kelftool encrypt mbr OPL-Launcher.elf boot.kelf
```
2. `system.cnf` file that contains:
```ini
BOOT2 = PATINFO
VER = 1.00
VMODE = NTSC
HDDUNITPOWER = NICHDD
```
3. Standard PS2 game icon. Just take one from game save and rename it to `list.ico`.
4. `icon.sys` file, which is not binary like in Memory Card case but fully text one. Example file, `title0` replaced by game name, `title1` replaced by Game ID and region (information from ):
```ini
PS2X
title0=ICO
title1=SCUS-97113 (NTSC-U)
bgcola=0
bgcol0=0,0,0
bgcol1=0,0,0
bgcol2=0,0,0
bgcol3=0,0,0
lightdir0=1.0,-1.0,1.0
lightdir1=-1.0,1.0,-1.0
lightdir2=0.0,0.0,0.0
lightcolamb=64,64,64
lightcol0=64,64,64
lightcol1=16,16,16
lightcol2=0,0,0
uninstallmes0=
uninstallmes1=
uninstallmes2=
```
5. You can use a combination of 2 partitions: `` and `<__. Partition with PS2 game>`. Partition names should only differ in the first two characters.
This will add compatibility with BB Navigator / PSX DESR XMB users. `` will contain game resources, `<__. Partition with PS2 game>` is the game in HDL format.
Detailed guide for installing on PSX DESR / BB Navigator
1. Install the game with [HDL Dump](https://github.com/ps2homebrew/hdl-dump) by using the switch `-hide`. If you already installed the game without that switch, rename the partition and change the first three characters to `__.`.
2. Create PFS partition ``. The name should match the installed game name in the previous step, except that the first three characters should be `PP.`.
3. Prepare signed executable (for example, by [this app](https://www.psx-place.com/resources/kelftool-fmcb-compatible-fork.1104/))
```cmd
kelftool encrypt mbr OPL-Launcher.elf boot.kelf
```
4. Put signed executable into partition from step 2. For example, you can place it in `/EXECUTE.KELF`
5. Create text file `system.cnf`, BOOT2 should be the same path as in step 4, only replace `` with `pfs:`:
```ini
BOOT2 = pfs:/EXECUTE.KELF
VER = 1.00
VMODE = NTSC
HDDUNITPOWER = NICHDD
```
6. `list.ico` and `icon.sys` are the same as in the first part of this Readme. These files are not used in BB Navigator / PSX DESR XMB, but you can keep them if you plan to use HDD OSD.
7. You can now inject all files into PP. with that command:
```cmd
hdl_dump.exe modify_header hdd:
```
8. Create folder `res` in ``. This folder will contain all resources.
9. Create inside `res` folder text file `info.sys`. Example file, `title` replaced by game name, `title_id` replaced by Game ID and region (information from )
```ini
title = ICO
title_id = SCUS-97113 (NTSC-U)
title_sub_id = 0
release_date =
developer_id =
publisher_id =
note =
content_web =
image_topviewflag = 0
image_type = 0
image_count = 1
image_viewsec = 600
copyright_viewflag = 0
copyright_imgcount = 0
genre =
parental_lock = 1
effective_date = 0
expire_date = 0
area = J
violence_flag = 0
content_type = 255
content_subtype = 0
```
10. Place `jkt_001.png` and `jkt_002.png` in `res` folder. These two pictures will be used as mini-thumbnails for the game. It can be the same picture as used in OPL art. `jkt_001.png` used in BB Navigator, `jkt_002.png` used in PSX XMB.
## Credits
Modified from miniOPL/diskload, credit to [sp193](https://github.com/sp193) & [l_oliveira](https://github.com/7l-oliveira)