Releases: hippie68/pkgrename
pkgrename v1.09
Changelog v1.09:
- New pattern variables: %fake%, %fake_status%, and %retail%, which depend on the type of the PKG:
PKG type %fake% %retail% %fake_status%
"Fake" PKG (FPKG) Fake <empty> Fake
Retail PKG <empty> Retail Retail
- New option: -l, --language LANG: If the PKG supports it, the language specified by language code LANG (see --print-languages) is used to retrieve the PKG's title in your favorite language. The following language codes are available:
zh_s Chinese (simplified)
zh_t Chinese (traditional)
cs Czech
da Danish
nl Dutch
en-gb English (United Kingdom)
en English (United States)
fi Finnish
fr-ca French (Canada)
fr French (France)
de German
el Greek
hu Hungarian
in Indonesian
it Italian
jp Japanese
ko Korean
no Norwegian
pl Polish
pt-br Portuguese (Brazil)
pt Portuguese (Portugal)
ro Romanian
ru Russian
es-la Spanish (Latin America)
es Spanish (Spain)
sv Swedish
th Thai
tr Turkish
vi Vietnamese
- New option: --set-fake STRINGS: Set %fake%, %fake_status%, and %retail% mappings to two comma-separated STRINGS. The first string replaces %fake%, the second one %retail%.
- New option: --set-backport STRING: Set %backport% mapping to STRING.
- New option: --tag-separator SEP: Use the string SEP instead of commas to separate multiple release tags.
- Fixed file name release detection bug.
- Command [A] can no longer be triggered accidentally.
pkgrename v1.09 (beta version)
Changelog v1.09:
- New pattern variables: %fake%, %fake_status%, and %retail%, which depend on the type of the PKG:
PKG type %fake% %retail% %fake_status%
"Fake" PKG (FPKG) Fake <empty> Fake
Retail PKG <empty> Retail Retail
- New option: l, --language LANG: If the PKG supports it, the language specified by language code LANG (see --print-languages) is used to retrieve the PKG's title in your favorite language.
- New option: --set-fake STRINGS: Set %fake%, %fake_status%, and %retail% mappings to two comma-separated STRINGS. The first string replaces %fake%, the second one %retail%.
- New option: --set-backport STRING: Set %backport% mapping to STRING.
- New option: --tag-separator SEP: Use the string SEP instead of commas to separate multiple release tags.
- Fixed file name release detection bug.
pkgrename v1.08a
Changelog v1.08a:
- Fixed a few bugs that happened when entering multiple tags.
Changelog v1.08:
- New pattern variable: %file_id% can be used to rename files the "offical" way (e.g. "pkgrename -p '%file_id%'" => "EP4497-CUSA05571_00-00000000000GOTY1-A0403-V0100.pkg").
- New pattern variable: %msum%, a checksum that indicates whether game and update PKGs that have the same Title ID are compatible with each other ("married").
- Command [T] now supports the Tab key for word completion (pressing Enter still means both "Tab" + "Enter").
- Support for multiple release tags: Command [T] now supports entering of multiple comma-separated release tags. When a filename contains multiple known release tags, they are preserved.
- Command [L] and changelog release tag detection now search for user-provided tags, too.
- New option: --override-tags: Make changelog release tags take precedence over existing file name tags (normally, it's the other way around). Rescanning existing PKG collections using this option may reveal new release tags.
- An ambiguity warning is displayed if a file does not have a release tag yet and multiple known release tags were found in the changelog.
- New hotkey: pressing shift-[T] removes all release tags.
- Bug fixes and improvements.
This is a Windows release of the command line utility "pkgrename", which can help to organize PS4 PKG collections.
Type "pkgrename --version" to see your current release.
At least Windows 10 build 17063 is required to use the online search feature out-of-the-box.
Alternatively, install cURL for Windows: https://curl.se/download.html.
On Windows 10/11, it is strongly recommended to activate the UTF-8 beta feature: Settings - Time & Language - Language - Administrative language settings - Change system locale... - Beta: Use Unicode UTF-8 for worldwide language support.
For Windows 10 users it is recommended to use the new Windows Terminal application (which is now the default terminal in Windows 11) instead of the standard cmd.exe command prompt.
When using both the UTF-8 beta feature and Windows Terminal, pkgrename should work as intended.
If the UTF-8 beta feature is not used, file names that contain multibyte characters may cause this error:
Could not read file system information: "weird_characters_????.pkg".
Such a PKG file can't be renamed then and will be skipped.
Please report bugs and unexpected behavior at https://github.com/hippie68/pkgrename/issues.
How to run pkgrename.exe from anywhere with modified arguments:
Put pkgrename.exe in a folder (you can also put other command line programs there). Inside that folder, create a new batch file named "pkgrename.bat" and open it with Notepad. Write the following lines, while replacing ARGUMENTS with your preferred arguments:
@echo off
pkgrename.exe ARGUMENTS %*
For example:
@echo off
pkgrename.exe --pattern "%%title%% [%%title_id%%]" --tagfile "C:\Users\Luigi\pkgrename_tags.txt" %*
As seen above, if the batch file contains pattern variables, their percent signs need to be escaped by doubling them. For example, %title% must be changed to %%title%%.
Now click Start, type "env" and select "Edit environment variables for your account". Select "Path" and click edit. Select "New" and enter the folder where you put pkgrename.bat into. Close and reopen any opened command line windows for the changes to apply.
Downloads:
pkgrename.exe for 64-bit Windows
pkgrename_32.exe for 32-bit Windows
pkgrename v1.07a
Changelog v1.07a:
- Fixed a bug that could cause the program to freeze.
- Fixed option --print-tags not being recognized.
- Better command line argument handling (by employing https://github.com/hippie68/getopt).
- The program no longer hangs when the Windows UTF-8 beta feature is not enabled and a file system entry that contains UTF-8 multibyte characters is encountered. Such files however can't be renamed unless the UTF-8 beta feature is enabled.
- The program does not exit anymore when a resulting file name would be too large for exFAT partitions (but it still prints a warning message).
- New option: --query: scripts and tools can call pkgrename with multiple file names as command line arguments to receive a list of name suggestions.
- Small bug fixes, stability and performance improvements.
Changelog v1.07:
- Implemented multi-threading to further improve performance: PKGs are now scanned in the background during user input.
- Scanning is no longer aborted when one of the files can't be read.
- Fixed command [L] not printing changelog data if neither %merged_ver% nor %true_ver% is used.
- Changelog data is now used to update empty %release% pattern variables. Rescanning existing PKG collections may reveal new release tags and is advised.
- Command [L] now prints a list of known release tags found in the changelog data. Useful if there are multiple tags to choose from.
- New hotkey: pressing the backspace key goes back to the previous PKG(s).
- New hotkey: pressing the space key returns to the current PKG.
- Linux: new option: --disable-colors: disable colored text output (useful for terminals that don't support colors).
- Windows: fixed a bug that caused the program to report errors after scanning 512 files.
- Other small fixed and improvements.
This is a Windows release of the command line utility "pkgrename", which can help to organize PS4 PKG collections.
Type "pkgrename --version" to see your current release.
At least Windows 10 build 17063 is required to use the online search feature out-of-the-box.
Alternatively, install cURL for Windows: https://curl.se/download.html.
On Windows 10/11, it is strongly recommended to activate the UTF-8 beta feature: Settings - Time & Language - Language - Administrative language settings - Change system locale... - Beta: Use Unicode UTF-8 for worldwide language support.
For Windows 10 users it is recommended to use the new Windows Terminal application (which is now the default terminal in Windows 11) instead of the standard cmd.exe command prompt.
When using both the UTF-8 beta feature and Windows Terminal, pkgrename should work as intended.
If the UTF-8 beta feature is not used, file names that contain multibyte characters may cause this error:
Could not read file system information: "weird_characters_????.pkg".
Such a PKG file can't be renamed then and will be skipped.
Please report bugs and unexpected behavior at https://github.com/hippie68/pkgrename/issues.
How to run pkgrename.exe from anywhere with modified arguments:
Put pkgrename.exe in a folder (you can also put other command line programs there). Inside that folder, create a new batch file named "pkgrename.bat" and open it with Notepad. Write the following lines, while replacing ARGUMENTS with your preferred arguments:
@echo off
pkgrename.exe ARGUMENTS %*
For example:
@echo off
pkgrename.exe --pattern "%%title%% [%%title_id%%]" --tagfile "C:\Users\Luigi\pkgrename_tags.txt" %*
As seen above, if the batch file contains pattern variables, their percent signs need to be escaped by doubling them. For example, %title% must be changed to %%title%%.
Now click Start, type "env" and select "Edit environment variables for your account". Select "Path" and click edit. Select "New" and enter the folder where you put pkgrename.bat into. Close and reopen any opened command line windows for the changes to apply.
Downloads:
pkgrename.exe for 64-bit Windows
pkgrename_32.exe for 32-bit Windows
pkgrename v1.06d
Current release: Jul 23 2023
Changelog v1.06d:
- Fixed option -p, --pattern causing a segfault.
Changelog v1.06c:
- Added overflow checks to guard against corrupted PKG data.
- New command: [L] - Print existing changelog data.
Changelog v1.06b:
- More patch detection fixes.
- %true_ver% now works for update PKGs, too.
Changelog v1.06a:
- Fixed command [P] not resetting pattern variable %true_ver%.
Changelog v1.06:
- Improved backport detection.
- Fixed %true_ver% pattern being ignored.
- Other small bug fixes & improvements.
Changelog v1.06 Beta:
- Fixed a bug that caused PKGs to be skipped after user input.
- The tool now tries to detect apps that contain a merged patch (remaster or manually merged). Please report any false positives or wrong version numbers.
- New command: [P] - (Hidden) Toggle merged patch detection for app PKGs.
- Added pattern variables %merged_ver% and %true_ver%, which can be used to show a merged patch's version. If a merged patch is found, both %merged_ver% and %true_ver% are the patch version. If no patch is found, %merged_ver% is empty and %true_ver% is %app_ver%.
- The default pattern has been updated to include %merged_ver%.
Changelog v1.05f:
- Windows 11: fixed an issue that prevents the Windows 11 terminal from opening files whose filenames contain special characters.
- Windows 10/11: fixed filenames not displaying properly even if the Windows UTF-8 beta feature is enabled.
- Windows: fixed online search.
Changelog v1.05e:
- Unless manually specified, directories starting with "." or "$" (i.e. $RECYCLE.BIN) are now ignored when using option -r, --recursive.
- Pattern variable %region% is now displayed as either "AS", "EU", "JP", "US", or "IN".
Changelog v1.05d:
- Added pattern %region% (first two characters of the Content ID) as requested in #3.
- Fixed a bug that happened when using tag files that contain empty lines.
Changelog v1.05:
- Fixed a bug in word/release detection (most notably "HR").
- The same pattern variables can now be used more than once.
- New option -c, --compact: Hide files that are already renamed (esp. useful with option -n and large PKG collections).
- New option --tags: Load additional %release% tags from a string.
- New option --tagfile: Load additional %release% tags from a text file.
- Generally improved search/replace functions for better results.
This is a Windows release of the command line utility "pkgrename", which can help to organize PS4 PKG collections.
Type "pkgrename --version" to see your current release.
At least Windows 10 build 17063 is required to use the online search feature out-of-the-box.
Alternatively, install cURL for Windows: https://curl.se/download.html.
Please report bugs and unexpected behavior at https://github.com/hippie68/pkgrename/issues.
How to run pkgrename.exe from anywhere with modified arguments:
Put pkgrename.exe in a folder (you can also put other command line programs there). Inside that folder, create a new batch file named "pkgrename.bat" and open it with Notepad. Write the following lines, while replacing ARGUMENTS with your preferred arguments:
@echo off
pkgrename.exe ARGUMENTS %*
For example:
@echo off
pkgrename.exe --pattern "%%title%% [%%title_id%%]" --tagfile "C:\Users\Luigi\pkgrename_tags.txt" %*
As seen above, if the batch file contains pattern variables, their percent signs need to be escaped by doubling them. For example, %title% must be changed to %%title%%.
Now click Start, type "env" and select "Edit environment variables for your account". Select "Path" and click edit. Select "New" and enter the folder where you put pkgrename.bat into. Close and reopen any opened command line windows for the changes to apply.
How to fix character issues:
PS4 PKGs use UTF-8 strings. If some special characters are not displayed properly, on Windows 10/11 you can enable the UTF-8 beta feature: Settings - Time & Language - Language - Administrative language settings - Change system locale... - Beta: Use Unicode UTF-8 for worldwide language support.
If there are still problems after enabling the beta feature, please visit #5.
Downloads:
pkgrename.exe for 64-bit Windows
pkgrename_32.exe for 32-bit Windows