Skip to content

Pedrohs1771/Luma-Tools

Repository files navigation

🇧🇷 Leia em Português

LumaTools Logo

LumaTools

Windows Linux Python Status

The ultimate Swiss Army knife for game management and Steam compatibility.
Developed by Pedrohs.


🚀 What is LumaTools?

LumaTools is a cross-platform launcher and library manager designed to give you total control over your Steam games. It automates complex processes such as downloading depots, applying compatibility patches, and emulating online features, ensuring a seamless gaming experience whether you are on Linux (Arch, SteamOS, Ubuntu) or Windows (10/11).

🌟 Elite Features

  • ⚡ Native Steam Engine: Deep integration with native Steam for library detection, manifests, and file management.
  • 🌐 Online-Compatible Core: Built-in engine to automatically enable multiplayer and cooperative features.
  • 📦 Smart Depot Management: Intelligent system to download and manage specific depots, optimizing disk space.
  • 🛠️ Zero-Config Goldberg Integration: Automated application of the Goldberg Steam Emulator with steam_appid.txt generation and DLL injection.
  • 🔓 Steamless Auto-Unpack: Automatic unpacking of SteamStub-protected executables for maximum performance.
  • 🎮 Cross-Platform Mastery: Unified logic that adapts the app's behavior to the specific needs of each OS (Proton on Linux / Native on Windows).
  • 🏆 Achievement Generator: System for generating and managing achievements for your personal library.

📥 Quick Installation (One-Liner)

Windows (PowerShell)

Open PowerShell and paste this one-liner. It downloads the full Windows beta package first, then runs the local Windows installer:

powershell -NoProfile -ExecutionPolicy Bypass -Command "$ErrorActionPreference='Stop'; $base=Join-Path $env:USERPROFILE 'Downloads\LumaTools-Windows-Install'; Remove-Item $base -Recurse -Force -ErrorAction SilentlyContinue; New-Item -ItemType Directory -Force $base | Out-Null; Set-Location $base; Invoke-WebRequest -Uri 'https://github.com/Pedrohs1771/Luma-Tools/releases/download/v1.0.7-windows-beta1/LumaTools-Windows-v1.0.7-beta1.zip' -OutFile 'LumaTools-Windows-v1.0.7-beta1.zip'; Expand-Archive -Force 'LumaTools-Windows-v1.0.7-beta1.zip' .; $installer=Get-ChildItem -Path . -Recurse -Filter install_windows.ps1 | Select-Object -First 1; if (-not $installer) { throw 'install_windows.ps1 not found in package' }; Set-Location $installer.DirectoryName; powershell -NoProfile -ExecutionPolicy Bypass -File $installer.FullName"

Linux / Steam Deck (Terminal)

Open your favorite terminal and paste this one-liner. It always resolves the latest Linux release from GitHub Releases, installs/updates LumaTools, and runs the repair pass for managed Steam appmanifests and SLSsteam entries:

curl -fsSL https://raw.githubusercontent.com/Pedrohs1771/Luma-Tools/main/bootstrap.sh | bash -s -- --fix-all

Alternative using wget:

wget -qO- https://raw.githubusercontent.com/Pedrohs1771/Luma-Tools/main/bootstrap.sh | bash -s -- --fix-all

Manual fallback using git:

git clone --depth=1 https://github.com/Pedrohs1771/Luma-Tools.git
cd Luma-Tools
bash install.sh --no-prompt

Repair an existing installation:

lumatools --fix-all

Release Assets

Linux stable:

Always fetched automatically by bootstrap.sh from the latest GitHub release.

Windows beta:

LumaTools-Windows-v1.0.7-beta1.zip
LumaTools-Windows-Port-Complete-v1.0.7-beta1.zip

🧠 Project Structure

LumaTools/
├── app/LumaTools/          # Core application (Python + Resources)
├── windows/                # Windows-specific binaries and launchers
├── tools/                  # Build and automation scripts
├── install.sh              # Intelligent Linux installer
├── install_windows.ps1     # Intelligent Windows installer
└── lumatools               # Global command for Linux

🤝 Special Thanks

This project would not be possible without the solid foundation and inspiration from previous open-source projects. Special thanks to the ACCELA project for providing the base that allowed LumaTools to evolve.


🛠️ How to Build (Windows)

If you are a developer and want to generate your own build:

  1. Have Python 3.10+ installed.
  2. Run the build script:
    python tools/build_windows.py
  3. The final package will be available in the dist/ folder.

Created with ❤️ by Pedrohs

About

is a cross-platform launcher and library manager designed to give you total control over your Steam games. It automates complex processes such as downloading depots, applying compatibility patches, and emulating online features

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages