Installation

Installation

UV Texture Repacker runs on Windows 10 / 11, recent macOS, and modern Linux distributions. The app is a single window with no background services.

Quick install (recommended)

1. Go to the project Releases page.
2. Download the package for your operating system.
3. Unzip somewhere convenient and run the executable.

That is the whole install. There is no installer wizard, no registry entries, and no admin rights required.

First-run notes

Windows

The app uses the Microsoft WebView2 runtime to draw its window. WebView2 is included with Windows 11 and modern Windows 10 by default. If you see "WebView2 not found" on first launch, install it from Microsoft's download page and try again.

If Windows SmartScreen warns about an unrecognised publisher, click "More info" → "Run anyway". This is normal for unsigned open-source builds.

macOS

On first launch, macOS may say the app is from an unidentified developer. Right-click the app, choose Open, then confirm. macOS remembers the choice; subsequent launches open normally.

Linux

The app needs WebKitGTK to draw its window. Most desktop distributions ship it. On a minimal install you can usually add it with your distribution's package manager (look for webkit2gtk-4.1 or similar).

Optional features (everything is included in prepackaged release binaries)

A few features depend on optional libraries. The app launches and works without them; only the listed feature is unavailable until the library is present.

• FBX import / export — requires the Autodesk FBX Python bindings (fbxsdkpy). Without it, OBJ, glTF, glb, PLY, and STL still work; FBX files are simply not loadable.
• EXR textures — requires OpenEXR. Without it, EXR textures cannot be opened or written; PNG (8-bit and 16-bit) is unaffected.

If you installed from a release package, these are bundled and you do not need to worry about them. If you built from source, follow the README for the optional install steps.

Where the app stores your data

UV Texture Repacker keeps a small folder of per-user data:

• Windows: %userprofile%\muvp\
• macOS / Linux: ~/muvp/

Inside you will find:

• settings.json — your saved preferences. See Preferences.
• recent_files.json — the recent-files list shown in the title bar.

These files are plain text and safe to delete; the app recreates them with defaults the next time you launch it. The app does not write anything else outside this folder unless you save a project (.muvp) or run a pack to an output folder you chose.

Updating

Download the new release and replace your existing executable. Your settings and recent-files list are preserved because they live in ~/muvp/, not next to the app.

Uninstalling

1. Delete the app folder you unzipped.
2. Optional: delete ~/muvp/ if you do not want your settings to persist for a future install.

That is everything.

Next step

Open the app and continue with Getting Started.