f4fb602bc4
Implement a storage location picker for Android that allows users to choose where Citron stores game data, saves, and other files instead of being locked to the default app-specific directory. Features: - Storage location selection during first-time setup - Settings option to change storage location after initial setup - Support for internal storage, external SD card, and custom locations - Automatic data migration when changing storage locations - Progress dialog with cancellation support during migration - Proper app restart handling to apply new storage path - Detailed logging for debugging storage initialization The picker offers three main options: 1. Internal Storage (Default) - App-specific directory, removed on uninstall 2. External SD Card - Persistent storage with more space (if available) 3. Custom Location - User-selected folder via Storage Access Framework When switching locations, all existing data (saves, keys, config, shaders) is automatically copied to the new location, ensuring a seamless transition. This addresses user requests to store data in more accessible locations like SD cards or Downloads folders, especially useful for devices with limited internal storage or for easier data backup. Signed-off-by: Zephyron <zephyron@citron-emu.org>
Citron - Nintendo Homebrew Emulator 🍋
Welcome to Citron, a cutting-edge Nintendo Homebrew emulator designed to deliver an optimized experience for playing your favorite games and exploring new ones. Citron is a high-performance and easy-to-use emulator, tailored for enthusiasts and developers alike.
Disclaimer: Citron is intended strictly for legal homebrew use and is not affiliated with or endorsed by Nintendo. Use of Citron for pirated or unauthorized copies of games is strictly prohibited. Please respect game developers and support them by purchasing legitimate copies of their games.
Features 🛠️
- High Performance: Optimized for speed and smooth gameplay.
- User-Friendly: Clean and intuitive interface.
- Cross-Platform: Available on multiple platforms.
- Homebrew Support: Fully supports legal homebrew games and applications.
- Ongoing Development: Stay tuned for frequent updates as Citron evolves!
Download 🚀
Ready to experience Citron? Download the latest version and dive into your favorite Nintendo homebrew titles!
Getting Started 💡
- Check the System Requirements: Head over to this link to check the requirements to run this emulator system requirements page
- Download and Install: Head over to the downloads page to grab the latest release.
- Add Homebrew Games: Citron is built to play homebrew games. Add them to your game directory and enjoy!
- Configure Your Settings: Customize your emulator settings to suit your performance needs.
Source Code 🔧
Citron is an open-source project. You can find the source code on our official Git repository:
We welcome contributions! Check out the repository and feel free to submit issues or pull requests to help improve Citron.
Legal Disclaimer 📜
Citron is a homebrew emulator designed to support legally created and distributed homebrew software. It does not support piracy, nor is it intended for illegal purposes. Using Citron to play pirated copies of games is a violation of copyright law. Citron is not affiliated with or endorsed by Nintendo, and all Nintendo trademarks and copyrights are the property of their respective owners.
We highly encourage users to respect intellectual property rights and to only use Citron with legal, homebrew content.
License 📄
Citron is licensed under the GPL License. See the full license in the LICENSE file for more details.
Contributing ✨
We are always looking for developers, testers, and enthusiasts to contribute to Citron. Whether you want to submit a pull request, report an issue, or suggest new features, all contributions are welcome. Please follow our contributing guidelines to get started.
Contact Us 📬
For any inquiries or to follow Citron's development journey, reach out to us:
- Official Website: https://citron-emu.org
- Source Code: https://git.citron-emu.org
- Twitter: @CitronEmu
Made with 💚 by Zephyron | Source Code