Toggle search
Toggle menu
12.1K
15.1K
1.2K
216.7K
GameBrew
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

POP-FE PSP: Difference between revisions

From GameBrew
More actions
← Older edit
No edit summary
1.26
 
(35 intermediate revisions by 2 users not shown)
Line 4: Line 4:
|description=Python script to automate the process of fetching boxart and installing PS1 games (onto your PSP/VITA/PS2/PS3).
|description=Python script to automate the process of fetching boxart and installing PS1 games (onto your PSP/VITA/PS2/PS3).
|author=sahlberg
|author=sahlberg
|lastupdated=2023/08/02
|lastupdated=2025/12/13
|type=PC Utilities
|type=File Operation
|version=1.0.14
|version=1.26
|license=LGPLv2.1
|license=LGPL-2.1
|download=https://dlhb.gamebrew.org/psphomebrew/popfepsp.7z
|download=https://dlhb.gamebrew.org/psphomebrew/popfepsp.7z
|website=https://github.com/sahlberg/pop-fe
|website=https://github.com/sahlberg/pop-fe/blob/master/README
|source=https://github.com/sahlberg/pop-fe
|source=https://github.com/sahlberg/pop-fe
|discussion=
}}
}}
{{#seo:
{{#seo:
Line 19: Line 18:
|image_alt=POP-FE
|image_alt=POP-FE
}}
}}
POP-FE is a convenient tool designed for automating the conversion of PSX disk images and their installation on various platforms, such as PSP/VITA, PSIO, PS2, PS3, Retroarch, and PS Classic.
POP-FE is a tool designed for automating the process converting PSX disk images and install them on various platforms, including:
* PSP/VITA.
* PSIO.
* PS2.
* PS3.
* Retroarch.
* PS Classic.
 
For Linux and Windows.


==Features==
==Features==
* It automatically detects the disc ID and game title from the disc image.
* Automatically detects the disc ID and game title from the disc image.
* It automatically downloads PSX cover image and gameplay images.
* Automatically downloads PSX cover image and gameplay images.
* It handles multi-disc games, with up to 5 discs supported.
* It handles multi-disc games, with up to 5 discs supported.
* It automatically disables libcrypt.
* Automatically disables libcrypt.
* It automatically converts any CDDA (Compact Disc Digital Audio) tracks into ATRAC3 format and injects them into the EBOOT (Executable Boot), ensuring beautiful music for those games when played on PS3 and PSP (PlayStation Portable).
* Automatically converts any CDDA (Compact Disc Digital Audio) tracks into ATRAC3 format and injects them into the EBOOT.
* Aside from PS3 packages, it can also convert games for use on PSP/VITA/PS2/PSIO.
* Aside from PS3 packages, it can also convert games for use on PSP/VITA/PS2/PSIO.


==Usage==
==Changelog==
For Linux and windows.<br>
'''v1.26'''
Connect PSP to your Linux/Windows box via USB, then run:
* Add a config file to remember settings/directories between runs.
===PSP===
* Fix broken watermarks in pop-fe-psp.
<pre>
* PS3: fix for running NTSC games on a PAL console could be using wrong timings.
$ ./pop-fe.py --psp-dir=auto /psx/Grandia1of2.cue /psx/Grandia2of2.cue
* And a lot of more assets in the database.
</pre>
'''v1.25'''
===PS3===
* Lots of more assets.
<pre>
* Also adding tooltips to the UI.
$ ./pop-fe.py --ps3-pkg=Grandia.pkg /psx/Grandia1of2.ccd /psx/Grandia2of2.ccd
'''v1.24'''
</pre>
* Windows does not have wget by default so switch to using requests.get instead.
 
'''v1.23'''
===Formats===
* CHDMAN does not seem to work well right now so disable it for now.
<pre>
* The only true way to store disk images is in redump cue/bin format anyway.
.cue  : CUE file. The preferred option. The actual image file is extracted
'''v1.22'''
        from the content of the cue file. If the file-name found inside the
* The big new feature in this release is that we can now generate &quot;Software manual&quot; on the PS3.
        cue is a relative path it is assumed that the bin/img file is stored
