🌹 Rose - Effortless Skin Changer for LoL

---

Overview

Rose is an open-source automatic skin changer for League of Legends that enables seamless access to all skins in the game. The application runs silently in the system tray and automatically detects skin selections during champion select, injecting the chosen skin when the game loads.

Built on the Pengu Loader framework, Rose integrates JavaScript extensions into the League Client to enable modular UI interactions. It strictly modifies local rendering variables to display custom models and textures. It is designed purely as an exploration of client-side asset management, providing no manipulation of network data, memory states, or gameplay mechanics, thereby offering zero competitive advantage.

Architecture

Rose consists of three main components:

Python Backend

• LCU API Integration: Communicates with the League Client via the League Client Update (LCU) API
• Skin Injection: Handles skin injection compatible with Riot Vanguard
• WebSocket Bridge: Operates a WebSocket server for real-time communication with frontend plugins
• Skin Management: Downloads and manages skin files from the LeagueSkins repository
• Party Mode: Enables skin sharing between friends in the same lobby via a Cloudflare WebSocket relay
• Game Monitoring: Tracks game state, champion select phases, and loadout countdowns
• Auto-Updater: Checks GitHub for new releases and prompts users to install updates
• Analytics: Sends a startup ping, a 15-minute presence heartbeat, and a best-effort close ping (configurable, runs in a background thread)

Analytics and privacy

Rose sends a pseudonymous, randomly generated installation ID and the app version to https://analytics.rosekeys.site/ when analytics are enabled. The ID is not derived from the Windows Machine GUID. Analytics can be disabled with ANALYTICS_ENABLED = False in config.py.

The analytics API and dashboard are maintained separately from this public client repository. Only aggregate usage metrics are exposed through the dashboard; raw activity and server credentials remain private.

Cloudflare Workers

• rose-party-relay: Durable Object-backed WebSocket relay that manages party rooms (max 10 members per room) for real-time skin selection broadcasting between friends

Pengu Loader Plugins

Rose includes a suite of JavaScript plugins that extend the League Client UI:

• ROSE-UI: Unlocks locked skin previews in champion select, enabling hover interactions on all skins
• ROSE-SkinMonitor: Monitors currently selected skin's name and sends it to the Python backend via WebSocket
• ROSE-CustomWheel: Displays custom mod metadata for hovered skins and exposes quick access to the mods folder
• ROSE-ChromaWheel: Enhanced chroma selection interface for choosing any chroma variant
• ROSE-FormsWheel: Custom form selection interface for skins with multiple forms (Elementalist Lux, Sahn Uzal Mordekaiser, Spirit Blossom Morgana, Radiant Sett)
• ROSE-SettingsPanel: Settings panel accessible from the League of Legends Client
• ROSE-RandomSkin: Random skin selection feature
• ROSE-HistoricMode: Access to the last used skin for every champion
• ROSE-PartyMode: Party mode UI — displays a panel in lobby and champion select to enable skin sharing, view connected peers, and see friends' skin selections in real time
• ROSE-Jade: Client customization — regalia borders, backgrounds, banners, icons, titles, and win/loss stats

How It Works

1. League Client Integration: Rose activates Pengu Loader on startup, which injects the JavaScript plugins into the League Client
2. Skin Detection: When you hover over a skin in champion select, ROSE-SkinMonitor detects the selection and sends it to the Python backend
3. Game Opening Delay: To make sure the injection has time to occur we suspend League of Legend's game process as long as the overlay is not ran
4. Game Injection: Rose injects the selected skin when the game starts
5. Seamless Experience: The skin loads as if you owned it, with full chroma support and no gameplay impact (Rose will never provide any competitive advantage to its users)

Features

• Smart Injection: Never injects skins you already own
• Multi-Language Support: Works with any client language
• Open Source: Fully open source and extensible
• Free: If you bought this software, you got scammed 💀

Requirements

• Windows 10/11
• League of Legends installed
• Injection DLL - You must provide your own signed DLL (see below)

DLL Requirement

Due to DMCA restrictions, Rose cannot distribute the injection DLL file. You must obtain this file yourself from an authorized source and sign it with your own code signing certificate.

On first launch, Rose will prompt you to provide this file and open the folder where it should be placed.

Installation

1. Download the latest installer from Releases
2. Run the installer as Administrator
3. Launch Rose from the Start Menu or desktop shortcut

Building from source

Rose builds the Pengu Loader executable from the vendored source in vendor/PenguLoader-1.1.6/ as part of the normal Rose build. You do not need to download or commit a prebuilt Pengu Loader.exe.

Prerequisites

• Windows 10/11
• Python 3.11 or newer
• Visual Studio Build Tools with the .NET desktop build tools, WPF support, and the .NET Framework 4.7.2 targeting pack
• Inno Setup 6 if you also want to create the installer

Clone the repository and enter its directory:

git clone https://github.com/Alban1911/Rose.git
cd Rose

Install the Python dependencies first:

python -m pip install -r requirements.txt

Build the loader by itself, if needed:

python scripts/build_pengu_loader.py

Build Rose and automatically rebuild the loader:

python scripts/build_pyinstaller.py

The packaged application is written to dist/Rose/. To build both Rose and the Windows installer in one step:

python scripts/build_all.py

The installer is written to installer/Rose_Setup.exe. Use scripts/build_pyinstaller.py or scripts/build_all.py instead of invoking pyinstaller Rose.spec directly, because the Rose build scripts compile Pengu Loader first.

Credits

Rose uses the official Pengu Loader project. Its source is vendored and built as part of Rose, with Rose-specific lifecycle integration added around the loader. Please see the official Pengu Loader license and credit the Pengu Loader contributors.

Contributing

See CONTRIBUTING.md for development setup and project structure.

Legal Disclaimer

This project is not endorsed by or affiliated with Riot Games. Riot Games and all related properties are trademarks or registered trademarks of Riot Games, Inc.

Custom skins are allowed under Riot's terms of service and are not detected. Do not discuss or advertise skin tools in game. Users proceed at their own risk.

Support

If you enjoy Rose and want to support its development:

Your support helps keep the project alive and motivates continued development!

---

Rose - League, unlocked.