3.2.1 - iPad skin bug fixes

Full Changelog: 3.2.0...3.2.1

Bug fixes:

• iPad skins fixed
• Joystick in default skin fixed in landscape
• Atari Lynx Retroach controls fixed
• RetroAchievements login fixed
• Skin selection and import UIs fixed
• Skin rotation issues fixed
• Skin previews fixed

3.2.0 - Skins, many bug fixes, speedups

Release 3.2.0

We're excited to announce Provenance 3.2.0, a major update focused on performance, skins, and quality of life improvements. This release brings highly requested features and fixes that make Provenance faster and more enjoyable than ever.

🎨 Skins: Now Free for Everyone!

The biggest news: Full skin support is now available to all users—no Provenance Plus required! We believe everyone should enjoy customizing their gaming experience. However, if you love what we're building, please consider supporting the project through Provenance Plus or Patreon.

What's New with Skins

• Full Manic and Delta Skin Support for all systems (except 3DS and DS—those are coming soon!)
• Dramatically Improved Performance: Faster rendering, loading, and smoother UI
• Fixed Rotation Issues: No more slow redraws when changing orientation
• Memory Optimizations: More efficient skin storage and rendering
• RetroArch Core Support: Skins now work across all emulator cores
• Enhanced Skin Browser: Faster, more responsive skin selection and preview

⚡ Performance Improvements

Library & UI

• Faster Main Library: Significantly improved scrolling and navigation performance
• Optimized Rendering Loop: Better frame pacing and smoother gameplay across all cores

Core Performance

• Dreamcast/Flycast Enhancements:
  • Faster emulation speed
  • Windows CE-based games now supported
  • Full networking support enabled
• emuThreeDS (3DS Core): Performance bump and reduced graphic glitches
• PPSSPP: More options exposed, layout fixes, and full skin support

ROM Management

• Rewritten ROM Importer:
  • Batch processing for multiple imports
  • Significantly improved artwork matching—more comprehensive, faster, and more accurate
  • Much faster and more reliable with fewer errors
  • Fixed bug where existing ROMs were repeatedly re-imported
  • Eliminated erroneous duplicate imports
  • 7zip Archive Support: Fixed large 7zip archive handling
• MAME/CPS ZIP Support: Drop MAME/CPS1,2,3 ZIP files directly into imports or the MAME/CPS ROMs folder—they'll import and load correctly!

🐛 Major Bug Fixes

Core Stability

• GameCube/Wii (Dolphin) Improvements:
  • Fixed flickering after pause/resume
  • Fixed mis-mapped button inputs
  • Corrected inverted settings
  • Faster access to overclock/underclock settings
  • Performance improvements matching dedicated emulator apps
• Atari ST: No longer crashes at boot
• Vectrex: Fixed core booting and blank video output
• Mednafen: Fixed static audio in CHD files with FLAC compression
• Odyssey2: Added numpad button support (can now select game number at boot)
• Atari 8-bit: Fixed and added proper controller support
• CPS1/2/3 (Capcom Arcade): Better compatibility and support
• RetroArch Core Crashes: Fixed many boot-up crashes
• RetroArch Pause Bug: Cores now properly pause when menu is opened, and menus are fully navigable
• VSync Output: Fixed video output issues when VSync was disabled

System Issues

• Siri Search Bug: Opening games from Siri search no longer causes games to reopen when closed
• Spotlight Database Corruption: Fixed critical bug that could corrupt the database during Spotlight searches, requiring slow re-imports
• ROM System Migration: Fixed bug where ROMs moved to different systems wouldn't actually move their files, causing incorrect re-imports
• Sideload Bundle ID: Sideloaded apps with changed bundle IDs no longer think they're App Store builds—all Provenance Plus features now work when sideloading or building with Xcode!

📊 Development Tools

FPS Indicator Improvements

• More Accurate Stats: Works with native Provenance cores (3D accelerated)
• Additional Information: More detailed performance metrics
• Note: Currently limited to native cores; RetroArch-based cores coming later

☁️ iCloud Sync Enhancements

• CloudKit Improvements: More reliable sync with better error detection
• Better Error Messaging: Clear, actionable error messages throughout the app
• Faster Sync: Optimized sync speeds for game saves and ROMs

🎮 Quality of Life

PPSSPP Updates

• More emulation options exposed in settings
• Fixed options not saving correctly
• UI layout improvements
• Full skin support

emuThreeDS (3DS) Updates

• Settings fixes
• Graphic glitch improvements
• Slight performance increase

General UI

• Improved Pause Menu: Cleaner, more intuitive interface
• Better Messaging: Enhanced error messages and notifications throughout the app

🌐 Website Update

We've completely refreshed provenance-emu.com with:

• Updated information and screenshots
• Modern styling and improved navigation
• New donation page with multiple support options

🚀 Coming Soon

We're hard at work on exciting features for future releases:

• tvOS App Store Release: Official App Store distribution for Apple TV
• 3DS & DS Skin Support: Complete the skin coverage
• More Cores: Additional system support
• Enhanced Stability: Continued refinement and optimization
• Seamless Cloud Storage: On-demand downloading for iCloud ROMs

💖 Support the Project

Provenance is a labor of love, built by the community for the community. If you'd like to support continued development:

• Provenance Plus: Optional in-app purchase (App Store builds only)
• Patreon: Monthly support with exclusive perks
• Buy Me a Coffee: One-time contributions
• Open Collective: Transparent funding

Every contribution helps keep this project alive and thriving. Thank you!

Installation

Get Provenance 3.2.0:

• App Store: Download from the App Store
• AltStore: Install via AltStore
• IPA Download: GitHub Releases
• Sideload: Installation Instructions

---

Thank you for being part of the Provenance community. Happy gaming! 🎮

Full Changelog: 3.1.1...3.2.0

3.1.1 - Bug fixes

What's Changed

• Fix settings titles by @dnicolson in #2419
• Check if app group container is readable by @dnicolson in #2420
• Fix settings labels on small devices by @dnicolson in #2421
• Replace “Wifi” with “Wi-Fi” by @dnicolson in #2427
• Fix side menu icon alignment by @dnicolson in #2429
• Fix search bar position by @dnicolson in #2430

Full Changelog: 3.1.0...3.1.1

3.1.0 - Flycast, Dolphin, RetroAchievements

What's Changed

• fixed ios 16 md5 hash failing; fixed bios watcher crashing by @pabloarista in #2409
• Release/3.0.6a by @JoeMatt in #2410
• iCloud Sync v1 by @pabloarista in #2414
• Feature/emulation scene by @JoeMatt in #2411

Full Changelog: 3.0.6...3.1.0

3.1.0 GM2

What's Changed

3.1.0 Changes plus;

Fixed Save states not showing in each consoles view

Save states carousel renders faster now

Feature flags toggle UI fixed

Sideloaded apps automatically get "Provenance Plus" features (must use unique bundle id)

Skins and CloudKit now enabled by default

Minor performance improvements to main interface and bootup

Full Changelog: 3.1.0a2...3.1.0-GM2

3.1.0a2: fix game more info not showing

Fixes issues from 3.1.0a1

• Fixed "Game Info" screen not showing
• Fixed JIT'd Flycast was actually JIT-less Flycast.

3.1.0a1 Release Notes

Pre-Release Notes

This pre-release includes a major overhaul of iCloud synchronization, significant improvements to the game import process, and various UI/UX refinements and bug fixes.

✨ New Features & Major Enhancements

• Overhauled iCloud Synchronization (bug/ios-icloud-not-syncing branch focus):
  • Vastly improved reliability and performance of iCloud sync for ROMs, save states, BIOS files, and screenshots.
  • Smarter handling of file downloads, uploads, and conflict resolution.
  • Optimized database interactions during sync to reduce overhead and prevent crashes (e.g., using game cache, batch processing).
  • Correctly handles scenarios like initial app load with existing iCloud files, turning iCloud sync on/off, and background file changes.
  • Improved deletion handling: files deleted from iCloud are now correctly removed locally and from the database, and vice-versa.
  • Refactored sync logic into dedicated Syncer classes for better organization and lifetime management.
  • Enhanced logging and error reporting for iCloud operations.
• Game Importer Refinements:
  • Improved logic for handling multi-disc games (CUE/BIN, M3U) to ensure all associated files are correctly processed before an import is marked complete.
  • Better error handling for late-arriving files, preventing premature completion of the import queue.
  • Refactored import logic to defer processing when necessary and to correctly handle paused or busy importer states.
