Metadata-Version: 2.4
Name: holocrontoolset
Version: 4.0.0b22
Summary: A PyQt-backed program with a collection of tools and editors that make it easy to work with kotor files
Author: Nick Hugi, th3w1zard1
Maintainer-email: th3w1zard1 <boden.crouch@gmail.com>
License: LGPL-3.0-or-later
Project-URL: Homepage, https://github.com/OldRepublicDevs/PyKotor
Project-URL: Documentation, https://github.com/OldRepublicDevs/PyKotor/wiki
Project-URL: Repository, https://github.com/OldRepublicDevs/PyKotor.git
Project-URL: Issues, https://github.com/OldRepublicDevs/PyKotor/issues
Project-URL: Changelog, https://github.com/OldRepublicDevs/PyKotor/releases
Keywords: 3d,bioware,dlg,editor,gff,holocron,knights-of-the-old-republic,kotor,kotor1,kotor2,modding,module-designer,opengl,pykotor,pyqt5,star-wars,toolset,tsl
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Games/Entertainment :: Role-Playing
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Text Editors :: Integrated Development Environments (IDE)
Classifier: Environment :: X11 Applications :: Qt
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: MacOS X
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi>=2021.10.8
Requires-Dist: comtypes>=1.4.0; sys_platform == "win32"
Requires-Dist: idna>=3.11
Requires-Dist: jsonpickle>=4.1.1
Requires-Dist: Markdown>=3.4.4
Requires-Dist: numpy<1.25,>=1.19.0; python_version < "3.9"
Requires-Dist: numpy>=1.25; python_version >= "3.9"
Requires-Dist: Pillow<11,>=10.0.0; python_version < "3.10"
Requires-Dist: Pillow>=12.1.1; python_version >= "3.10"
Requires-Dist: pykotor[encodings,extra,font,gl,updater]>=2.3.2
Requires-Dist: PyQt5<6,>=5.15; python_version < "3.9"
Requires-Dist: PyQt5-sip<13,>=12.10; python_version < "3.9"
Requires-Dist: PyQt6-Qt6>=6.10.1; python_version >= "3.9"
Requires-Dist: PyQt6-sip<13.10.3,>=12.10; python_version >= "3.9" and python_version < "3.10"
Requires-Dist: PyQt6-sip>=13.10.3; python_version >= "3.10"
Requires-Dist: PyQt6>=6.10.1; python_version >= "3.9"
Requires-Dist: PySide6_Addons>=6.10.1; platform_python_implementation == "PyPy" and python_version >= "3.9"
Requires-Dist: PySide6_Essentials>=6.10.1; platform_python_implementation == "PyPy" and python_version >= "3.9"
Requires-Dist: PySide6>=6.10.1; platform_python_implementation == "PyPy" and python_version >= "3.9"
Requires-Dist: qtpy>=2.4.3
Requires-Dist: requests<2.32.5,>=2.23.0; python_version < "3.9"
Requires-Dist: requests>=2.32.4; python_version >= "3.9"
Requires-Dist: send2trash>=1.8.3
Requires-Dist: urllib3<2.6.3,>=1.21.1; python_version < "3.9"
Requires-Dist: urllib3>=2.6.3; python_version >= "3.9"
Dynamic: license-file

# HolocronToolset

A PyQt/PySide application that can edit the files used by the KotOR game engine.

## Requirements

- Python 3.8+
- qtpy (abstraction layer for pyqt5/6 and pyside2/6)
- (Optional) A KotOR I or II game installed on your machine somewhere.

## Local Run

**With uv** (from PyKotor repo root):

```bash
# End users (latest from PyPI)
uvx --refresh holocrontoolset

# Developers (local source)
uvx --with-editable Libraries/PyKotor --with-editable Tools/HolocronToolset holocrontoolset
uv run --directory Tools/HolocronToolset/src --module toolset
```

**Without uv** (activated venv, from `Tools/HolocronToolset`):

### Windows

```powershell
python -m pip install -r requirements.txt
$env:PYTHONPATH = (Get-Location).Path
python toolset/__main__.py
```

### Unix

```bash
python3 -m pip install -r requirements.txt
PYTHONPATH=$PWD python3 toolset/__main__.py
```

### Note for Alpine users:
You might get this error:
```
pyproject.toml: line 7: using '[tool.sip.metadata]' to specify the project metadata is deprecated and will be removed in SIP v7.0.0, use '[project]' instead
```
While we're not sure what the exact problem is, it seems newer python versions won't correctly be able to build pyqt5. If you don't have a binary available (--only-binary=:all: returns no versions) you'll need to downgrade python preferably to 3.8 or you won't be able to use qt5!
[See this issue for more information](https://github.com/altendky/pyqt-tools/issues/100)

## Local Development

- Clone [PyKotor](https://github.com/OldRepublicDevs/PyKotor). Use `uvx --with-editable` to run from local source, or run `install_python_venv.ps1` for a traditional venv setup.

## Accessing the GUI Designer

```bash
python -m pip install qt5-applications
```

Then navigate to your Python's site-packages folder:

```bash
python -m site --user-site
```

Then navigate to ```./site-packages/qt5_applications/Qt/bin``` and open the ```designer.exe``` file.
