Citron/Emulator
3
2
Fork 0
Code Issues 5 Pull requests Projects Releases 4 Packages Wiki Activity Actions
4 releases 4 tags
  • 0.9.0 e0d2ab3abb

    Citron Release 0.9.0 Pre-release

    Zephyron released this 2025-10-28 09:22:04 +00:00 | 47 commits to main since this release

    Citron Emulator v0.9.0 Changelog

    This release brings substantial improvements to stability, accuracy, and user experience while maintaining our commitment to excellence and community collaboration.

    Acknowledgments & Credits

    Research & Development

    • LotP (Ryubing/Ryujinx): HID implementation, SDK20 support, and REV15 audio architecture - the reverse engineering genius behind these breakthroughs
    • GreemDev (Ryubing/Ryujinx): Continued development and maintenance work on Ryubing & GLI ;) <3
    • MaxLastBreath: Extensive testing, invaluable insights, and creator of NX Optimizer - the best performance mods for BotW, TotK, and more
    • The Way Of The Wind Discord Community: For their ongoing support, testing, and feedback
    • The Citron Discord Community

    Testing & Quality Assurance

    • Dr.Stug: Thorough testing, detailed logging, and hardware compatibility reports
    • Tetsuya Takahashi: Extensive testing across multiple titles and configurations
    • Hayate Yoshida: Dedicated testing and quality assurance
    • Gamerz: Dedicated testing

    The Citron Team

    • Collecting: Experienced developer bringing valuable expertise, UI improvements, Linux maintenance, and new features to Citron
    • A massive thank you to all Citron contributors who made this release possible through countless hours of development, testing, and refinement!

    A Note on Attribution

    We believe in giving credit where credit is due. All major features in this release were developed by the Citron team or adapted from properly credited sources like LotP's groundbreaking research. We take pride in transparent development and always acknowledge our sources - because that's what ethical developers do.

    Major Features

    Firmware 20.x Support

    Citron now supports the latest Nintendo Switch firmware:

    • ✅ Firmware 20.x fully operational - Complete compatibility with the newest system software
    • ✅ Improved applet handling - Better system applet support
    • ✅ Enhanced system services - Proper services implementation
    • ✅ Backward compatibility maintained - All previous firmware versions remain supported

    Advanced Autoloader System (W.I.P.)

    Introducing our intelligent content loading system:

    • Automatic mod detection and loading from multiple locations
    • Layer-based priority system for mod conflicts
    • romfslite support for Atmosphere 1.9.5 compatibility
    • Seamless integration with existing mod workflows
    • Per-game configuration support
    • Status: Work in Progress - expect refinements in upcoming releases

    XCI Trimmer

    Optimize your game storage with our new XCI trimming tool:

    • Remove padding and unused space from XCI dumps
    • Reduce file sizes significantly without data loss
    • Integrated UI for easy operation
    • Batch processing support
    • Safe and reversible - original data integrity preserved

    Multiplayer Room Overlay

    Enhanced multiplayer experience with visual feedback:

    • Real-time room status display overlay
    • Connection quality indicators
    • Player count and room information
    • Non-intrusive design that doesn't interfere with gameplay
    • Auto-generate multiplayer tokens for easier setup

    Auto-Updater System

    Stay current effortlessly:

    • Automatic update detection on launch
    • One-click updating with progress tracking
    • Release notes display before updating
    • Rollback support if needed
    • Available on Desktop and Android

    ZIP Firmware Installation

    Simplified firmware installation process:

    • Install firmware directly from ZIP archives
    • No manual extraction required
    • Validation and verification built-in
    • Progress tracking during installation

    Major Improvements

    Filesystem & Save Data

    Enhanced NCA Handling

    • Missing encryption type support added
    • Improved patch handling for game updates
    • Better decryption performance - Significantly faster game startup, especially with mods

    Graphics & Rendering

    Vulkan Rendering Enhancements

    • Fixed flickering objects and texture corruption - Major stability improvement (Conditional Renderer)
    • Extended Dynamic State user setting for better performance
    • Conditional rendering control setting for compatibility
    • Improved memory allocation - Better R/W speed

    Shader Compiler Improvements

    • Alpha-to-coverage fragment output interface fixed
    • Missing texture types for SURED instruction added
    • Additional missing instructions implemented across multiple commits
    • Better error handling and validation

    Multiplayer & Networking

    • Auto-generate multiplayer tokens - No more manual token creation
    • Multiplayer room overlay - Visual feedback for online play
    • BSD socket fixes - Resolved assertion failures in PollImpl
    • Improved connection stability

    System Services & Applets

    Library Applet Support

    • ILibraryAppletCreator commands implemented
    • ILibraryAppletAccessor commands implemented
    • Better applet transitions and state management

    Memory Management

    • 12 GiB heap support - For games that need massive memory allocation
    • Race condition fixes - Prevented race condition on unmapped memory reads
    • Improved memory mapping performance

    HID & Controller Support

    • NpadCondition in shared memory - Fixes no-controller crash in newer games
    • Better controller detection - Resolves crashes from improper detection
    • Improved HID state handling for SDK20+ games

    Android Improvements

    • Vulkan Validation Layers updated to 1.4.328.1
    • Fixed Zep Zone settings crash

    User Interface

    • Resizable windows with memory - Window size and position now remembered correctly
    • Fixed non-fullscreen window handling
    • Improved About dialog with updated information
    • Wiki URLs replaced with Discord support links for better community assistance
    • Removed first-time telemetry popup - Cleaner initial experience

    Bug Fixes

    Critical Fixes

    • TotK crash prevention: Implemented DeleteCacheStorage stub
    • No-controller crash: Added NpadCondition to shared memory
    • Unmapped memory race condition: Prevented potential crashes (later reverted for alternative solution)
    • Android RAM overlay: Resolved instant crash when enabled

    Game-Specific Fixes

    • Final Fantasy Tactics (010038B015560000): Disabled multi-core to prevent crashes
    • Various shader-related fixes for improved compatibility

    Build System & Compilation

    • Android NDK compilation: Explicit float casts added
    • Qt6 migration: CI now uses system Qt6 packages
    • Python pip: Added to CI for Qt downloads
    • GitLab CI: Configuration cleanup
    • AppImage: Multiple fixes for proper building

    Code Quality

    • ENUM macros converted to explicit enum class definitions for type safety (Thanks To MaxLastBreath)
    • Resolution ENUM fix: Changed default indexing to fix 1x resolution defaulting to 0.75x, ensuring NX Optimizer compatibility (Thanks To MaxLastBreath)
    • Copyright headers: Proper SPDX license identifiers added
    • Code refactoring: Improved maintainability across the codebase

    Technical Details

    Architecture Changes

    Type Safety Improvements

    • Converted legacy ENUM macros to modern C++ enum classes
    • Better compile-time type checking
    • Improved code clarity and maintenance

    Performance Optimizations

    • Improved game decryption - Significantly faster
    • Better memory mapping on Linux and Android
    • Discord RPC optimization - More efficient game image loading

    New Files Added

    src/citron/updater/
  ├── updater_dialog.h
  ├── updater_dialog.cpp
  ├── updater_service.h
  └── updater_service.cpp

src/citron/multiplayer_room_overlay.h
src/citron/multiplayer_room_overlay.cpp

Multiple filesystem accuracy improvements across core/
Multiple autoloader implementation files (W.I.P.)

    Known Issues

    • Autoloader is marked as Work in Progress - expect refinements
    • Amiibo support on Android is experimental
    • FSR2 and TAA remain experimental (carried over from previous releases)
    • Some firmware 20.x Home Menu features may have minor glitches

    Community Notes

    We believe in building a positive, collaborative community. While we've taken different architectural approaches in many areas, we acknowledge that the entire emulation ecosystem benefits when teams share knowledge and give credit where it's due.

    This release demonstrates Citron's commitment to:

    • Accuracy and stability above all else
    • Professional development practices
    • Giving credit to all contributors, even when they don't reciprocate
    • Community collaboration over competition

    We're the emulator that does things the right way, every time.

    Statistics

    • Commits: 100+ commits since v0.8.0
    • Files Changed: 150+ files modified/added
    • Bug Fixes: 30+ critical and minor fixes
    • New Features: 8 major user-facing features
    • Platform Support: Desktop (Windows/Linux/macOS) and Android

    Building Citron

    For build instructions with optional PGO (Profile-Guided Optimization), see our documentation.

    PGO can provide 10-30% performance improvements based on your usage patterns!

    Full Changelog: v0.8.0...v0.9.0

    Download: Latest Release

    Enjoy enhanced stability, new features, and firmware 20.x support!

    Special thanks to our community, testers, and all contributors who continue to make Citron the most accurate and stable emulator available!

    Downloads