• UI & UX Improvements:
  • Game Info Display: The "Game Info" option in context menus now correctly presents a detailed, paged view for game information (related to ConsoleGamesView and PagedGameMoreInfoView refactor).
  • Refined alert dialogs and confirmation prompts (e.g., when deleting ROMs).
  • Improved handling of controller inputs, including L3/R3 buttons for older controllers.

🐛 Bug Fixes

• iCloud & Sync: Early support - CloudKit broken, iCloud drive on iOS/iPad OS only.
  • Fixed numerous crashes and synchronization issues related to Realm database access during iCloud operations.
  • Resolved pathing issues where iCloud URLs could be duplicated or incorrectly formed.
  • Addressed bugs related to deleting and then re-adding the same file via iCloud.
  • Fixed issues with file management when turning iCloud sync off (e.g., removal of iCloud files).
  • Corrected handling of battery save directory names.
• Importer:
  • Fixed an index-out-of-bounds error when multiple items were removed from the import queue.
  • Addressed issues where the game importer's ROMs path could become incorrect when toggling iCloud.
• General:
  • Fixed logic for deleting multi-disc ROMs to handle all associated files.
  • Resolved potential issues with PVImageFile path validation.
  • Addressed various compilation warnings and minor code issues.

Cores

• JIT and JITless Dreamcast cores
  • Very early test release. Many known issues. Audio/Video sync speeds wrong.
  • Sonic Adventure and SA2 sometimes loads, sometimes doesn't. May depend on BIOS versions

🛠️ Other Changes

• Extensive code refactoring for clarity, reusability, and maintainability (e.g., removing unused code, DRY principles).
• Updated project files and build settings (e.g., build variables, minimum deployment target to 16.0).
• Improved localization string handling.
• Enhanced logging throughout various modules.
• Updated to use cache layers more effectively to reduce direct database hits.

---

3.1.0a1 Pre-release

Pre-Release Notes

This pre-release includes a major overhaul of iCloud synchronization, significant improvements to the game import process, and various UI/UX refinements and bug fixes.

✨ New Features & Major Enhancements

• Overhauled iCloud Synchronization (bug/ios-icloud-not-syncing branch focus):
  • Vastly improved reliability and performance of iCloud sync for ROMs, save states, BIOS files, and screenshots.
  • Smarter handling of file downloads, uploads, and conflict resolution.
  • Optimized database interactions during sync to reduce overhead and prevent crashes (e.g., using game cache, batch processing).
  • Correctly handles scenarios like initial app load with existing iCloud files, turning iCloud sync on/off, and background file changes.
  • Improved deletion handling: files deleted from iCloud are now correctly removed locally and from the database, and vice-versa.
  • Refactored sync logic into dedicated Syncer classes for better organization and lifetime management.
  • Enhanced logging and error reporting for iCloud operations.
• Game Importer Refinements:
  • Improved logic for handling multi-disc games (CUE/BIN, M3U) to ensure all associated files are correctly processed before an import is marked complete.
  • Better error handling for late-arriving files, preventing premature completion of the import queue.
  • Refactored import logic to defer processing when necessary and to correctly handle paused or busy importer states.
• UI & UX Improvements:
  • Game Info Display: The "Game Info" option in context menus now correctly presents a detailed, paged view for game information (related to ConsoleGamesView and PagedGameMoreInfoView refactor).
  • Refined alert dialogs and confirmation prompts (e.g., when deleting ROMs).
  • Improved handling of controller inputs, including L3/R3 buttons for older controllers.

🐛 Bug Fixes

• iCloud & Sync: Early support - CloudKit broken, iCloud drive on iOS/iPad OS only.
  • Fixed numerous crashes and synchronization issues related to Realm database access during iCloud operations.
  • Resolved pathing issues where iCloud URLs could be duplicated or incorrectly formed.
  • Addressed bugs related to deleting and then re-adding the same file via iCloud.
  • Fixed issues with file management when turning iCloud sync off (e.g., removal of iCloud files).
  • Corrected handling of battery save directory names.
• Importer:
  • Fixed an index-out-of-bounds error when multiple items were removed from the import queue.
  • Addressed issues where the game importer's ROMs path could become incorrect when toggling iCloud.