* All NTSC-U games should have high quality scanned manuals.
        in the same directory as the cue file.
* Support for PAL or NTSC-J manuals is spotty. If you find links to good high quality scans of PAL/NTSC manual(2) please open an issue and provide the link and I can add it to the database.
.ccd  : CCD file. Will be converted to a temporary CUE file before it is used.
'''v1.21'''
.bin  : BIN/IMG files. In this case a temporary .cue file will be created
* Many updates to assets.
.img    in the local directory and used for the conversion. This cue file
* Main update is that the UI for pop-fe-psp and pop-fe-ps3 now has boxes to allow you to tweak the scaling and placement of the PIC0 logotype so that the games will look extra good.
        will assume that the bin/img file is just one single track of type
* Now, it is a LOT of work to maintain and populate the ~12.000 different disc entries in the database so I just can not do it all by myself.
        MODE2/2352
* I have added links to ~11.000 disks for the PIC0 image but adding the scaling and placement tweaks is just too much.
.zip  : ZIP file. The ZIP file will be extracted into the local directory
* If you find a game where doing some tweaks in the UI amke the placement and look of the game much better than the default, please open an issue on github with the game/disc id and the valies for scaling and x/y offsets and I will update the database so the next user that tries to convert the game will get a better experience than you had.
        and if a .cue file is found it will be used.
'''v1.20'''
.*     : Various memory card image formats.
* Fix SND0 generation on PSP so it plays at the correct speed and pitch.
        Memory cards are detected by file size so the extensions does not matter.
* Add an option to use the ICON as PIC1 background.
 
* Add options for PSP to tweak the placement and scaling of the PIC0 logo.
The utility supports building and installing the games on various different target platforms.
'''v1.19'''
</pre>
* Updated some assets, fixes a bug with the swap-disk option for PS3.
===Commandline===
* and added a new tool, layout.py (linux only) that helps to see how pic0/pic1 composition will look like on PS3 XMB and also PSP XMB.
<pre>
* This allows easier tweaking of 'pic0-scaling' (to change the scaling of pic0) and 'pic0-offset' (to change the positioning of pic0) than building eboot/pkg and installing on devices.
Command line arguments are:
* pic0-scaling/-offset will be used to manually curate the placement of pic0 so that the games look even better than when using the default positioning, which sometimes cause pic0 to cover imporant details in the pic1 background image.
-v                    : Verbose. Print additional information about what
'''v1.18'''
        operations are performed during the game installation.
* New version. Just some more assets but also an updated version of pytubefix to make youtube downloads of audio work again.
--title                : Force the title to use for this game.
'''v1.17'''
        By default pop-fe will automatically discover the
*Add snd0 for legend of dragoon.
game title from the image file provided. This argument
'''v1.16'''
can be used to override the title if the autodetection
* Windows filesystems are case insensitive so they treat .cue and .CUE as the same extension.
is wrong or fails.
* Fix extension detection in pop-fe to handle uppercase extensions.
--game_id              : Force the game id. By default pop-fe will extract
'''v1.15'''
        the SYSTEM.CNF file off the game iso and use it to
*Fix bug when processing a game by CCD.
detect the game-id. This argument can be used to
'''v1.14'''
override the id.
* Support older POPS versions on PSP
For multidisc games this supports a comma-separated
* This involves not generating a PSTITLEIMG section for single disc games.
list of ids.
'''v1.13'''
This argument does not affect libcrypt. Libcrypt
*This adds support for singledisc games on old versions of POPS on PSP.
handling will always use the id from the cue/bin.
'''v1.12'''
--cover                : Image to use as the game icon. If not specified pop-fe
*Switch to a different library for youtube audio.
        will automatically fetch one from the internet.
'''v1.11'''
--pic0                : Image to use as the PIC0/Screenshot. If not specified
*Update with more assets and features.
        pop-fe will automatically fetch one from the internet.
'''v1.10'''
--pic1                : Image to use as the PIC1/Screenshot. If not specified
* Due to heroic work and contributions by the folks at psx-place and gbatemp.net we now have a LOT of new emulator configuration overrides for PSP and PS3 making a LOT of problematic games playable.
        pop-fe will automatically fetch one from the internet.
* Even AlienResurrection now works perfectly !!!
--manual              : Specify a http link, zip-file or a directory containing
'''v1.8'''
                        scans of the manual. This is only supported for
*This should greatly speed up conversion of games containing a large SND0 or Manual.
PSP at the moment. See Manual section below.
'''v1.7'''
--resolution       : By default resolution is set to '2' (640x512)
* This version contains A LOT of config updates that fixes close to 300 games that has never worked, or worked with glitches on PSP/VITA.
        for PAL games. I.e. games with a GameId that starts
* The fixes are applied automatically when converting the game into a PSP EBOOT.
with SCES or SLES.
'''v1.6'''
And it is set to '1' (640x480) for all other games,
*Fix for pop-fe-ps3.exe after the build changed the file layout and broke things.
which are assumed to all be NTSC.
'''v1.5'''
This argument can be used to force the resolution
*fix pop-fe-psp on windows.
to a specific value.
'''v1.3'''
        See https://www.psdevwiki.com/ps3/PARAM.SFO#RESOLUTION
*This update adds a number of external configs (that were missing due to a workflow bug) for building games for PS3 PKSs and solves issues with many games.
for a list of possible values.
'''v1.2'''
--whole-disk          : For PS3 Packages pop-fe will default to only encode
* We already use the config to make PAL games forced into NTSC run at the correct speed for pop-fe.py.
        the data track in the pkg disc image and not the raw
* Now do the same for pop-fe-ps3
CD-DA tracks. The CD-DA tracks are converted to
'''v1.1'''
ATRAC3 format which is much much smaller which are
*Fix for incorrect leadout for the disc image which caused some games such as Fear Effect NTSC-U to hang on the PS1 boot screen.
then injected into the package.
'''v1.0.15'''
This makes packaged for games with CD-DA music much
* Don't crash just because an image we got was corrupted/unparseable. Just ignore the image instead.
smaller in size. Use this argument if you still want
* Also update BloodyRoar2 to use a better/not-corrupted PIC0
the raw audio tracks to also be stored in the disc
image. (This is only useful if at a later time you
want to convert the EBOOT.PBP file back into a .BIN
file)
--watermark            : Add a watermark consisting of disk-id and game-title
        to PIC0 for PSP and PSC games.
--list-themes          : This lists all the available themes
--theme <theme>        : Use ICON0/PIC0/PIC1/SND0 from the theme if available
--psio-dir <path>      : This specifies the path to where a PSIO sd card has
                        been mounted. The games will be be installed as
                        <path>/<game-title>/<game-title>.bin
                        If you list more than one file it is assumed these
                        are all the disks part of a multidisc game and
                        MULTIDISC.LST will be created accordingly.
                        PSIO uses CU2 files so must have cue2cu2.py installed
in the same directory as pop-fe.py.
--psp-dir <path>      : This specifies the path to where a PSP sd card has
                        been mounted. The games will be converted into
                        an EBOOT.PBP and will be installed as
                        <path>/PSP/GAME/<game-id>/EBOOT.PBP
                        The EBOOT.PBP will have a cover icon as well as a
                        background image embedded.
If you specify multiple images then a single multi-disk
EBOOT.PBP will be created.
If you specify path as 'auto' then pop-fe will
scan all mounted media and pick the first one that
contains a PSP or VITA memory card.
--psp-install-memory-card : Used to install memory card images on the PSP.
See memory card section below for usage.
--ps2-dir            : This is the directory that holds the USB stick to
        install VCD files for running under POPS on a PS2.
--ps3-pkg            : This creates a PS3 PKG
This requires CU2 files so make sure this script is
installed.
--psc-dir            : This is the directory that holds the USB stick
        with AutoBleem to install to. The game will be installed
as Games/<title>.PBP. The PSC emulator can only handle
single disc PBPs :-(
Specify --psc-dir=auto and it will scan all connected
devices to try to find the one with AutoBleem.
--ps3-libcrypt        : Apply libcrypt patches also when building PS3 Packages.
        This should normally not be needed as we automatically
inject the magic word to the emulator running on the
PS3.
--snd0                : Provide an audio file to be played when this game
        is focused on the XMB. See the SND0.AT3 section below.
--auto-libcrypt      : Try to automatically create and apply a patch for
                        libcrypt. This can be used if there is no proper PPF
file available. This is not 100% reliable.
--retroarch-bin-dir  : The directory where retroarch game bins are to be
                        installed, inside a subfolder. Includes an m3u file
                        for correctly loading multi-dics games.
--retroarch-cue-dir  : The directory where retroarch game cues (as .CD files)
                        are to be installed with their respective bins, inside
                        a subfolder. Includes an m3u file for correctly loading
                        multi-dics games.
                        the different discs inputted.
--retroarch-pbp-dir  : The directory where retroarch game pbp images are to be
                        installed.
--retroarch-thumbnail-dir : Where the coverimage for retroarch should go.
</pre>
 
===Examples===
<pre>
Assume I have connected my PSP with USB and it is shows up as :
  /run/media/sahlberg/disk
 
$ ./pop-fe.py --psp-dir=/run/media/sahlberg/disk /psx/Metal\ Gear\ Solid\ VR\ Missions.cue
 
Or you can just let pop-fe try to discover it automagically for you. This
works for both Linux and Windows:
 
$ ./pop-fe.py --psp-dir=auto /psx/Metal\ Gear\ Solid\ VR\ Missions.cue
 
If you specify more than one cue file then it is assumed that this is
a multidisc game and we will use the first cue file to determine the
game id and title to be used for the whole set.
 
Example:
# ./pop-fe.py --psp-dir=auto /psx/Grandia1of2.img /psx/Grandia2of2.img
 
During the conversion process the img/bin file will be temporarily converted
into an ISO file as NORMAL01.iso in the current directory.
This is in order to open the iso9660 image and read the system.cnf file
to extract the game id.
You can avoid/skip this step by forcing the game-id from the command line,
using (example only):
    --game-id=SLUS00957
   
Game art and images are fetched from https://psxdatacenter.com/
If a file named the same as the CUE but with the extension *_cover.png is found in the game
directory it assumed to be the cover image and thus we skip pulling it from psxdatacenter.
Example: cuefile:  foo.cue and corresponding cover in foo_cover.png
 
Similarly, files named as <cue>_pic0.png and <cue>_pic1.png are used for the screenshot
images.
</pre>
 
==Changelog==
'''v1.0.14'''
'''v1.0.14'''
* This release adds a lot more software manuals for psp.
* This release adds a lot more software manuals for psp.


[https://github.com/sahlberg/pop-fe/releases Latest changelog]
[https://github.com/sahlberg/pop-fe/releases Release notes]


== External links ==
== External links ==
* Github - https://github.com/sahlberg/pop-fe
* GitHub - https://github.com/sahlberg/pop-fe
* Reddit - https://www.reddit.com/r/psphacks/comments/wtmbjc/best_psx_tool_popfe/

Latest revision as of 05:11, 26 December 2025

POP-FE
General
Authorsahlberg
TypeFile Operation
Version1.26
LicenseLGPL-2.1
Last Updated2025/12/13
Links
Download
Website
Source

POP-FE is a tool designed for automating the process converting PSX disk images and install them on various platforms, including:

  • PSP/VITA.
  • PSIO.
  • PS2.
  • PS3.
  • Retroarch.
  • PS Classic.

For Linux and Windows.

Features

  • Automatically detects the disc ID and game title from the disc image.
  • Automatically downloads PSX cover image and gameplay images.
  • It handles multi-disc games, with up to 5 discs supported.
  • Automatically disables libcrypt.
  • Automatically converts any CDDA (Compact Disc Digital Audio) tracks into ATRAC3 format and injects them into the EBOOT.
  • Aside from PS3 packages, it can also convert games for use on PSP/VITA/PS2/PSIO.

Changelog

v1.26

  • Add a config file to remember settings/directories between runs.
  • Fix broken watermarks in pop-fe-psp.
  • PS3: fix for running NTSC games on a PAL console could be using wrong timings.
  • And a lot of more assets in the database.

v1.25

  • Lots of more assets.
  • Also adding tooltips to the UI.

v1.24

  • Windows does not have wget by default so switch to using requests.get instead.

v1.23

  • CHDMAN does not seem to work well right now so disable it for now.
  • The only true way to store disk images is in redump cue/bin format anyway.

v1.22

  • The big new feature in this release is that we can now generate "Software manual" on the PS3.
  • All NTSC-U games should have high quality scanned manuals.
  • Support for PAL or NTSC-J manuals is spotty. If you find links to good high quality scans of PAL/NTSC manual(2) please open an issue and provide the link and I can add it to the database.

v1.21

  • Many updates to assets.
  • Main update is that the UI for pop-fe-psp and pop-fe-ps3 now has boxes to allow you to tweak the scaling and placement of the PIC0 logotype so that the games will look extra good.
  • Now, it is a LOT of work to maintain and populate the ~12.000 different disc entries in the database so I just can not do it all by myself.
  • I have added links to ~11.000 disks for the PIC0 image but adding the scaling and placement tweaks is just too much.
  • If you find a game where doing some tweaks in the UI amke the placement and look of the game much better than the default, please open an issue on github with the game/disc id and the valies for scaling and x/y offsets and I will update the database so the next user that tries to convert the game will get a better experience than you had.

v1.20

  • Fix SND0 generation on PSP so it plays at the correct speed and pitch.
  • Add an option to use the ICON as PIC1 background.
  • Add options for PSP to tweak the placement and scaling of the PIC0 logo.

v1.19

  • Updated some assets, fixes a bug with the swap-disk option for PS3.
  • and added a new tool, layout.py (linux only) that helps to see how pic0/pic1 composition will look like on PS3 XMB and also PSP XMB.
  • This allows easier tweaking of 'pic0-scaling' (to change the scaling of pic0) and 'pic0-offset' (to change the positioning of pic0) than building eboot/pkg and installing on devices.
  • pic0-scaling/-offset will be used to manually curate the placement of pic0 so that the games look even better than when using the default positioning, which sometimes cause pic0 to cover imporant details in the pic1 background image.

v1.18

  • New version. Just some more assets but also an updated version of pytubefix to make youtube downloads of audio work again.

v1.17

  • Add snd0 for legend of dragoon.

v1.16

  • Windows filesystems are case insensitive so they treat .cue and .CUE as the same extension.
  • Fix extension detection in pop-fe to handle uppercase extensions.

v1.15

  • Fix bug when processing a game by CCD.

v1.14

  • Support older POPS versions on PSP
  • This involves not generating a PSTITLEIMG section for single disc games.

v1.13

  • This adds support for singledisc games on old versions of POPS on PSP.

v1.12

  • Switch to a different library for youtube audio.

v1.11

  • Update with more assets and features.

v1.10

  • Due to heroic work and contributions by the folks at psx-place and gbatemp.net we now have a LOT of new emulator configuration overrides for PSP and PS3 making a LOT of problematic games playable.
  • Even AlienResurrection now works perfectly !!!

v1.8

  • This should greatly speed up conversion of games containing a large SND0 or Manual.

v1.7

  • This version contains A LOT of config updates that fixes close to 300 games that has never worked, or worked with glitches on PSP/VITA.
  • The fixes are applied automatically when converting the game into a PSP EBOOT.

v1.6

  • Fix for pop-fe-ps3.exe after the build changed the file layout and broke things.

v1.5

  • fix pop-fe-psp on windows.

v1.3

  • This update adds a number of external configs (that were missing due to a workflow bug) for building games for PS3 PKSs and solves issues with many games.

v1.2

  • We already use the config to make PAL games forced into NTSC run at the correct speed for pop-fe.py.
  • Now do the same for pop-fe-ps3

v1.1

  • Fix for incorrect leadout for the disc image which caused some games such as Fear Effect NTSC-U to hang on the PS1 boot screen.

v1.0.15

  • Don't crash just because an image we got was corrupted/unparseable. Just ignore the image instead.
  • Also update BloodyRoar2 to use a better/not-corrupted PIC0

v1.0.14

  • This release adds a lot more software manuals for psp.

Release notes

External links

Retrieved from "https://www.gamebrew.org/index.php?title=POP-FE_PSP&oldid=203369"

Advertising: