DuckStation

Emulator 0.1-8773

DuckStation emulates the PlayStation on Mac using Qt and SDL, but this open-source version remains experimental on macOS, with limited performance and potential bugs.

DuckStation is an open-source PlayStation 1 (PS1) emulator designed to prioritize playability and performance on a variety of devices, including low-power hardware. Developed with a technically precise approach while avoiding "hacked" optimizations, it includes a full Qt-based frontend and a fullscreen mode inspired by Dear ImGui, providing a modern and configurable interface.

On macOS, particularly recent versions and Apple Silicon models, DuckStation offers experimental support via libraries such as SDL and Qt, but remains less optimized than on Windows or Linux. Key features include a multi-platform CPU/JIT recompiler, hardware rendering (Metal, Vulkan, etc.), upscaling filters, a texture replacement system, and extended game format support (CD, ISO, PBP). Support for save states, netplay (via a dedicated fork), and advanced controls (lightguns, NeGcon) rounds out the offering, though some bugs or slowdowns may persist. Manual compilation via CMake is required for macOS.

Metal Gear Solid dans DuckStation

Last updated:

Platforms

Architecture

Mac OS X - macOS Mac OS X - macOS Intel x86 Intel x86 Apple Silicon Apple Silicon 64-bit 64-bit Metal Metal SDL Library

Download and links

Version history

0.1-11894
  • Ajout d’un type d’entrée "AudioCD" dans la liste des jeux et désactivation des propriétés détaillées pour les jeux PSF/Audio CDs.
  • Correction d’un crash rare dans le thread vidéo lors de l’échec d’initialisation du périphérique.
  • Amélioration de l’interface utilisateur avec des icônes d’expansion pour les menus déroulants et suppression d’un affichage incohérent dans les paramètres post-fx globaux.
  • Optimisation des builds macOS : construction des bundles optionnelle via CMake et suppression d’un hack lié aux Frameworks macOS.
  • Correction de la gestion des chemins natifs pour pcdrv_root et suppression de la copie des préférences utilisateur non sensibles dans les paramètres du jeu.
  • Ajout d’un badge de catégorie dans les notifications de réalisations et amélioration de l’affichage des listes de réalisations.
  • Dynamisation du chargement de libpng, libjpeg et libwebp pour réduire la taille du binaire.

