Shinobi (PS2) Recomp

Shinobi (PS2) Recomp is a native Windows port of Shinobi for PlayStation 2 with a new launcher, mod support, and DualSense HD haptics.

README

Shinobi (PS2) Recomp

Verified developer on RecompStore

Latest: v0.5.3. Runs on older CPUs too (no AVX2 needed), HD texture packs you can switch live with Shift+F5, and a download 40% smaller (111 MB to 67 MB) with nothing taken out. The HD HUD is a work in progress: more of it gets upscaled with every update. More below.

v0.5 is out: Frame Generation (360 FPS+), Latency Reduction, IMAX Mode, a Final Boss Balance mode, Infinite Health, 8 new mods on the F keys, Proton / Linux / Steam Deck (beta), a new overlay and 15+ fixes. ๐Ÿ”ฅ


The new dark launcher. The art stays in full colour.

Download and play

Easiest: RecompLauncher. It installs the game and keeps it up to date for you (new versions appear there once they are verified, usually within a few hours to a day).

Or from GitHub:

  1. Open Releases and download the newest Shinobi-PS2-Recomp-vโ€ฆ-Windows-x64.zip (67 MB). Right-click it and choose Extract All... (any folder except Program Files).
  2. Run Shinobi Launcher.exe (it is in the main folder you just unzipped).
  3. Press Game File, choose your own Shinobi (USA) disc image, press Set up game files, then Play Game.

Coming from v0.4? Download the newest release once and unzip it over your old folder (your saves, settings and game files are kept). From v0.5 on, the launcher updates itself: when a new version is out, an Update button appears in its title bar.

Everything is in this one repository: the launcher, the game program and the source code.

You must own the game

Buy your own copy of Shinobi (PlayStation 2, USA) and make a disc image (.iso) from your own disc with a DVD drive and a disc-imaging tool. This repository contains no game, no disc image and no game data, and it never will. We do not provide, link to or help anyone find a copy of the game. No disc, no game.


A native Windows port of Shinobi (PlayStation 2, USA) by TheRealAfsan, Twilight Orchard.

YouTube: https://www.youtube.com/@TheReal_Afsan
Reddit: https://www.reddit.com/user/Afsan23/

This repository does not contain the game. No disc image, no game files and no game data. You need your own copy of Shinobi (PS2, USA, SLUS-20459), made into an image file from the disc you own.

The game's own program is translated ("recompiled") to run natively on Windows. PCSX2's graphics (GS) and sound (SPU2) code is used for the parts that have to match the PS2 exactly.


v0.5.3: HD textures, older CPUs and a smaller download

HD texture packs (Shift+F5) โ€” the HD HUD is a work in progress

The game can now load higher-resolution versions of its own textures (PCSX2's texture replacement, built into the recomp's graphics code). Shift+F5 switches them on and off while you play, so you can see the difference straight away.

We're upscaling the HUD a piece at a time, and more gets done with every update. Done so far:

  • the health gauge (frame, the "9", its red veins and the blue soul flames)
  • the magic scroll and its icons (fire, slash, lightning) and the counter digits
  • the kunai icons
  • the TATE kill orbs and their kanji
  • the lock-on circle

Still to come: boss gauges, the remaining icons and the menus, as we get to them.

Why the HD textures aren't in the download: they're made from the game's own artwork, and this project never ships anything from the game. So you build them from your own copy, which takes a few minutes:

  1. In the launcher's Mod Menu, switch on Save textures (pack makers), play until the HUD is on screen, then switch it off again.
  2. Upscale the saved HUD textures with scripts/ps2_upscale.py (Real-ESRGAN on your graphics card). It handles the PS2's transparency properly, so there are no fringes or halos.
  3. The results go into textures/SLUS-20459/replacements, and the HUD is HD the next time it appears.

textures/README.txt has the details. Packs made for PCSX2 (Shinobi USA, SLUS-20459) work too.

Runs on older CPUs

No more AVX2 requirement: any 64-bit processor with SSE4.1 (2008 or newer, the same minimum as PCSX2) runs the game. It's still one launcher and one download. The launcher picks the faster AVX2 version or the compatible one for your CPU by itself.

40% smaller download

111 MB down to 67 MB, with nothing the game uses taken out. The two game programs are packed together with 7-Zip's compression, and DLLs that nothing ever loaded were removed.

Also
  • The launcher's self-update now works under Proton / Linux / Steam Deck too, and downloads are more reliable.
  • Fixed a crash on start-up when the game folder's name has certain characters (Japanese or accented letters).

v0.5: frame generation, IMAX mode and a pile of mods

A lot of this came straight from your feedback on Reddit. Thank you.

Performance
  • Frame Generation (F4): in-between frames for high refresh rate screens. Targets: Auto, 120, 144, 240, 360 or Max. Auto sits just under your screen's refresh rate. (Expect some ghosting the higher you go.)
  • Latency Reduction (F6): stops the graphics driver queueing frames, for about 16โ€“33 ms less input delay (similar idea to NVIDIA Reflex).
  • New Performance Overlay (F2): FPS, frame time, average, 1% lows, CPU, GPU, RAM and VRAM.

Frame generation with the overlay: around 200 FPS.

The new FPS tab.


Combat at 250 FPS.

8 new mods (Mod Menu, or straight from the F keys while you play)
  • IMAX Mode (F7): the TATE finishing moves play full screen with no black bars. Movies and story scenes keep theirs. (This was the hardest part.)
  • Infinite Health (F8): Hotsuma takes no damage from hits, and Akujiki can't drain him.
  • Final Boss Balance (F9) (beta): Hiruko without the hidden rules.
    • Seals open with one counted hit.
    • No parries of your sword before the real fight, and no instant guard when you slash him while he's idle.
    • He only teleports to spots on the ground, never mid-air.
    • Lock-on stays on him instead of jumping to the talismans.
    • You can hit him while he laughs and while he teleports.
    • Talismans that blow themselves up still count towards your TATE chain, and new ones come twice as fast.
  • Hide HUD (F5): health, kunai, magic, TATE counter and boss gauges hidden for a clean screen.
  • Uncursed Sword (Shift+F7): Akujiki no longer drains your health when you haven't killed for a while.
  • Unlock Everything (Shift+F6): every difficulty, character and extra open from the start. Your save isn't changed. (Restart the game after switching it.)
  • Remove Scarf (Shift+F8): Hotsuma without his scarf.
  • Scarf Body Collision (Shift+F9) (early): the scarf keeps its float and trail but no longer clips through Hotsuma.
Controls
  • Full controller remapping.
  • Invert camera (left/right and up/down separately).
Movies
  • The movie viewer now plays every movie cleanly, without the pink artifacts.

Proton / Linux / Steam Deck (beta)
  • The launcher now works under Proton. It skips its window, asks for your ISO once, copies the files and starts the game. After that it starts the game straight away.
  • Fixed ISOs failing to load when started from RecompLauncher on Linux.
  • The game now unpacks properly under Wine/Proton.
  • This is beta: please report how it runs on your setup.
15+ fixes
  • Pink boxes on the duo boss: fixed.
  • Pink square when an enemy dies at 21:9: fixed.
  • Missing textures in rushed cutscenes: fixed.
  • Freeze when changing Screen Position: fixed.
  • Freeze when switching to 4K while playing: fixed.
  • Updating over an old folder kept the old game: fixed.
  • Changing render scale in game now applies safely on restart.
  • F1 menu in exclusive fullscreen left the window the wrong size: fixed.
  • Launcher tabs could get squeezed off the bar: fixed.
  • The launcher now also starts on Windows 10 PCs without WebView2.
  • Hotkey notices and overlay text now use a proper font.
  • Resolution labels show real sizes (1920 ร— 1080, 3840 ร— 2160โ€ฆ).
  • The launcher can now update itself.
New defaults

1440p, D3D11, 60 FPS, 16:9, V-Sync and FXAA on, Latency Reduction and the overlay on, IMAX Mode and Final Boss Balance on, SEGA logos skipped. Reset to Defaults in the launcher brings these back.

Known issues
  • 21:9 and wider are still experimental.
  • 8K may not fill the whole screen, and HDR turns off at 8K (looking into it).


Now on RecompLauncher.


v0.4: the biggest update yet

v0.4.2: 4K and 8K fixed. Every frame the full-size picture was copied back from the graphics card (165 MB a frame at 8K), so high resolutions ran at a few frames a second. The copy is now capped at your screen size and shrunk in steps that keep the extra detail, so 4K/8K look smoother too. 8K went from 21 to 60 fps on our test PC.

  • Vulkan works again: it could not find its shader compiler and silently fell back to the slow software renderer.
  • Graphics cards with little video memory: 4K/8K is lowered automatically instead of showing green/pink textures or a black screen.
  • The launcher marks 4K as "needs a strong GPU" and 8K as "experimental".

v0.4.1: the game manual is no longer included in the download. Open your own Shinobi manual PDF with the launcher's Manual button: page-turning, zoom and F4 work the same.

v0.4 is here, as promised! Grab a drink.

The big ones
  1. A brand-new launcher. New rotating artwork, settings in tabs, a proper Shinobi icon, a resizable window that snaps 50/50, and you can drive the whole thing with a controller.
  2. Mod support. Change Hotsuma's scarf to any colour you like, live, plus a new close-up camera mod, all switchable in game.
  3. Full DualSense HD haptics, wired AND wireless. Every footstep left and right, every shuriken, every sword hit, and an L2 trigger that clicks before your magic fires.
  4. A close-up, over-the-shoulder camera (F3) for more intimate combat. It glides in and glides back out.
  5. Read your own game manual in the launcher. Open your Shinobi manual PDF once: real page-turning and zoom, and F4 in game slides it up over the action.
  6. Performance overlay (F2): FPS, frame time, 1% lows, CPU, GPU, RAM and VRAM, NVIDIA-style.
  7. Big performance work: geometry now runs across multiple CPU cores, the sound chip is 30% cheaper, and there's a new Low-end PC preset.
  8. 8K resolution and a whole set of new graphics options.
  9. Change settings live in game with F1. Most no longer need a restart.
  10. The missing cutscenes are fixed.
  11. Recomp Store / RecompLauncher: approved developer, with support coming soon (submission in progress).


The new close-up camera (F3) and an orange scarf, picked live from the Mod Menu.

Brand-new launcher
  • New rotating artwork behind the logo, crossfading every few seconds.
  • Settings in tabs: Display, Graphics, Effects, Controller.
  • Fully playable with a controller:
    • D-pad or stick moves, โœ• picks, โ—‹ goes back, L1/R1 switches tabs.
    • A clear red highlight shows where you are.
  • The window resizes, maximises and snaps (50/50 with another window).
  • Window Mode: Borderless, Exclusive Fullscreen or Windowed.
  • Your own Shinobi manual (PDF), with page-flip animation, mouse-wheel zoom and controller page-turning.
  • A Game File checklist plus an "I own this copy" tick, so you know your disc image is right.
  • A proper Shinobi icon on the launcher and the game.
  • It picks the right game build for your CPU (AVX2, or the SSE4.1 fallback for older processors).

Graphics: texture quality, sharpening, anti-aliasing, blending accuracy, texture filtering.

Effects: screen filter (Sharp / Smooth / Scanlines / CRT), dithering, mipmapping, upscaling fixes.

Controller: DualSense haptics, haptic strength, L2 trigger resistance.

Mods: Hotsuma in a blue scarf, picked live.
Mod support
  • Scarf colour: pick any colour for Hotsuma's scarf from a colour picker. It changes live while you play.
  • Close-up camera: an over-the-shoulder view (below).
  • Mods live in the Mod Menu and the F1 menu, so you can switch them on the fly.
  • This is the foundation for more mods to come. Tell me what you want next ๐Ÿ‘€

The Mod Menu with the scarf colour picker.

Hotsuma in a blue scarf.
DualSense HD haptics (DualSense and DualSense Edge)

I didn't want "rumble". I wanted it to feel like a modern PS5 game, so I built it from scratch, timed to the animations frame by frame.

  • Walking is light left/right taps, and running is heavier.
  • Each shuriken throw pushes on the side of the throwing hand.
  • Sword swings are strong, and landing a hit is a heavy thud.
  • The dash is a run of taps that travels across the controller.
  • The โ—‹โ—‹โ–ณ shuriken storm is an electric crackle the moment the shuriken leave his hands.
  • Ninja magic: L2 stiffens, you push through the click, and the whole controller swells as it fires. No more wasting magic with a light touch.
  • It works over USB and Bluetooth, with a strength slider and on/off switches in the launcher.
