# LiveryLab EVO

Local livery toolkit for Assetto Corsa EVO.

Version: v1.2.0
Release prepared: 2026-07-22T19:21:17

## Overview

LiveryLab is a local Windows app for creating, managing, previewing, packaging,
and activating custom liveries and related assets for Assetto Corsa EVO.

The app does not require an account, does not use telemetry, and does not
intentionally upload your files.

LiveryLab runs locally on your Windows PC. Writes to the AC EVO game folder or
Saved Games only happen through explicit actions such as Activate in Game,
Update in Game, or a confirmed setup/maintenance action.

## Livery Workflows

Official External Liveries

- Does not require a complete AC EVO content extract.
- Uses editable projects in OfficialLiveryProjects.
- Activates to Saved Games/ACE/ExternalLiveries.
- Appears in AC EVO under Vehicles -> My Cars, not Vehicle Hub.
- Can work in Multiplayer when the other participants who need to see the
  design have the same livery installed.
- AC EVO currently does not display the custom LiveryLab livery name in game.

Advanced Liveries

- Requires a complete AC EVO content extract.
- Uses editable projects in LiveryProjects.
- Activates into the extracted AC EVO game content structure.
- Is intended for Single Player and is selected through the Vehicle Hub.

## Quick Start

1. Download the complete portable ZIP package:

   LiveryLab_v1.2.0.zip

2. If Windows blocks downloaded files, unblock the ZIP before extracting it.

   Recommended method:

   - Right-click the downloaded ZIP file.
   - Open Properties.
   - Select Unblock if Windows shows that option.
   - Click Apply / OK.

   PowerShell alternative:

   Unblock-File -Path "$env:USERPROFILE\Downloads\LiveryLab_v1.2.0.zip"

3. Extract the complete ZIP into a normal folder.

   Recommended:

   C:\LiveryLab_v1.2.0\

   The ZIP contains the app files directly. After extraction, LiveryLab.exe
   should be directly inside the folder shown above. Do not create another
   LiveryLab_v1.2.0 folder inside it.

   Do not extract it directly into the Assetto Corsa EVO game folder.

4. Keep the folder together.

   Do not move only LiveryLab.exe out of the folder. The app needs the bundled
   _internal, tools, the LiveryLab workspace folders, and UserData next to the
   EXE.

5. Enable Windows Long Paths before first use.

   LiveryLab uses deeply nested folders and filenames when it prepares game
   resources, previews, projects, imports and livery activations. The legacy
   Windows path-length limit can block these operations and prevent the
   Official and Advanced setup checks from becoming ready.

   Recommended method:

   - Close LiveryLab if it is running.
   - Right-click Enable_Long_Windows_Paths.bat next to LiveryLab.exe.
   - Select Run as administrator and confirm the Windows security prompt.
   - Press Y when the script asks whether long Windows paths should be enabled.
   - Restart Windows before starting LiveryLab again.

   Administrator permission is required because the helper changes the
   system-wide Windows setting for Win32 long paths. LiveryLab never runs this
   helper automatically.

   If you do not want to use the included BAT file, search online for
   "enable Win32 long paths Windows 10 Windows 11", enable the setting
   manually, and restart Windows before starting LiveryLab again.

   On a managed PC, the setting may be controlled by your administrator or
   Group Policy. After restarting, open Setup in LiveryLab and verify that
   Windows Long Paths is shown as ready.

6. Start:

   LiveryLab.exe

7. In the Setup area, select your Assetto Corsa EVO root folder.

   This is usually the folder that contains:

   AssettoCorsaEVO.exe

   If you installed Assetto Corsa EVO through Steam on your C: drive, look for:

   C:\Program Files (x86)\Steam\steamapps\common\Assetto Corsa EVO

8. Choose the Official or Advanced workflow and follow its setup checks before
   creating or activating liveries. The Official workflow does not need the
   complete content extraction required by Advanced.

## Included Folders

These folders live inside the extracted portable LiveryLab folder.

_internal