Commits

  • 9287950af VideoPresenter: Fix prerotation handling with blur/transitions
  • b0f7c5c16 Update duckstation-qt_es.ts (#3792)
  • 20b626d41 MSBuild: Explicitly list plugins to copy
  • e05146d7a MSBuild: Track Qt translation outputs
  • 1e2ee51b1 MSBuild: Track Qt resource outputs
  • 8c7b74ca2 MSBuild: Fix Qt MOC dependency tracking
  • bf15b0df6 MSBuild: Generate Qt MOC files in parallel
  • 46364b24b MSBuild: Track QRC asset dependencies
  • 7652c0446 MSBuild: Generate Qt translations in parallel
  • 78cd1f248 MSBuild: Generate Qt UI headers in parallel
  • f34d2c475 Achievements: Add category badge to popup
  • f1d54ab74 Qt: Fix trailing slash being added to game directories
  • ec81e45b2 Settings: Disable gpu_force_video_timing in hardcore mode
  • 274143dfd CI: Update deps to 20260905
  • 9c91b9156 Common: Remove unused include
  • 7762f953c Build: Use C++23 across the board
  • 6f23cc25d System: Allow live-changing console region
  • 31948bcb5 Misc: Use static operator()
  • 084bc6fb3 Achievements: Fix padding in notifications/lists
  • 1cafea4e5 Qt: Slight improvement to track summary list
  • b91b9b247 Qt: Add RA Game ID to game properties
  • c05866d2b Qt: Add styling to select disc dialog
  • ebc51ff0c System: Don't copy non-sensitive user preferences to game settings
  • f1f8ee797 System: Disable post-processing when resetting settings
  • 75448944d dep/rcheevos: Bump to e871ef5
  • d9182a04d Qt: Add threads view to debugger
  • 118bb6616 Qt: Add call stack to debugger
  • 4a0cdd2dc Qt: Link stack view to memory view
  • 5100c5164 Qt: Use QPointer in DebuggerWindow
  • 3bc1e8cdf SettingsInterface: Create type aliases for string lists
  • 3eee1e61e INISettingsInterface: Don't set dirty if unchanged in SetKeyValueList()
  • 92fb83b6a Qt: Save debugger breakpoints to inis
  • f5ffb6b51 System: Fix unused function warning
  • 5aeeb72e6 VideoThread: Fix rare crash if device initialization fails
  • 0d33bd177 Settings: Ensure pcdrv_root is a native path
  • 3f44ac2e9 Deps: Bump to 20260906
  • f39feb9d8 Image: Load libpng/libjpeg/libwebp dynamically
  • fa77cd485 CMake: Don't unnecessarily bundle
  • c359ccfcb DynamicLibrary: Log loaded library paths on Linux
  • 2179487e5 SDLInputSource: Remove unused variable
  • fa935c296 SQLiteHelpers: Format file
  • 38751bdf7 SDLInputSource: Load SDL dynamically
  • 025872c52 Qt: Warn when LD_LIBRARY_PATH is overridden on Linux
  • b42b6981e Qt: Create desktop file before setup wizard on Linux
  • f1f6b0ee7 ImGuiManager: Load FreeType/plutosvg dynamically
  • 3ccc0c45f Util: Centralize dynlib loading
  • 17a721c8f ZipHelpers: Load libzip on-demand
  • 1f065b5ea CMake: Make bundle building on MacOS optional
  • d9071e49b CocoaTools: Return nullopt if not running from bundle
  • 69fe55034 DynamicLibrary: Drop MacOS Frameworks hack
  • 0fbd997d4 Misc: Remove atexit() usage
  • 0206d926f SDLInputSource: Centralize SDL subsystem loading
  • 7d169057d README: Update feature list
  • e05b9b9f9 FullscreenUI: Fix 'Use Global Setting' showing in global postfx settings
  • 3f5dca5ce FullscreenUI: Use expand icon for dropdowns
  • 2cb1bf7b9 GPUDevice: Add SingleTextureAndUBOAndPushConstants layout
  • 91c5a79b2 FullscreenUI: Use SingleTextureAndUBOAndPushConstants for blur apply
  • 4973361c5 GameList: Add AudioCD type
  • 00989b7ec Qt: Make game properties inaccessible for PSF/Audio CDs
  • 0cb515fe4 GameList: Reorder list entry types
  • 1d07ae225 Update duckstation-qt_es.ts (#3794)
  • 73c226615 DynLibs: Fix libjpeg load regression on Windows
  • 35d1f0629 Atualização Português do Brasil (#3793)
  • 443ef825b Qt: Merge import buttons in the memory card editor (#3795)
  • cbe7951be CPU/CodeCache: Remove thread_local recursive guard
  • 1ab327d6d GPUDevice: Drop SingleTextureAndUBOAndPushConstants
  • 3b30876e9 l10n: update Swedish Qt translation (#3796)
  • c66b2694d DynLibs: Fix libwebp loading on Windows
0.1-11826
  • Ajout d’un clavier virtuel en plein écran pour une meilleure accessibilité.
  • Correction des erreurs de traduction dans l’interface Qt et ajout d’icônes manquantes dans les popups de cheats.
  • Amélioration de la gestion des captures vidéo en réduisant le délai de pause pendant les pauses.
  • Optimisation de la gestion des textures GPU pour éviter les lectures croisées entre threads CPU/GPU.
  • Réservation de mémoire pour le cache de textures lors de l’activation de cette fonctionnalité.
  • Correction de la détection des jeux via les images CD-ROM (problème lié à des chemins vides).
  • Mise à jour des bases de données de jeux avec des entrées pour Sentou Kokka - Air Land Battle, Beyond the Beyond et Felony 11-79/Runabout.
  • Affichage de la taille du fichier lors de la capture vidéo dans l’OSD.

Commits

  • 6336c532a Cheats: Fix importing semi-broken files
  • c475fd699 Qt: Fix some machine translation errors
  • e8473a1e0 Qt: Fix incorrect highlight in memory viewer
  • 5e1aee1e2 Qt: Add missing icons to cheat import popup
  • 856905864 FullscreenUI: Add on-screen keyboard
  • ec212bfd1 FullscreenUI: Fix initial input not activating on some popup dialogs
  • 3c4f2bf25 FullscreenUI: Add missing PS icon for D-Pad
  • 527b402c6 ImGuiManager: Remove Host::BeginTextInput()
  • 943db2376 Achivements: Add rich presence monitor debug setting
  • e7157e366 FullscreenUI: Increase padding on value backgrounds
  • 24deeeef8 System: Fix initial capture mode on start
  • 56226045d FullscreenUI: Render loading screen with separate draw list
  • b984cb7ac System: Improve game setting reload workflow
  • 88df5c983 System: Persist settings interface objects
  • 8013df929 Qt: Fix window title when editing game specific controller config
  • 49d39aad7 PageFaultHandler: Set SA_NODEFER on MacOS as well
  • 4cf3404a1 PageFaultHandler: Determine write flag from ESR on MacOS ARM64
  • 7304bfe25 CPU: Ensure RAM code pages are invalidated on core thread
  • 83a03fe95 CPU/CodeCache: Assert that handlers execute on core thread
  • b0c0a8ab7 PageFaultHandler: Remove the exception handler mutex
  • f4a828303 FullscreenUI: Fix compiler warning
  • 1c3948c97 Qt: Update machine translations
  • 400c269b4 GameDB: Sentou Kokka - Air Land Battle
  • d8d8a0816 CDROM: Reduce pause-while-paused delay
  • eb938ce10 dep/rcheevos: Bump to f1417fb
  • d954b7a3d ImGuiOverlays: Clear list on save state selector close
  • b25e2358b GPUDevice: Don't immediately trim textures queued in same frame
  • 0bf64996c ImGuiOverlays: Add animation to save state selector
  • 25783d844 ImGuiOverlays: Close save state selector on device switch
  • 8de6b0ac7 GameDB: Add HASH for Beyond the Beyond (#3782)
  • 48719b86b Bus: Fix CPE parsing when dev logging is disabled
  • 96e0c4d38 LRUCache: Fix m_manual_evict not respected when adding
  • 824a1072e LRUCache: Add custom deleter override
  • 0b28c198f FullscreenUI: Remove shared_ptr usage
  • 5422093cd Misc: Use relative time when displaying timestamps
  • a444b1265 GameDB: Add hashes for multiple games (#3784)
  • 5f3db8ed0 Qt: Improve Italian translation (#3783)
  • 12e575260 dep/rcheevos: Replace usage of sscanf() in rc_json_get_datetime()
  • 8bc6dc8d4 Qt: Update Italian translation again (#3785)
  • 7940507f0 Achievements: Use title format in submit time tooltip
  • ad2a8a637 System: Ensure achievements game is identified before loading state
  • c992e1c6b Atualização Português do Brasil (#3787)
  • fc741c826 GPU/TextureCache: Fix CPU thread read on GPU thread
  • 889a0fd2d GPU/TextureCache: Fix last_vram_write and num_splits not being serialized
  • ee211591b GPU/TextureCache: Limit the amount of uploads saved to state
  • 8e8e13de3 System: Reserve state memory for texture cache when enabled
  • e2823b429 GameDB: Felony 11-79/Runabout
  • 535154dcb MediaCapture: Show file size in OSD
  • 9d05a8756 Host: Fix broken relative time plurals
  • 3f9453fda Host: Merge FullscreenUI relative time variant with Host
  • 392e19b2a Qt: Add translation update and cleanup scripts
  • 764a06bc2 CI: Ensure translations are cleaned on pull request
  • f40cd5155 dep/rcheevos: Add rc_client_set_unofficial_achievement_unlock_state()
  • 4beec807d SQLiteHelpers: Add BindInt64()/ColumnInt64()
  • a679377ce FullscreenUI: Permit empty footer array component
  • 2743bb25e Achievements: Track unlocks of unofficial achievements locally
  • 240b19932 PageFaultHandler: Read ESR on Linux ARM64 as well
  • 06e6d4c2c Data: Update SDL game controller database
  • 614faf7d3 Qt: Clarify RetroAchievements login message
  • 04187ba0c Qt: Use variadic arg() instead of chaining multiple invocations
  • 939918806 Qt: Group toolbar-related menu items into a submenu (#3789)
  • 6f7fc33fe Qt: Update machine translations
  • fe899efd1 Update duckstation-qt_es.ts (#3786)
  • 78ff46ad1 Tests: Fix util-tests building
  • bf5a6162d MemoryCardImage: Replace full-width characters with ASCII
  • c4e99c4ae CDImageMDS: Fix games not detecting due to empty path
  • dbf928ff6 FullscreenUI: Fix inverted parameters
  • c776dee9e CDImage: Replace filename identifier with path
  • aea63ce41 Spanish (Spain) translation update 2026/08/25 (#3790)
  • a736f4492 Update Italian translation (#3791)
  • f18017eeb Qt: Fix localised disc regions in game list
  • f5e22bc71 FullscreenUI: Fix cheats menu hotkey in batch mode
  • 88e4ca533 Qt: Enable verification for unscanned files
  • fe2306b1f ImGuiManager: Tweak OSD fade in time
0.1-11752
  • Ajout d’un installateur de BIOS et amélioration de la page de configuration dans l’interface Qt.
  • Option pour installer automatiquement les BIOS manquants lors du lancement.
  • Amélioration des performances GPU avec des corrections ciblées sur les backends Vulkan et D3D12 (gestion des textures, pipelines, synchronisation).
  • Gestion améliorée des polylignes dans le GPU (sérialisation et vérifications basiques ajoutées).
  • Support étendu des cartes mémoire : exposition des cartes multitap et correction des sélections partagées.
  • Améliorations du serveur GDB (support des adresses de continuation, single-step, gestion des signaux, validation des paquets, optimisations de performance).
  • Correction de fuites mémoire dans le backend Metal et gestion des objets.
  • Fix des buffer overreads dans les lecteurs d’images CD (PBP, MDS) et validation des entrées utilisateur.

Commits

  • 381ac7d1e MediaCapture: Fix incorrect samples on buffer wrap-around
  • b3d594a9a MediaCapture: Remove Flush() method
  • 4f72f4034 MediaCapture: Fix possible corruption in audio-only capture
  • 049437e42 MediaCapture: Resample audio when encoder doesn't support 44.1KHz
  • 8b9aaf787 MediaCapture: Display OSD warning when resampling
  • d33d3b82c Qt: Rework media capture menu
  • 6e0fb1e14 FullscreenUI: Add InputTextWithSuffix()
  • e2e4bae61 Settings: Ensure overlays directory exists in user resources
  • 56fa9dc61 Qt: Add refresh button to border overlay list
  • 12f012caa Spanish (Spain) translation update 2026/07/27 (#3777)
  • dc75335a7 Scripts: Translation tools experiments
  • 551aaa439 RegTest: Fix compile error
  • 8747aa183 Atualização Português do Brasil (#3778)
  • 4a04d3143 SPU: Fix volume sweep termination conditions
  • f6c4fe987 Achievements: Rename softcore to casual (#3779)
  • 2246697be BIOS: Add version information and filenames to list
  • 145474389 Qt: Allow empty recommended value in settings help
  • 30d351e4e Qt: Add CollapsibleWidget
  • 8dbc47606 Qt: Add BIOS Installer and improve BIOS setup page
  • 351778e44 Qt: Update machine translations
  • 406f325b2 Qt: Fix BIOS summary not updating on language change
  • 9c7c23f48 Qt: Fix main window language not updating after setup wizard
  • 57b952ab2 Timers: Improve emulation accuracy
  • 7c93a61ee Qt: Further simplify BIOS setup wizard page
  • 07401690b Qt: Fix crash opening game settings
  • 202923da5 Qt: Correct some clearly awful translations
  • 7111f4c12 Update duckstation-qt_es.ts (#3780)
  • b5a990bbd MemoryCard: Use constants for address and offset mask
  • c42082c4b StateWrapper: Avoid heap allocation in FIFOQueue read
  • f3d0e84b0 StateWrapper: Avoid possible integer overflow on 32-bit systems
  • 865fd9e57 StateWrapper: Save contiguous FIFOQueue bytes in one memcpy()
  • 97400d2d0 StateWrapper: Clamp enum values to max
  • b147f1ffd FIFOQueue: Zero out head/tail when size reaches zero
  • e95e5a0d2 FullscreenUI: Right-align achievement type badges
  • 18147a175 GPUBackend: Fix possible unflushed draws with runahead enabled
  • 4d700e468 MDEC: Ensure direct FIFO writes don't overflow
  • 26fa2ee4a MetalDevice: Fix a few leaky object retains
  • c07bf47d6 CDImageCue: Validate bits-per-sample for wave files
  • ecbe3c3b7 MemoryCardImage: Don't over-enumerate directory frames
  • 76f01d8c9 Misc: Fix under-allocation in sjis2utf8()
  • d6d8a7be1 CDImageCue: Fix implicit truncation warning
  • e86af51c8 Deps: Update bundled ffmpeg headers to 9.0
  • 6d0feff2f Deps: Update to 20260805
  • 3fed119df MediaCapture: Default to H264 on all platforms
  • 12a4a2648 Util: Avoid intermediate memory allocation in Shift-JIS conversion
  • 8a2c05ce5 Image: Avoid integer overflow for dimensions
  • 99fc655fa Updater: Fix possible path traversal during preprocessing
  • ebd090340 Updater: Fix possible infinite loop
  • 1fbfbb57d System: Fix implicit 32-bit truncation of screenshot size
  • 2c8e998da Spanish (Spain) editing pass - 2026/08/05 (#3781)
  • 6e242f5cb Bus: Flush line buffer after 512 characters
  • ca5cc7374 GPU: Add missing serialization of polyline buffer
  • f92b1a81d GPU: Add some simple checks to the polyline buffer
  • cd5e48af9 StateWrapper: Add max size checks to vector/string data
  • 2688a1dfc Achievements: Fix possible read past end of memory in callback
  • e48b3e302 Cheats: Fix possible OOB reads in malformed instructions
  • d3ff0b364 PSFLoader: Add missing header size checks when loading
  • a8a098a0a Common: Valid BCD functions should return boolean
  • b9cf3bbf0 CDImagePBP: Add missing validation of BCD digits
  • 467d0971b CDImagePBP: Check SFO index table count before reading
  • e0734381a CDImageMDS: Fix a bunch of possible buffer overreads
  • 6651f4d19 ISOReader: Fix possible integer overflow in GetSizeInSectors()
  • f1029b2df AnimatedImage: Fix possible integer overflow of dimensions
  • f11b43227 System: Add option to install BIOS when missing
  • 8778034bf RegTest: Fix compiling again
  • e175c8422 Bus: Pack state in struct
  • 5245a58b0 Settings: Fix invalid memory card values after install
  • 213c5b450 VideoPresenter: Use transfer pitch for screenshots
  • b3b57a2a0 VulkanDevice: Bind initial compute pipelines correctly
  • bbac943b5 VulkanDevice: Expose shared UBO binding to compute shaders
  • fc3e117f8 VulkanDevice: Synchronize compute image accesses
  • 4b5edbb85 VulkanDevice: Preserve mapped texture upload pitch
  • 6584adde9 VulkanDevice: Fix download buffer barrier ranges
  • 037ee47f7 VulkanDevice: Validate imported host buffer memory
  • 668f39fab VulkanDevice: Wait for presentation before swapchain teardown
  • 846236538 VulkanDevice: Address texture array subresources
  • 5f40f0ac1 VulkanDevice: Select advertised surface format pairs
  • 40e178787 VulkanDevice: Fix legacy render pass attachments
  • d1720c040 VulkanDevice: Respect fixed surface extents
  • a8de757b9 VulkanDevice: Store compute specialization values
  • 7b690ec1f VulkanDevice: Reset descriptor builder storage
  • 69c5051a8 D3D12Device: Restore state after mipmap rendering
  • a8c9324f4 D3D12Device: Transition cleared compute targets to UAV
  • 6e2f06a55 D3D12Device: Bound persistent descriptor allocation
  • 227389010 D3D12Device: Create texture arrays with all layers
  • b5f821bf4 D3D12Device: Transition all uploaded subresources
  • 402f9207f D3D12Device: Set render-pass clear formats
  • a4a03c476 D3D12Device: Assert alignment of download texture footprints
  • 685cf83c8 D3D12Device: Order dependent compute UAV accesses
  • 7b1596120 D3D12Device: Fix incorrect push constant root parameter index
  • 41ee40215 D3D12Device: Track readback source usage
  • 48a1a06f5 Qt: Don't try to load HTTP URLs as animated images in game list
  • 2f9c58762 FullscreenUI: Fix shared memory card selection
  • 4431915b4 FullscreenUI: Expose multitap memory cards
  • 6f704d405 FullscreenUI: Fix shared card name not disabling if unused
  • ee21478ad GPU/HW: Don't miss updating read texture for recursive draws
  • f7797b57e Controller: Add 'Disable Simultaneous Opposing Cardinal Directions' option
  • 0697597c5 Controller: Make mandatory functions pure virtual
  • d92fe3dac Data: Move all PromptFont glyphs to unallocated range
  • f04e08b24 GDBServer: Fix stop reply acknowledgements
  • 1a9379bd6 GDBServer: Support continue addresses
  • a36b75716 GDBServer: Support single-step addresses
  • c7324e333 GDBServer: Preserve unchanged resume state
  • 05166d1a7 GDBServer: Track the last stop signal
  • 3885778a2 GDBServer: Reply to invalid command arguments
  • aea374641 GDBServer: Validate complete packet fields
  • 4e0940500 GDBServer: Apply register writes atomically
  • 7c279dc96 GDBServer: Invalidate code after memory writes
  • 8d7046a89 GDBServer: Bound remote packet sizes
  • 60a4ec363 GDBServer: Queue complete protocol packets
  • 54d074fb6 GDBServer: Retransmit rejected replies
  • cba85882a GDBServer: Reject oversized incoming packets
  • d176e31aa GDBServer: Support signal resume packets
  • fe32554cc GDBServer: Restore run state after disconnect
  • c2418520e GDBServer: Notify host when first/last client connects/disconnects
  • 0a00cbc3c GDBServer: Send invalid instead of zero values for extra registers
  • ac6d89919 GDBServer: Disable nagle buffering on connect
  • 71c88506e GDBServer: Track breakpoint ownership
  • e3bea1978 GDBServer: Expand watchpoint ranges
  • b147ed63d CPU: Enumerate actions for callback breakpoints
  • 86360211b GDBServer: Report watchpoint stop details
  • fa5e11116 GDBServer: Use indexing instead of range-based for
  • 30fa5b4c4 Qt: Rename background controller poll to idle update
  • c7f282f18 Core: Use multiplexer to idle sleep for GDB server
  • 3bb39f4e3 ELFFile: Skip embedded PS-X EXE header segments
  • 2cf108618 GDBServer: Fix unused capture warning
  • cf2495759 Qt: Implement mouse capture using CoreGraphics
  • e2b78d4ca Qt: Tie relative mouse state to the active window
  • 8c1a2022e GDBServer: Expose target memory map and registers
  • c8abcf4b2 GDBServer: Expose GTE registers
  • 8a96948a8 GPUDevice: Use same buffer sizes across backends
  • 89fb3ad33 DMA: Hardwire reverse direction for OTC
  • d59fcfb9d ImGuiManager: Support rendering Hebrew text
  • 8ec85e305 Qt: Update machine translations
  • 232c9ad9f Achievements: Make password login asynchronous
  • 2c3261209 Qt: Simplify logout callback
  • 9f9009d64 Achievements: Ensure callbacks run on core thread for RAIntegration
  • 04f4f1ba2 Achievements: Respond to RAIntegration reset request
  • 1f925f86e Misc: Add a couple of missing fmt/format.h includes
  • b2f9c8fba Misc: Fix deprecated implicit conversion of fstring->string_view
  • c130fc12c dep/fmt: Update to v12.2.0
  • 5ee1d2569 GameDB: Disable PGXP/WS in Vanark
  • 5fd366809 Achievements: Don't double-free login callback on request failure

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum