Features

• Python-based, so it can be run in platforms besides Windows; Python script and standalone Windows application included.
• Supports NFS3 and HS FCE files
• Does the expected FCE color edition features: edit, add, delete and copy color sets. Can also sort colors.
• HSVT, HTML and color picker-based color selection for precise or convenient color edition.
• Can export and import color tables to and from CSV files, said files are compatible with both FCE versions.
• Displays colors accounting for tolerance values in aim to pursue the best color display accuracy.
• Add a random color set or generate a whole color table of random colors (with various settings).

Requirements

• Python 3 (tested with Python 3.8, 3.10 and 3.13) for script version.
  • Linux users might have to install IDLE3 because it uses one of its libraries.
  • Windows 7 users can use standalone version as long they have installed the latest VC++ Redistributables (x86); script version needs the PythonWin7 fork installed.

Installation/Use

• Unzip the NFS_FCEPaintBooth_winExe folder if you're using the Windows standalone app or NFS_FCEPaintBooth.py file if you're using the script version.
• For the Windows standalone app: open the NFS_FCEPaintBooth_winExe folder and run NFS_FCEPaintBooth.exe
• For the Python script version:
  • On Windows:
    • If you have Python 3 as your default Python instance, just double click the NFS_FCEPaintBooth.py file
    • Alternatively, open a Powershell/Command Prompt window in the folder you have the NFS_FCEPaintBooth.py file and type py NFSHS_FedataHFlagEdit.py and press Enter
  • On Linux:
    • Make the NFS_FCEPaintBooth.py file executable by opening a Terminal window in the folder you have the NFS_FCEPaintBooth.py file, then type chmod +x NFSHS_FedataHFlagEdit.py and press Enter
    • If you have Python 3 as your default Python instance, just double click the NFS_FCEPaintBooth.py file
    • Alternatively, open a Terminal window in the folder you have the NFS_FCEPaintBooth.py file and type python3 NFSHS_FedataHFlagEdit.py and press Enter
• You can also edit the colors exported to a CSV file: open up a text editor or a spreadsheet program (e.g. Excel, LibreOffice Calc) to do so
• • The CSV file structure is the following:
  • • first row, first digit is the amount of color sets (0-16), don't touch the trailing numbers
      

      8,0,0,0

    • the following 16 rows are the color sets, colors in each set are tuples wrapped in quotes, separated in columns by commas. Said columns correspond to primary color, interior color (HS only), secondary color and driver hair color (HS only). Each tuple has 4 values separated by commas, which are hue (scale 0-360), saturation, brightness and tolerance (scale 0-255) respectively
      

      "[0, 255, 128, 129]","[256, 6, 74, 128]","[38, 122, 114, 127]","[42, 190, 70, 127]"

      "[64, 60, 90, 127]","[256, 6, 74, 128]","[52, 2, 26, 127]","[42, 190, 70, 127]"

      ...

    • unused color sets can be left with [0, 0, 0, 0] values for each column
    • if you export a NFS3 color table, FCE Paint Booth will automatically give it interior ([0, 0, 64, 127]) and driver hair ([42, 190, 70, 127]) colors as a convenience feature if you want to import it to a HS FCE
    • if you're using a spreadsheet program remember to save with comma as separator and double quote marks (") as a quote character

Construction

Copyright / Permissions

MIT License

Copyright ©2025 and later AJ_Lethal

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Where to get the mod that this README file describe