SUMEE! Lite

Description

SUMEE (Lite) ⚠️ Important Update: This repository is a refactored Lite fork of my original SUMEE! codebase. The work focused on reducing project size, splitting large files into smaller modules, and improving maintainability. English ↔ Spanish translation tasks were also streamlined in this version. SUMEE is a highly stylized, nostalgic iOS launcher and frontend inspired by the PS Vita interface and the Frutiger Aero design language. Project Context (Important) This repository is a refactored Lite fork of the original SUMEE! project, based on my own original codebase. To build SUMEE Lite, I used AI as a development assistant to help reduce and reorganize parts of the original SUMEE! codebase into a smaller, more modular structure. Main goal of this fork: - Make SUMEE! smaller and easier to maintain. - Split large files/features into smaller, modular components. - Keep behavior and design identity while improving readability and iteration speed. About development workflow: - Core architecture, app logic, and project direction are authored manually. - Refactoring focused on decomposition into reusable pieces (views, managers, and feature modules). - English ↔ Spanish translation tasks were also made easier during this refactor process. AI Usage in the Codebase AI tools were used as targeted support to speed up refactoring, cleanup, and writing tasks. However, the project design, core architecture, and technical decisions behind SUMEE! Lite are original work and are maintained manually. It transforms your iOS navigation experience with 3D bubble icons, "LiveArea" style app pages, floating cartridges, and a fully functional system interface including Music, Photos, and Game integrations. Join our Discord Features Vita-Style Home Screen: Vertical scrolling pages with 3D, physics-based bubble icons. "Wobble" edit mode and drag-and-drop organization. LiveArea Interface: Launch apps into a "LiveArea" gate before entering. Peel-to-Close: Use the signature "peel" gesture (top-right corner) to close apps and games. Includes haptic feedback! System Apps: Music Player: Floating mini-player and full-screen visualization. Photos: Integrated gallery viewer. Settings: Comprehensive customization (Lite Mode, Performance Mode, Custom Themes). Emulation Frontend: Built-in support for launching and managing ROMs (requires appropriate backend/core setup). Aesthetics: Frutiger Aero gloss and depth. Dynamic backgrounds and floating particle effects. Custom "Lite Mode" for older devices to ensure smooth 60fps performance. Prerequisites macOS with the latest version of Xcode (15.0+ recommended). iOS Device matching the deployment target (iOS 15.0+). Apple ID (for signing). Getting Started 1. Clone the Repository bash git clone https://github.com/getzemani63/sumee-lite.git cd sumee-lite 2. Open in Xcode Double-click on SUMEE!.xcodeproj to open the project. 3. Configure Signing Click on the SUMEE project icon in the top-left project navigator. Select the SUMEE target under "Targets". Go to the Signing & Capabilities tab. Select your Team from the dropdown menu. Ensure the Bundle Identifier is unique (e.g., change com.sumee.app to com.yourname.sumee) if you don't have access to the original team profile. 4. Run the App Connect your iOS device via USB. Select your device from the generic device list in the top toolbar. Press Cmd + R or click the Play button to build and run. Note: If running on a physical device for the first time, you may need to trust your developer profile in Settings > General > VPN & Device Management on your iPhone/iPad. Building an IPA (For Sideloading) To verify the app or share it (e.g., via AltStore, SideStore, or TrollStore), you need to export an .ipa file. Select "Any iOS Device (arm64)": In the device selector (top toolbar), choose Any iOS Device (arm64) instead of a specific connected phone. Archive: Go to Product > Archive in the menu bar. Xcode will build the project. This may take a few minutes. Distribute App: Once the Organizer window appears with your archive selected, click Distribute App. Select Custom (or Ad Hoc / Development depending on your Xcode version options). Choose App Thinning: None (to make it compatible with all devices) or select your specific model. Signing: Select Automatically manage signing or manually select your profile. Export: Choose a destination folder on your Mac. Xcode will generate a folder containing SUMEE.ipa. You can now sideload this SUMEE.ipa using tools like AltServer or SideStore. Contributing Contributions are welcome. Please read CONTRIBUTING.md before opening a Pull Request. Acknowledgements See ACKNOWLEDGEMENTS.md. License This project is licensed under CC BY-NC-SA 4.0. See LICENSE. Emulator Licenses This project uses the following Libretro cores for emulation. Each core is subject to its own license: NES: FCEUmm (GPL v2) SNES: Snes9x (Non-commercial) GBA: mGBA (MPL 2.0) DS: melonDS (GPL v3) PSX: PCSX ReARMed (GPL v2) Genesis/Mega Drive: PicoDrive (MAME / GPL v2)

What's New

This release introduces major aesthetic upgrades with video background support, significantly improves theme management, and polishes the gamepad experience. New Features Video Backgrounds: You can now use .mp4 files as custom backgrounds! The theme system now supports importing and displaying video loops. Persistent Theme Library: Imported themes are now saved permanently in a dedicated Documents/Themes folder. They will remain available even after restarting the app. Theme Manager Upgrade: Instant Loading: Optimized the theme list to load instantly without lag. Visual Separator: Imported themes are now clearly separated from default system themes. Original Filenames: Imported themes now keep their original filenames (e.g., MyCoolTheme.json) instead of being renamed to timestamps. Improvements & Fixes Gamepad Launch Animation: Fixed a visual glitch where launching a game with the controller ("A" button) didn't use the correct animation coordinates. It now perfectly matches the touch interaction. DS Audio Fix: Resolved audio stuttering issues when resuming DS games. BIOS Selection: Fixed issues with BIOS file selection stability.

Details