Skip to content

sabiledine/uma-widget

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Uma Widget & Scanner

A widget to keep track of your tp your rp and your carats on umamusume from your phone, but it's a bit more complex then you think.

Uma Widget Ecosystem Preview

🚀 Downloads (For Trainers)

If you want to install the tools, please navigate to the Releases section of this repository.

  • Android Package (.apk): Install on your smartphone to access the home screen widgets.
  • PC Scanner (.exe/.zip): Run alongside your game to capture and sync TP/RP data.

📖 Usage Guide

1. Setup the PC Scanner

Unzip the scanner launch the uma-widget-scanner.exe and create your account.

login interface

IF YOU ALREADY HAVE AN ACCOUNT : 1. Just create a new account but don't scan, 2. Go in the user_config.txt file or create a new one than put your username-pincode it should look something like this.

how to login if u already have an account

Launch the PC Scanner while your game is running to fetch your data.

Scanner Console Interface

The scanner runs quietly in the background. You can find it in your system tray (the small arrow at the bottom right of your Windows taskbar).

App in Windows Taskbar

Right-click the tray icon to enable Start with Windows for automatic syncing every time you turn on your PC!

Start with Windows context menu

2. Add the Android Widgets

Add the Large or Small widget to your Android Home Screen via your phone's standard widget menu to keep an eye on your stats.

Android Widgets Preview

3. Connect your Account

Open the Uma Widget Android App and input your Trainer credentials (Username & PIN) to link your phone with the PC scanner.

Player Configuration Interface

4. Customize and Sync

Personalize your widget! Add a custom background URL, choose the vertical alignment, and toggle text colors to match your style.

Customization Menu

Once everything is set, hit the Save & Sync button to update your widgets instantly.

Save and Sync Button

5. More

If you want to check a widget online i created the website linked to that repository do not hesitate, for any question or problem contact me on discord : x.event, else if you want to support me just follow me on social medias


💻 Source Code Architecture

This repository is a monorepo containing all components of the Uma Widget project:

Directory Description
uma-widget-src-android/ Android native source code (Kotlin). Contains the UI, background processing, and widget logic.
uma-widget-src-scanner/ PC data capture tool source code. made with python using notably ddddocr-rs
uma-widget/ Web components, JS calculations, and Netlify deployment configs.

The database i used is firebase i store informations based on the users each users has it's information, tp/rp timers,bg_url, etc....

if you need more precise information reach me out on discord x.event, and for transparency i made usage of ai to document myself faster on kotlin i can't tell if it's good or not and i hate a bit this tool since i'm a beginner and it only makes me feel bad as a developer to see it search things way better than i do, and i hate ai a bit but i also used it for the readme strucure too.

⚖️ License & Disclaimer

This is a fan-made tool and is not affiliated with Cygames. Use responsibly at your own risk.