Skip to content

Releases: XaRaBaS7/PS5-FFPFSC-Renamer

PS5 FFPFSC Renamer v0.5.0b

Pre-release

Choose a tag to compare

@github-actions github-actions released this 28 Aug 17:18
70268ed

PS5 FFPFSC Renamer v0.5.0b — PS5 FTP Compatibility Preview

v0.5.0b hardens the PS5 FTP workspace introduced in v0.5.0a after checking the current etaHEN FTP and ShadowMountPlus implementations at source level. This remains an alpha / prerelease intended for testing and feedback; v0.5.0 remains the current stable release.

FTP compatibility verified against current implementations

  • etaHEN's integrated FTP implementation uses port 1337 by default and supports the operations required by the workspace: passive FTP, MLSD, NLST, SIZE, REST, RETR, RNFR and RNTO.
  • The preferred Explorer path therefore continues to use MLSD on the integrated etaHEN server.
  • Added a Unix LIST parser fallback for standalone PS5 ftpsrv variants that do not expose MLSD/NLST, allowing the remote Explorer to remain usable with both server families.
  • Recursive remote discovery is now bounded by both result count and directory count so an unexpectedly broad PS5 root cannot turn into an unbounded traversal.
  • Small ShadowMount configuration/status files are size-checked before retrieval when FTP SIZE is available.

ShadowMountPlus rename safety

  • Current ShadowMountPlus source recognizes .ffpfsc as an image type by extension, so changing only the descriptive base filename does not remove .ffpfsc recognition.
  • Remote rename now checks all known filename/path-sensitive ShadowMount files: /data/shadowmount/config.ini, /data/shadowmount/autotune.ini, /data/shadowmount/manual.lst and /data/shadowmount/manual.status.
  • The utility reproduces ShadowMountPlus' current PFSC mount-point rule (filename stem + FNV-1a(full source path) under /mnt/shadowmnt/pfsc).
  • If the exact mount point for the selected .ffpfsc currently exists, the rename is refused. The image must be unmounted/stopped before retrying.
  • Existing destination-collision preflight, extension preservation and post-rename source/destination verification remain active.
  • .ffpfsc payload contents are never rewritten or recompressed by FTP rename operations.

PS5 FTP workspace

  • Separate Local Library and PS5 FTP workspaces keep remote operations visually distinct from local filesystem operations.
  • Manual PS5 host/IP, configurable FTP port, username and password are supported; credentials remain session-only.
  • Discover PS5 performs bounded scanning on private local LAN/Wi-Fi ranges for the selected FTP port.
  • The themed PS5 Explorer supports remote path navigation, Up/Refresh controls, folder browsing and recursive .ffpfsc enumeration.
  • Manual remote .ffpfsc rename includes confirmation, collision preflight and post-rename verification.

Desktop fixes carried forward

  • Fixed the Windows result-row selection path that could surface the automatic Feedback & Bug Report dialog when clicking or right-clicking a library row.
  • Increased the default result-list height.
  • Configuration panels auto-collapse after inactivity to return vertical space to the library list.
  • Scan now F5 remains available beside the progress controls even while configuration is collapsed.
  • Existing local Undo / Ctrl+Z, collision protection, PARTIAL blocking, pre-flight validation and transaction rollback remain unchanged.

Current preview scope

Connection, discovery, browsing, .ffpfsc enumeration and conservative remote rename are implemented. Automatic Title ID / title / version extraction directly from a remote multi-gigabyte .ffpfsc is still intentionally not performed by downloading the complete image. The next engineering stage is bounded random-access metadata reading over FTP using etaHEN's REST/RETR support, isolated from the Explorer control connection.

The FTP path has been validated against source implementations and automated tests, but a real-console test is still required because network conditions, payload versions and console storage layouts can vary. Test first with a non-critical or independently backed-up image.

Project: https://github.com/XaRaBaS7/PS5-FFPFSC-Renamer

