Mukkuru

---

Cross-Platform customizable game launcher written in Python, optimized for GamePads.

Important

Mukkuru is still at early stages; some features might have bugs and/or security flaws, use at your own discretion.

License

Mukkuru is licensed under MIT
See third-party.md for third-party files license terms.

Current features

• Linux, Windows and MacOS Support
  
• 3 Built-in themes similar to popular consoles
  
• Under 30mb executable
  
• Import custom user themes
  
• Import custom ui sound effects
  
• Dark mode and light mode
  
• Support fetching game library from:
  
  • Steam launcher
    
  • (Linux) Heroic launcher
    
  • (Windows) Epic Games Launcher
    
  • (MacOS) Steam launcher under Crossover
    
  • (MacOS) Epic Games Launcher under CrossOver
    
• Skip duplicated games
  
• Update to latest version from app settings
  
• WebUI to transfer files from another device
  
• Video playback and take video screenshots with a single button
  
• Automatically download boxarts from SteamGridDB
  
• Multi-language (currently only English and Spanish)
  
• Strict static analysis compliance
  
• Plug and play compile environment
  

Release scope

Release static builds with priority support:

• Windows x86_64
  
• Linux x86_64
  
• MacOS ARM64
  Architectures not listed might need to run the source code directly and might require modifications.
  Some others are going to receive occasional uploads
  

Changelog

Read changelog.md

To-do list

• Add button to transfer mukkuru media to user folders
  
• Add button to delete all video thumbnails
  
• Add support for non-flatpak Heroic and MacOS Heroic
  
• More webui features:
  
  • Videoplayback control
    
  • Play Mukkuru videos from webui
    
  • Wallpaper change
    
  • Menu to organize games, mark as favorite, blacklist, etc
    
  • Upload game boxart
    
  • Option to setup SteamGridDB api
    
  • Must also support plugins
    
  • (Optional) chunk checksum validation to prevent file corruption in upload
    
• Game provider install helper (Steam, Heroic, etc)
  
• Add joystick buttons customization
  
• Add ability to download games
  
• Implement SQLite instead of JSON
  
• Support for linux box86 in arm64
  
• Add support for freebsd
  

Contribution guidelines

• Linting Use pylint and remove as many warnings as reasonably possible before submitting your code.
  
• Nuitka Compatibility Ensure your changes do not break Nuitka compilation as some users rely in static builds.
  
• Dependencies Avoid introducing new dependencies unless absolutely necessary.
  
• Licensing Do not include GPL, LGPL or any other restrictive licensed code.
  
• Cross-Platform Code Avoid using platform-specific code outside its target (ex: running MacOS code without a Darwin platform check).
  

Donations

---

Donations could help me spending more time in these projects
USDT TRC20: TNkFKTZocgB7DssLa3c8SfqqAEGB2hpj8j
BTC: 19eWbB2YCUxfX2mLAkwWrPnMGLU42Jwabo