Skip to content

HoyoUMU is a application built in rust that downloads and sets up HoYoPlay using UMU and Proton-GE automatically — no manual tinkering required.

License

Notifications You must be signed in to change notification settings

HaruNashii/HoyoUMU

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎮 HoyoUMU

HoyoUMU is a application built in rust that downloads and sets up HoYoPlay using UMU and Proton-GE automatically — no manual tinkering required.




📸 Showcase

image
Others Pages
  • uninstall page
image
  • proton-ge updated
image
  • everything downloaded
image

there is much more, download the app and check it out <3




🧪 Games Tested

  • ✅ Genshin Impact (Runned Without Any Flaws)
  • ✅ Zenless Zone Zero (Runned Without Any Flaws)
  • ❌ Honkai Star Rail (Currently Borked/Not Working)
  • ❌ Honkai Impact 3rd (Currently Borked Because of anti-cheat)



🧰 What This Script Does

✅ Installs the latest version of Proton-GE
✅ Downloads the latest version of HoYoPlay
✅ Fetches and installs the official HoYoPlay icon
✅ Creates a working .desktop launcher for easy access
✅ Configures UMU with my personal hoyoumu.py setup to guarantee an smooth adventure
✅ Update Proton-GE to the latest version anytime
✅ Completely uninstall without remaining any traces
✅ Optionally runs all your games with Feral Gamemode for a very smooth experience




📦 Dependencies - Normal/Gui Version

Dependency Description Default Availability
UMU UMU is a unified launcher for Windows games on Linux Must be installed manually
SDL3 Simple DirectMedia Layer Must be installed manually
SDL3 TTF Support for TrueType (.ttf) font files Must be installed manually
SDL3 IMAGE Image decoding for many popular format. Must be installed manually
Gamemode [OPTIONAL] Optimise Linux system performance on demand Must be installed manually
Cantarell [OPTIONAL] An very modern and sleek font used by default on GNOME Must be installed manually

📟 Dependencies - Bash/Shell Script Version

Dependency Description Default Availability
UMU UMU is a unified launcher for Windows games on Linux Must be installed manually
Gamemode [OPTIONAL] Optimise Linux system performance on demand Must be installed manually
curl Fetches downloads Pre-installed on most Linux distros
tar Extracts Proton-GE archives Pre-installed on most Linux distros



🚀 Installation

  1. Download the Latest Version In The Releases Page
  2. Give It Permission To Run With: chmod a+x rwx /path/to/application" (Replace "/path/to/application", with the application location, probabily like: /home/username/Downloads/application_here)
  3. Run The App And Enjoy :).

or if your prefer download with just one command, you can just run the following commands to download HoyoUMU as an bash script:

git clone --branch script_version --single-branch https://github.com/HaruNashii/HoyoUMU.git && cd HoyoUMU && chmod a+x install.sh && ./install.sh



📁 Installation Paths

Component Path
HoYoPlay Icon ~/.config/hoyoplay-umu/assets/hoyoplay_icon.png
HoYoPlay Games ~/.config/hoyoplay-umu/wine_prefix/drive_c/Program Files/HoYoPlay/games/
HoYoPlay Executable ~/.config/hoyoplay-umu/wine_prefix/drive_c/Program Files/HoYoPlay/launcher.exe
HoYoPlay Installer ~/.config/hoyoplay-umu/Hoyoplay_setup.exe
Proton-GE Build ~/.config/hoyoplay-umu/ProtonLatest
UMU Config File ~/.config/hoyoplay-umu/umu_config/umu_config.toml
Desktop Shortcut ~/.local/share/applications/Hoyoplay.desktop



👾 known Issues

  • White bars in the border of the launcher
  • Launcher flickering black some times
  • Tray options not working when the app is open



🙌 Credits




💡 Tip

After installation, you can find HoYoPlay directly in your app launcher — ready to start your next adventure!




🤝 Contributions

My wife, helped me with emotional support


About

HoyoUMU is a application built in rust that downloads and sets up HoYoPlay using UMU and Proton-GE automatically — no manual tinkering required.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published