Bundled Python runtime, backend modules, web UI files and required libraries.
This folder is required. Do not delete or move it.

tools

Contains helper tools used by LiveryLab, including texconv.exe for texture
conversion workflows.

AC_EVO_Garage_Cleanup.bat

Optional maintenance helper for cleaning LiveryLab-related AC EVO garage data
when a local garage state needs to be reset or repaired. It does not run
automatically. Use it only when you intentionally want to run the garage cleanup
workflow and follow the prompts shown by the script.

Enable_Long_Windows_Paths.bat

Optional helper for the required Windows Long Paths setup. Run it as
administrator and restart Windows before relying on the new setting. The helper
does not run automatically. The same Windows setting can also be enabled
manually if you prefer not to use the BAT file.

LiveryProjects

Editable workspace for Advanced livery projects and related source files.

LiveryLibrary

Local Advanced livery library managed by LiveryLab.

LiveryPackageExport

Shared output folder for Advanced packages, Skin Packs, Workspace Transfer
bundles, and other portable exports.

OfficialLiveryProjects

Editable workspace for Official External Livery projects. Live 3D Preview reads
the PNG textures directly from these project folders.

OfficialLiveryLibrary

Local Official workflow data, including read-only packages, prepared resources,
SavedCar templates, and Official trash data.

OfficialLiveryPackageExport

Output folder for portable single-livery packages from the Official workflow.

UserData

Local app settings and WebView runtime data for this portable installation.

## Important Notes

The Advanced workflow writes into the Assetto Corsa EVO game folder only when
you explicitly use actions such as Activate in Game, Update in Game, package
extraction, Custom Grid bridge installation/cleanup, or similar confirmed
game-write actions.

The Official workflow activates liveries through
Saved Games/ACE/ExternalLiveries. It does not require the complete extracted
content/cars structure used by Advanced.

If your game is installed under Program Files, Windows may require administrator
permissions for some game-file write operations.

Keep backups of important projects and exported packages.

Do not manually delete or rename app-managed folders while LiveryLab is running.

AC_EVO_Garage_Cleanup.bat is a separate maintenance script. It is not required
for normal livery creation, package import/export or Activate in Game workflows.
Keep it next to LiveryLab.exe if you keep the portable folder together.

## Code Signing and Windows Security

Official LiveryLab release files are code-signed.

Code signing helps Windows verify that the executable comes from the expected
publisher and that it has not been modified after signing. However, Windows
SmartScreen, Microsoft Defender or other antivirus tools may still show warnings
for newly released apps, newly downloaded files or files with low reputation.

Always download LiveryLab from the official source.

When running LiveryLab.exe, check that Windows shows the expected publisher
information. Do not run modified or re-uploaded copies from unknown sources.

## Startup Troubleshooting

If LiveryLab does not start, or if Windows reports Python.Runtime.dll,
pythonnet, pywebview or an unhandled script exception at startup, Windows may
have blocked the downloaded ZIP file or some files extracted from it.

This can happen when Windows marks downloaded files as coming from the internet.
This is called the "Mark of the Web".

Recommended method:

1. Right-click the downloaded LiveryLab ZIP file.
2. Open Properties.
3. Select Unblock if Windows shows that option.
4. Click Apply / OK.
5. Extract the ZIP again.

PowerShell alternative:

Unblock-File -Path "$env:USERPROFILE\Downloads\LiveryLab_v1.2.0.zip"

Then extract the ZIP again and start LiveryLab.exe from the newly extracted
folder.

You do not need to be inside the Downloads folder when running the PowerShell
command. The path automatically points to the Downloads folder of the current
Windows user.

Note: Unblock-File only removes the Windows download block from the selected
file. It does not bypass antivirus detections, company security policies or all
SmartScreen reputation warnings.

Only use this if you downloaded LiveryLab from the official source.

## More Information

CHANGELOG.txt

Version history and release notes.

TRUST.txt

Trust, safety and file-access notes.

VERSION

Current app version.