• General:
  • Fixed logic for deleting multi-disc ROMs to handle all associated files.
  • Resolved potential issues with PVImageFile path validation.
  • Addressed various compilation warnings and minor code issues.

Cores

• JIT and JITless Dreamcast cores
  • Very early test release. Many known issues. Audio/Video sync speeds wrong.
  • Sonic Adventure and SA2 sometimes loads, sometimes doesn't. May depend on BIOS versions

🛠️ Other Changes

• Extensive code refactoring for clarity, reusability, and maintainability (e.g., removing unused code, DRY principles).
• Updated project files and build settings (e.g., build variables, minimum deployment target to 16.0).
• Improved localization string handling.
• Enhanced logging throughout various modules.
• Updated to use cache layers more effectively to reduce direct database hits.

---

3.0.6a Mostly 3DS improvements, RA update

[3.0.6] - 2025-03-16

Special thanks to all contributors and testers who helped make this release possible.

Added

• Core Options Menu for RetroArch cores
• Enhanced search functionality with auto-hiding search bars
• Improved disc selection menu for multi-disc games
• Support for custom textures in 3DS games
• RAR archive support in file enumeration

Improved

• Major 3DS performance optimizations:
  • NEON-optimized shader interpreter
  • Enhanced Vulkan rendering pipeline
  • Audio processing improvements with NEON optimizations
  • Camera, gyro, and microphone support
  • Async presentation for smoother gameplay
• Updated Mednafen to version 1.32.1
• Improved RetroArch cores with better Vulkan support
• Enhanced continues section with optimized paging
• Threaded rendering and realtime improvements
• Fixed CPU deadlock issues

Fixed

• Fixed search functionality in Home and Console views
• Fixed tvOS build issues
• Resolved logging issues
• Fixed immediate import on conflict resolution
• Various crash fixes and stability improvements

Full Changelog: 3.0.5...3.0.6

What's Changed

• fixed ios 16 md5 hash failing; fixed bios watcher crashing by @pabloarista in #2409
• Release/3.0.6a by @JoeMatt in #2410

Full Changelog: 3.0.5...3.0.6a

3.0.5 UI/UX, performance and bugs

What's Changed

• Add custom textures to emuThree by @yippeeeyay in #2391
• Fix custom textures option 3ds (forgot to bridge to CitraWrapper.mm) by @yippeeeyay in #2398
• ROM Deletion Improvement by @pabloarista in #2399
• Update PVMetalViewController.swift - Fix Rotation misalignment. by @mrjschulte in #2400
• Update crt_filter_ps.metal to fix broken scanline check by @mrjschulte in #2401
• Update megaTron.metal by @mrjschulte in #2402
• Update PVMetalViewController.swift for megaTron Uniforms by @mrjschulte in #2403
• Update PVMetalViewController.swift - fix ulTron by @mrjschulte in #2404
• Release/3.0.5 by @JoeMatt in #2406

Full Changelog: 3.0.4...3.0.5

3.0.4 UI/UX Tweaks

Release 3.0.4: UI Improvements, Core Updates, and Preliminary Work on New Features

This release includes significant updates and improvements:

• UI Enhancements:

  • Improved game cell styling and marquee text for game titles
  • Updated settings icon and menu structure
  • Fixed media cache to prevent artwork clipping

• Core Updates:

  • Added preliminary support for Philips CD-i (WIP, not available in App Store)
  • Updated RetroArch assets and MAME plugins
  • Added NooDS core
  • Improved Dolphin core Vulkan loading
  • Added multiple test cores for Flycast (Dreamcast emulation WIP, not in App Store)

• DeltaSkins Feature (WIP):

  • Initial integration of DeltaSkins system for testing and development
  • Added preliminary skin preview and management functionality
  • Note: This feature is not yet usable and is for internal testing only

• System Improvements:

  • Enhanced core filtering for disabled and app store incompatible cores
  • Updated system settings and core project views
  • Improved handling of unsupported cores in App Store builds

• Build and CI/CD:

  • Fixed tvOS build issues
  • Updated CI/CD step versions

• Other:

  • Various bug fixes and performance improvements
  • Updated documentation and What's New for 3.0.4

This release focuses on UI polish and emulation core support, while laying the groundwork for future features like CD-i and Dreamcast support, and the DeltaSkins system. These new features are still in development and not yet available for general use.