PS5 FFPFSC Renamer is an independent homebrew/personal-backup utility and is not affiliated with Sony Interactive Entertainment.

PS5 FFPFSC Renamer v0.5.0a

Pre-release

Choose a tag to compare

@github-actions github-actions released this 28 Aug 13:32
de19205

PS5 FFPFSC Renamer v0.5.0a — PS5 FTP Preview

v0.5.0a starts the PS5 FTP workspace requested by the community while keeping the existing local-library workflow and rename-safety model intact. This is an alpha / prerelease intended for testing and feedback; v0.5.0 remains the current stable release.

PS5 FTP workspace

  • Added separate Local Library and PS5 FTP workspaces in the sidebar so remote operations are never confused with local filesystem operations.
  • Added manual PS5 host/IP, configurable FTP port, username and password fields. Port 1337 is preselected for the common etaHEN FTP setup.
  • FTP credentials are kept in application memory for the current session and are not written into project settings or feedback reports.
  • Added bounded Discover PS5 scanning for the selected FTP port across private local /24 LAN/Wi-Fi networks only.
  • Added a themed PS5 Explorer with remote path navigation, Up/Refresh controls, folder browsing and recursive .ffpfsc enumeration.
  • Added manual remote .ffpfsc rename with confirmation, destination-collision preflight and post-rename verification.
  • Remote rename requires the .ffpfsc extension to remain intact and does not rewrite or recompress the game image.
  • Known exact-path references in /data/shadowmount/config.ini and /data/shadowmount/manual.lst are checked before remote rename. When a reference is found, the operation is blocked instead of leaving an obviously stale ShadowMount path.

Desktop fixes carried into v0.5.0a

  • Fixed the Windows result-row selection path that could surface the automatic Feedback & Bug Report dialog when clicking or right-clicking a library row.
  • Increased the default result-list height.
  • Configuration panels auto-collapse after inactivity to return vertical space to the library list.
  • Scan now F5 remains available beside the progress controls even while configuration is collapsed.
  • Existing Undo / Ctrl+Z, collision protection, PARTIAL blocking, pre-flight validation and local transaction rollback remain unchanged.

Current alpha scope

The first FTP increment intentionally focuses on safe connection, discovery, browsing, .ffpfsc enumeration and verified remote rename. Automatic Title ID / title / version extraction directly from a remote multi-gigabyte .ffpfsc is not faked by downloading the complete image in the background; selective remote metadata access is the next stage of the FTP work.

Please test this prerelease on non-critical or independently backed-up files first. Reports about FTP-server compatibility, PS5 folder layouts, ShadowMount configurations and UI workflow are especially useful.

Project: https://github.com/XaRaBaS7/PS5-FFPFSC-Renamer

PS5 FFPFSC Renamer is an independent homebrew/personal-backup utility and is not affiliated with Sony Interactive Entertainment.

PS5 FFPFSC Renamer v0.5.0

Choose a tag to compare

@github-actions github-actions released this 26 Aug 23:25

PS5 FFPFSC Renamer v0.5.0 — Library Workflow & Reliability Release

v0.5.0 is a major desktop workflow and reliability update. It keeps the existing rename-safety model intact while adding a canonical non-versioned desktop architecture, multi-root/offline handling, scan-change tracking, library health tools, duplicate management, feedback reporting and official project branding.

Highlights

  • Canonical desktop.py / desktop_core.py runtime with focused feature mixins and legacy GUI modules retained only for compatibility.
  • Multi-root library workflow with explicit ONLINE, OFFLINE, ERROR and UNKNOWN root states.
  • Read-only preservation of previous rows from temporarily unavailable USB/NAS roots without feeding stale rows into rename plans.
  • Scan snapshot comparison with ADDED, REMOVED and CHANGED tracking, plus direct selection actions for added/changed results.
  • HEALTHY, PROBLEMS and OFFLINE filters and a compact in-memory status summary.
  • Library Health actions and a non-destructive Duplicate Manager with exact Title ID focus and explicit sampled comparison.
  • Rename-plan manifest export, scan-performance export and portable settings backup/restore.
  • Privacy-aware Help → Feedback & Bug Report... workflow with sanitized diagnostics, crash capture and a local queue before any network submission attempt.
  • Official PS5 FFPFSC Renamer branding for the Windows executable, taskbar/window icon, sidebar, About dialog and README.

