Graph Launcher

Graph Launcher is a Windows desktop application for managing FiveM / GTA V graphic packs. It provides a modern dark UI to install, uninstall, clean, and download community packs — without touching any game system files.

---

Features

• Pack Manager — Scan a local folder, install/uninstall packs into FiveM or GTA V with one click
• Workshop — Browse and download community graphic packs directly in the app (.zip and .rar supported)
• Video Preview — Watch YouTube previews of packs inside the app (via yt-dlp, HD quality)
• FiveM Cleaner — Remove mods, plugins, ReShade and pack files from FiveM Application Data
• GTA V Cleaner — Remove mod files from GTA V while protecting official files via SHA256 baseline
• Baseline Protection — Index all official GTA V files (SHA256) so the cleaner never deletes them
• Auto-update — Notified on startup when a new version is available on GitHub Releases
• Bilingual — Full French and English interface (auto-detected from system locale)

---

Requirements

Requirement	Details
Windows 10/11	64-bit
Microsoft Edge WebView2 Runtime	Included in Windows 11. Download for Windows 10.
Python 3.11+	Only for running from source

To extract .rar packs from the Workshop, one of the following must be installed:

• 7-Zip (recommended, free)
• WinRAR

---

Installation (end users)

Download the latest installer from the Releases page and run it.

---

Running from source

# Clone the repository
git clone https://github.com/GraphDevelopment/GraphLauncher.git
cd GraphLauncher

# Install dependencies
pip install -r requirements.txt

# Run
python main.py

# Run with DevTools open
python main.py --debug

---

Build standalone .exe

pip install pyinstaller
python build.py

Output: dist/FiveM_Graph_Launcher.exe

Then compile installer.iss with Inno Setup 6 to generate the installer.

---

Project structure

├── main.py                   # Entry point — starts HTTP server + pywebview window
├── backend/
│   └── api.py                # Python ↔ JavaScript bridge (all pywebview.api.* calls)
├── core/
│   ├── pack_manager.py       # Scan, install, uninstall packs
│   ├── cleaner.py            # FiveM / GTA V cleanup logic
│   ├── backup.py             # Automatic backups before installs
│   └── baseline.py           # SHA256 index for GTA V file protection
├── services/
│   ├── workshop_service.py   # Workshop fetch + download/extract (.zip, .rar)
│   ├── update_service.py     # GitHub Releases version check
│   ├── file_service.py       # Safe file operations
│   ├── validation_service.py # FiveM / GTA V path validation
│   └── hash_service.py       # SHA256 hashing utilities
├── database/
│   └── db_manager.py         # SQLite — settings, install history, logs
├── utils/
│   ├── logger.py
│   └── paths.py              # Frozen/dev path resolution
├── frontend/
│   ├── index.html
│   ├── css/
│   │   ├── base.css
│   │   └── components.css
│   └── js/
│       ├── app.js            # Main UI logic
│       ├── api.js            # JS wrappers for pywebview.api
│       └── i18n.js           # Embedded FR/EN translations
├── build.py                  # PyInstaller build script
├── installer.iss             # Inno Setup installer script
└── workshop.json             # Community pack catalogue (hosted on this repo)

---

Pack installation mapping

Each subfolder inside a pack is routed to its destination based on its name (case-insensitive):

Pack subfolder	Destination
mods/	FiveM Application Data/mods/
plugins/	FiveM Application Data/plugins/
citizen/	FiveM Application Data/citizen/
fivem/	FiveM Application Data/ (contents)
pack son/, audio/	GTA V/x64/audio/sfx/ (.rpf files only)
gta5/, gta/	GTA V/ (root)

---

Workshop JSON schema

The Workshop reads workshop.json from this repository. To add a pack, append an entry to the packs array:

{
  "packs": [
    {
      "name": "My Pack",
      "author": "Author",
      "description": "Short description.",
      "version": "1.0",
      "size_mb": 500,
      "downloads": 0,
      "tags": ["reshade", "enb"],
      "preview_url": "https://example.com/thumbnail.jpg",
      "youtube_url": "https://www.youtube.com/watch?v=XXXXXXXXXXX",
      "download_url": "https://example.com/mypack.zip"
    }
  ],
  "updated": "2026-01-01"
}

Supported download hosts: pixeldrain, archive.org, GitHub Releases, or any direct link returning a .zip or .rar file (detected via Content-Disposition, Content-Type, or URL extension).

---

Auto-update

On startup, the app calls the GitHub Releases API and compares the latest tag against the embedded APP_VERSION. If a newer version is found, a banner appears with a download link.

To publish a new version:

1. Update APP_VERSION in services/update_service.py
2. Update AppVersion in installer.iss
3. Build the exe and installer
4. Create a GitHub Release with a tag matching the version (e.g. v1.2.8)

---

Security

• No operations on system paths (C:/Windows, etc.)
• SHA256 baseline protection for GTA V official files
• Automatic backup before every pack installation
• User confirmation required before any clean or uninstall operation
• All file operations sandboxed to configured pack and game directories