Close-up camera (F3)
  • Press F3 and the camera pushes in behind Hotsuma's shoulder, easing in rather than teleporting. Press F3 again to ease back out.
  • It steps aside automatically when you lock on with R1, so the two never fight.
  • It's also a switch in the launcher.
Performance
  • Geometry runs across multiple CPU cores.
  • The sound processor is about 30% cheaper and stays steady in long sessions.
  • New Low-end PC preset for slower machines.
  • Performance overlay on F2, so you can see exactly where you stand.
Graphics
  • 8K (12ร—) internal resolution.
  • Most settings change in game with F1, no restart needed.
  • New options:
    • Blending Accuracy
    • Texture Filtering
    • Screen Filter (Sharp / Smooth / Scanlines / CRT)
    • Dithering
    • Mipmapping
    • Upscaling Fixes


The F1 menu over the game: change settings and mods live, then carry on playing.

In game
Key
F1 (or Select+Start)Menu: settings, mods and controller, all live (pauses the game)
F2Performance overlay
F3Close-up camera
F4Frame generation
F5Hide HUD
F6Low latency
F7IMAX mode (no black bars in TATE finishing moves)
F8Infinite health
F9Fair final boss
Shift+F6Unlock everything
Shift+F7No sword hunger
Shift+F8Remove scarf
Shift+F9Scarf body collision
Shift+F5HD textures on / off
F10Mouse camera on / off
Alt+Enter / F11Window or full screen

Pressing any of these slides a little notice down in the corner, so you know it's on or off.

Fixes
  • The missing cutscenes are fixed.
  • Controllers work even with Steam Input or other virtual pads connected.
  • The F1 menu always responds to the controller.
  • The game starts in fullscreen properly.
  • Fixed a crash in ultrawide.
Known issues
  • The duo boss's projectiles still show pink boxes.
  • The frame rate can dip in the heaviest fights on slower CPUs. Full multi-thread support is in, so there should be gains on lower-end CPUs too.
  • Haptics are tested on the DualSense Edge; the standard DualSense should behave the same.
  • In rare cases, a cutscene that is rushed while loading can show missing textures.

Any issues? Tell me in the Issues tab or on Reddit, I read everything and I'll fix it.


What you need

  • Windows 10 or 11, 64-bit
  • Any 64-bit processor with SSE4.1 (Intel Core 2 from 2008, AMD from 2011, or newer: the same minimum as PCSX2). With AVX2 (Intel Core 4th generation, 2013+, or any AMD Ryzen) the launcher starts the faster build; without it, it starts the fallback build by itself. No choice to make.
  • A graphics card with Direct3D 11 (default) or Vulkan
  • Microsoft Edge WebView2 Runtime (part of Windows 11; without it the launcher still sets up and starts the game, just without its window)
  • The Microsoft Visual C++ Redistributable (x64), which most PCs already have
  • Your own disc image of Shinobi (USA), .iso (or .bin / .img with raw sectors)
  • About 1.5 GB free space, plus saves
  • For HD haptics: a DualSense or DualSense Edge (USB or Bluetooth)

Developed on a Ryzen 7 9800X3D and a GeForce RTX 5080. The CPU is the main limit: more fast cores help most.

Quick start

  1. Start Shinobi Launcher.exe.
  2. Game File โ†’ Browse... and choose your Shinobi (USA) disc image. The launcher checks it is the right game.
  3. Set up game files copies the game's files out of your image into the game folder (about 1.2 GB, once).
  4. Play Game (Recom).

The launcher remembers where your game file is and shows it under the Game File button.

Controls

Everything can be changed in Configure Controller (and the in-game menu, F1).

Keyboard default
D-padArrows or W A S D
Cross / CircleX or Space / C or Escape
Square / TriangleZ or Numpad 0 / V or Numpad 1
L1 / R1, L2 / R2Q / E, Left Shift / Right Shift
Start / SelectEnter / Tab
Camera (right stick)I K J L
  • Mouse: moves the camera; left click = Square, right click = Circle; F10 switches it on and off.
  • Controllers: DualSense, DualSense Edge, DualShock 4 and Xbox (360, One, Series) use the standard layout. The DualSense Edge is the one tested; is a controller not working for you? Let me know.
  • In game: F1 or Select+Start = menu (pauses), F2 = performance overlay, F3 = close-up camera, F4 = frame generation, F5-F9 and Shift+F6-F9 = mods (see the table above), Alt+Enter or F11 = window /