Safety and reliability

  • FFPFSC payload contents are never rewritten or recompressed by rename/library-management operations.
  • PARTIAL metadata remains display-only and cannot be auto-renamed.
  • Destination collisions continue to block affected rename steps.
  • Selected library roots remain protected from Smart-folder rename.
  • Batch rename retains fresh pre-flight validation, transactional rollback, post-rename identity verification and persistent conservative Undo.
  • OFFLINE rows are informational/read-only and filesystem-backed actions are blocked until the root is available and scanned successfully again.
  • Failed or cancelled scans restore the previous successful library view as stale/read-only context instead of clearing it.
  • Automatic cache pruning runs only in the background when every configured root is confirmed online and remains scoped to current configured roots.
  • Ctrl+Z and Ctrl+A preserve normal text-editing behavior while focus is inside text-entry controls.

Feedback and crash reports

The application can create a sanitized technical report containing app/platform version, aggregate root/library state, last-scan metrics and recent Activity Log lines. Library paths, common user-profile/AppData/temp locations and usernames are redacted. FFPFSC payload contents, credentials and metadata-cache contents are not included.

Every report is written atomically to the local feedback queue first. When a project HTTPS feedback receiver is configured, Send report submits the same payload in the background; if the receiver is unavailable the queued copy is preserved and normal application workflows continue.

Performance and quality

  • Combined verified/failure cache lookup and one reused filesystem-stat pass.
  • Iterative os.scandir() discovery and overlapping recursive-root collapse.
  • Aggregate scan-phase timing without per-file report I/O.
  • Deterministic synthetic scanner regression coverage with 1,024 .ffpfsc files.
  • Expanded tests for offline-root preservation, stale-view guards, feedback redaction/transport, branding assets, release gates, scan snapshots and desktop MRO.

Windows package

Extract the complete archive and keep these executables together:

PS5-FFPFSC-Renamer.exe
mkpfs-helper.exe

The package includes the official branding assets, README, CHANGELOG, license/notices and the MkPFS source archive required by the release packaging workflow. No separate Python installation is required.

First-use recommendation

Before processing a complete library, validate the workflow with one non-critical .ffpfsc file or a file backed up independently. Keep an external backup of original files whenever practical.

PS5 FFPFSC Renamer v0.4.1

Choose a tag to compare

@github-actions github-actions released this 25 Aug 22:19
2bba3cd

PS5 FFPFSC Renamer v0.4.1 — Version Sync Hotfix

v0.4.1 is a small maintenance release that fixes the version reported inside the Windows application.

Fixed

  • The packaged application now reports v0.4.1 consistently in the About dialog.
  • pyproject.toml and ps5_ffpfsc_renamer.__version__ are synchronized.
  • Added an automated regression test that fails CI if the runtime version and project/package version diverge again.

Unchanged

There are no changes to FFPFSC parsing, MkPFS integration, rename planning, pre-flight checks, post-rename verification, Smart Folder behavior, rollback, Undo, Live Watch, Game Details or Naming Profiles compared with v0.4.0.

FFPFSC payloads are still never rewritten or recompressed by rename/library-management operations.

Windows package

Extract the complete archive and keep these executables together:

PS5-FFPFSC-Renamer.exe
mkpfs-helper.exe

No separate Python installation is required.

PS5 FFPFSC Renamer v0.4.0

Choose a tag to compare

@github-actions github-actions released this 25 Aug 19:45
f374555

PS5 FFPFSC Renamer v0.4.0 — Smart Library

v0.4.0 evolves PS5 FFPFSC Renamer from a safe metadata-driven renamer into a richer local library workspace while preserving the original rule: FFPFSC payloads are never rewritten or recompressed by rename/library-management operations.

Rename Safety Self-Test

A new Tools → Rename safety self-test... command validates the rename engine without touching the user's library. It creates disposable dummy .ffpfsc files in an isolated temporary directory and performs real Windows filesystem operations.

The self-test covers:

  • file-only rename and Undo;
  • Smart loose-file folder creation/move and Undo;
  • Smart existing-folder rename and Undo;
  • collision protection with no overwrite;
  • a late collision during a batch, including automatic rollback of an earlier completed rename;
  • SHA-256 checks on the temporary payloads to prove their bytes remain unchanged through the tests.

The same suite also runs automatically in CI.

Rename pre-flight and post-verification

Generated rename operations now have an additional safety layer around the existing transactional rollback and persistent Undo.

Immediately before filesystem changes, the app performs a fresh pre-flight that checks sources and destinations again. This can catch a destination that appeared after the preview but before the user confirmed the rename.

The confirmation summary shows the number of READY files, represented data size, file-path changes, folders to create/rename and blocked rows that will remain untouched.

After the rename, the app verifies that each destination represents the same filesystem object using file size plus Windows filesystem identity (st_dev / st_ino) when available. If a platform does not expose a usable file ID, it falls back to the existing lightweight sampled fingerprint. This verification does not require reading an entire large FFPFSC image.

Smart Library Watch

A new optional Live Watch can observe selected library roots for added, removed or changed .ffpfsc files.

  • disabled by default;
  • configurable 15 / 30 / 60 / 120 second interval;
  • compares only path, size and modification timestamp;
  • does not continuously parse images with MkPFS;
  • distinguishes Added / Removed / Modified changes in the Activity Log;
  • a real change triggers the normal cached scan;
  • unavailable drives are reported without clearing the current library.

This keeps the feature useful on SSD/NVMe while remaining respectful of archival HDDs and removable drives.

Game Details and artwork

Selecting one game can now show a dedicated Details workspace. MkPFS selectively extracts only:

sce_sys/param.json
sce_sys/icon0.png

The panel displays the game icon, title, Title ID/PPSA, content/master versions, file size, Renamer status, path and metadata source. A second tab exposes formatted raw param.json with a Copy action.

Details loading is asynchronous, debounced and cancellable. Quickly navigating the results does not leave obsolete metadata reads running.

A dedicated App Data cache stores extracted param.json and icon0.png. Cache Manager can show valid/stale entries and disk usage, prune stale entries or clear this cache. Rename and Undo operations migrate valid details-cache entries to the correct path so details remain instant after filesystem changes.

When multiple games are selected, the Details panel switches to an in-memory summary with count, total known size, unique Title IDs and status distribution without starting MkPFS.

Naming Profiles

The Filename Builder now supports reusable profiles. Bundled examples include:

ShadowMount / PPSA only
PPSA + Title
Title + PPSA
Full archive
Title + Version + PPSA

Custom profiles remember active components, order, compact/original version format, v prefix, folder handling and the new filename separator setting. User profiles are persistent and can be updated or deleted without rescanning the library.

Library Statistics

Tools → Library statistics... creates an instant report from the current in-memory scan:

  • number of files;
  • total and average known size;
  • unique Title IDs;
  • duplicate groups/files;
  • status distribution;
  • largest games;
  • details-cache usage;
  • unavailable-root count.

No additional MkPFS read is performed to produce these statistics.

Performance and quality

  • Game artwork is loaded on demand instead of during the main library scan.
  • Details cache is reused and migrated after rename and Undo operations.
  • Multi-selection details never creates unnecessary MkPFS work.
  • Existing SQLite verified/failure caching, batch lookups and os.scandir() discovery remain active.
  • Operation History SQLite connections are explicitly closed after each transaction/read, avoiding lingering Windows file handles.
  • README includes a versioned application preview.
  • CI enforces preview freshness whenever visible GUI files are changed.
  • Expanded automated tests cover Live Watch, details caching/migration, naming profiles, custom separators, library statistics, real temporary filesystem rename/Undo, collision rollback, rename pre-flight and post-verification.

Existing v0.3 reliability remains

v0.4 retains:

  • silent MkPFS helper execution;
  • dual scan progress;
  • Activity Log;
  • multi-root libraries;
  • autoscan on startup/Browse/Add folder;
  • sortable/searchable/filterable results;
  • duplicate comparison;
  • transactional batch rename + rollback;
  • persistent operation history + Ctrl+Z Undo;
  • CSV/JSON export;
  • Library Health;
  • collision/overwrite protection;
  • Recycle Bin integration.

Windows package

Extract the complete archive and keep these executables together:

PS5-FFPFSC-Renamer.exe
mkpfs-helper.exe

No separate Python installation is required.

Responsible use

This software is intended for lawful homebrew use and personal backups of content you legally own and dumped yourself. It does not download games, decrypt retail packages, provide keys, bypass DRM/license checks or distribute copyrighted PlayStation content.

PS5 FFPFSC Renamer v0.3.1

Choose a tag to compare

@github-actions github-actions released this 25 Aug 15:45
cabc51c

PS5 FFPFSC Renamer v0.3.1

v0.3.1 is a focused Windows UX/reliability hotfix for the v0.3 series.

Highlights

  • MkPFS now runs silently on Windows during normal scans, diagnostics and engine tests. The helper still runs exactly as required, but no console/CMD windows are shown to the user.
  • New integrated Activity Log at the bottom of the application with timestamped INFO, CACHE, MKPFS, OK, WARN and ERROR events.
  • The Activity Log can be shown/hidden, copied or cleared and is also persisted as a rolling log under %LOCALAPPDATA%\PS5-FFPFSC-Renamer\activity.log.
  • New dual progress display:
    • determinate Overall scan percentage;
    • animated Current activity bar for discovery/cache/MkPFS work.
  • README now includes clear Credits & Acknowledgements for MkPFS, Send2Trash, PyInstaller and related PS5 tooling projects.
  • The development launcher moved from root RUN.bat to tools\dev\RUN_DEV.bat; end users only need the standalone Windows release package.

Why two progress bars?

The whole-library percentage can be measured accurately. MkPFS selective metadata extraction does not expose a trustworthy percentage for one individual FFPFSC file, so the app uses an animated activity bar instead of presenting a fabricated per-file percentage.

Windows package

Extract the complete archive and keep these executables together:

PS5-FFPFSC-Renamer.exe
mkpfs-helper.exe

No separate Python installation is required.

Safety

Rename behavior is unchanged from v0.3.0: FFPFSC contents are never rewritten/recompressed, collisions are blocked, batch operations are rollback-protected and Undo refuses unsafe overwrites.

Responsible use

This software is intended for lawful homebrew use and personal backups of content you legally own and dumped yourself. It does not download games, decrypt retail packages, provide keys, bypass DRM, or distribute copyrighted PlayStation content.

PS5 FFPFSC Renamer v0.3.0

Choose a tag to compare

@github-actions github-actions released this 25 Aug 15:10
e88cc6b

PS5 FFPFSC Renamer v0.3.0

v0.3.0 turns the renamer into a more complete Windows library-management utility, with faster repeat scans, safer rename transactions and a cleaner desktop workflow.

Highlights

  • Saved library folders can scan automatically as soon as the app starts.
  • A dedicated Scan now / F5 action always remains visible for manual refreshes.
  • New Options center groups startup, scan/performance, naming, cache and MkPFS settings.
  • Faster library discovery with os.scandir() and batch SQLite cache lookups.
  • Unchanged PARTIAL/ERROR images now reuse a negative cache instead of launching MkPFS again every scan.
  • Multi-root libraries keep scanning when one drive or folder is temporarily unavailable.
  • Sort results by filename, PPSA, title, version, size, proposed output or status.
  • Persistent operation history and Undo last rename / Ctrl+Z.
  • CSV/JSON export and a Library Health report.
  • Cache Manager and MkPFS Engine Manager are available from the Tools menu.
  • New consistent in-app icon set plus a branded Windows EXE/taskbar icon.

Safer rename transactions

Batch rename is now transactional. If a later item fails, earlier completed items are rolled back automatically. Smart-folder failures also report incomplete rollback explicitly instead of silently leaving an uncertain filesystem state.

Undo checks that the original destinations are still safe before moving anything back. It never overwrites newly-created files/folders, and app-created directories are removed only when empty.

Performance

Repeat scans avoid unnecessary work through three paths:

  1. verified metadata cache for unchanged images;
  2. failure cache for unchanged images MkPFS could not parse previously;
  3. batch SQLite lookup instead of opening/querying the cache separately for every file.

Recursive file discovery now uses iterative os.scandir() and does not follow directory symlinks/reparse points.

Options

The Options window includes settings for:

  • scan saved folders automatically on startup;
  • scan automatically after Browse;
  • scan automatically after Add folder;
  • remember window size/position;
  • show relative or full paths;
  • include subfolders;
  • worker count for HDD/SSD/NVMe;
  • automatic pruning of missing cache records;
  • filename preset/components/version format/folder handling;
  • Cache Manager and MkPFS engine configuration.

Windows package

The Windows archive runs without a separate Python installation. Keep the complete extracted folder together, including mkpfs-helper.exe. The application EXE now carries the project icon in Explorer and the taskbar.

The corresponding MkPFS 0.0.9 source distribution remains included under source/third-party/.

Important safety behavior

  • Rename operations never rewrite or recompress .ffpfsc contents.
  • Automatic rename plans use only metadata verified from internal sce_sys/param.json or verified metadata cache entries.
  • PARTIAL metadata inferred from filename/folder remains display-only.
  • Existing target files/folders are not overwritten automatically.
  • Selected library roots are protected from Smart-folder renaming.
  • Delete actions continue to use the Windows Recycle Bin after confirmation.

Responsible use

This software is intended for lawful homebrew use and personal backups of content you legally own and dumped yourself. It does not download games, decrypt retail packages, provide keys, bypass DRM, or distribute copyrighted PlayStation content.

PS5 FFPFSC Renamer v0.2.0

Choose a tag to compare

@github-actions github-actions released this 25 Aug 07:56
d8db46e

PS5 FFPFSC Renamer v0.2.0

The first packaged Windows release focuses on safe library management and fast repeat scans.

Highlights

  • Scan one or more FFPFSC folders as a single library.
  • Reopen the app with your previous folders and filename preferences restored.
  • Reuse cached metadata so unchanged images normally skip MkPFS on later scans.
  • Search and filter large libraries, including duplicate Title IDs.
  • Build output names in any order using PPSA / title / version.
  • Smart folder mode can create or rename a dedicated game folder while protecting selected library roots.
  • Right-click one or multiple rows for rename, Explorer, re-analysis, diagnostics and Recycle Bin actions.
  • Compare duplicate Title IDs using path, size, version and lightweight sampled fingerprints.
  • Diagnose images that do not expose the expected wrapped exFAT layout.

Windows package

The Windows archive is intended to run without a separate Python installation. It includes a separate mkpfs-helper.exe for MkPFS operations and ships the corresponding MkPFS 0.0.9 source distribution under source/third-party/.

Important safety behavior

  • Rename operations never rewrite or recompress .ffpfsc contents.
  • Automatic rename plans use only metadata verified from internal sce_sys/param.json.
  • PARTIAL metadata inferred from a filename/folder is display-only.
  • Existing target files/folders are not overwritten automatically.
  • Delete commands move files to the Windows Recycle Bin after confirmation.

Responsible use

This software is intended for homebrew and personal backups of content you legally own and dumped yourself. It does not download games, decrypt retail packages, provide keys, bypass DRM, or distribute copyrighted PlayStation content.