Skip to main content

License: LGPL v3 Tests

Standalone Switchboard apps for content-pipeline workflows — map compositing, texture conversion and channel packing, photogrammetry, mesh conversion, Substance / Marmoset / Unity automation, WebXR preview and look matching.

extapps

Each app is a self-contained subpackage -- its engine, panel and Slots class -- on pythontk and uitk alone, registered with uitk's ExternalAppHandler via the uitk.external_apps.in_process entry-point group. A host (tentacle's Maya and Blender menus) opens one by name -- no host-side imports, and extapps imports no host.

extapps (highlighted) in the ecosystem: uitk requires pythontk; unitytk requires pythontk; mayatk requires uitk; blendertk requires uitk; tentacle requires uitk; extapps requires uitk; tentacle installs mayatk as its [maya] extra; tentacle installs blendertk as its [blender] extra; tentacle opens extapps by name (its [apps] extra) and never imports it; mayatk and blendertk share a mirrored API. tentacle and extapps are products, which nothing imports.

Tools

Tool Purpose Engine Docs
compositor Multi-layer texture compositing pythontk.core_utils.engines.textures.map_compositor →
metashape_workflow · realityscan_workflow · gaussian_splat_workflow End-to-end photogrammetry runs, one app per engine — frame extraction/curation → align → mesh → texture, with per-engine presets bundled runners (Metashape SDK, RealityScan RSNode, gaussian splat) Metashape engine → · Tuning →
substance_scripts Substance 3D Painter scripts, built-in and your own vendored (mayatk's Painter engine) →
marmoset_scripts Run Marmoset Toolbag scripts on a model file in a new Toolbag: the bundled import / lookdev and your own, each script's rows from its tokens bundled _marmoset_engine (SDK-specific) TBD
unity_scripts Run built-in and your own C# editor scripts in a Unity project you have open, each script's settings as rows: Send to Unity, Make Prefab, Reimport Folder. A script that takes an asset gets a model file, or, opened from Maya / Blender, the scene exported by the Scene Exporter pythontk.FolderDeliverer (delivery) + pythontk.JobQueue (served by the editor package it installs into the project); the host's UnityBridge (ptk.SceneExportHandoff) →
converter Texture conversion (normal DX↔GL, smoothness↔roughness, spec→PBR, bump→normal, optimize, flip/swizzle channels), color+alpha pack/unpack, PBR prep pythontk.ImgUtils / MapFactory TBD
packer Channel-pack and unpack textures via per-channel sources (built-in templates: ORM, MRAO, MSAO, Metallic Smoothness, glTF clearcoat / iridescence / transmission-volume) pythontk.ImgUtils / MapFactory TBD
mesh_convert FBX → glTF / GLB conversion pythontk.file_utils.mesh_convert TBD
webxr_preview Preview a scene (from a host) or an FBX / GLB file live in a browser or XR headset, and share a link pythontk.net_utils.preview →
look_match Light a baked scene to match a reference image: the mix of light layers, a live comparison, region scores, solve / fit proposals, WebXR renders, Update layers, rigs saved to the shared library pythontk.core_utils.engines.lighting →

Install

pip install extapps

Launch (standalone)

Installing extapps adds an extapps command (python -m extapps runs the same program):

Command Opens
extapps A browser listing every panel: search, filter by tag, double-click to open
extapps compositor One panel, by its name in the Tools table (metashape_workflow, mesh_convert, ...)
extapps --shortcut desktop Writes a desktop shortcut that opens the browser, then exits (--shortcut start_menu: the Start menu, or the Linux applications menu)
extapps compositor --shortcut desktop Writes a shortcut that opens one panel (named "extapps Compositor")

The command opens no console window, and quits once its last window is closed or hidden. It is uitk's ExternalAppHub; extapps/__main__.py only declares its name, icon and taskbar identity.

Desktop and Start-menu shortcuts

Three ways to get one; run any of them again to refresh a shortcut (after moving or upgrading the Python it runs, say):

  • From the browser: its menu, Launch from the desktop: section, Create desktop shortcut / Add to Start menu.
  • From inside Maya or Blender (tentacle): open the UI Browser, right-click a panel's row, Create desktop shortcut / Add to Start menu. The shortcut runs the host's own Python (mayapy, Blender's python) without opening the host.
  • From a terminal: extapps --shortcut desktop.

Before writing anything, the shortcut is tried: extapps has to import in that Python as the desktop starts it, without the host's startup scripts. When it does not (extapps reaches the host only through userSetup.py or Maya.env), no shortcut is written and the message says why. Fix it by installing extapps into that Python with pip, or by putting the extapps folder on a PYTHONPATH saved in your user environment.

A shortcut into a host's Python (which has no console-free twin, unlike a python.org or venv Python's pythonw) opens a console window for a moment; the program closes it as it starts.

When nothing seems to happen

A program started from the desktop has no console, so its output goes to a log: %LOCALAPPDATA%\uitk\extapps\extapps.log on Windows (the previous run's is extapps.log.1); on Linux the desktop session's journal. An uncaught error also shows in a message box.

From Python

python -c "from extapps.texture_maps.compositor import CompositorUI; CompositorUI().show(pos='screen', app_exec=True)"

Launch (from a host)

Hosts that load uitk's ExternalAppHandler discover apps automatically:

sb.handlers.external_app.launch("compositor")

Dependencies

  • pythontk — domain logic
  • uitk — UI framework
  • qtpy — Qt abstraction

The metashape_workflow tool additionally requires the Agisoft Metashape Python module to be importable (installed alongside Metashape itself). The substance_scripts tool requires an Adobe Substance 3D Painter install (auto-detected) to launch one, or your own Painter with its plugin installed (Install in Painter).

License

LGPL-3.0-or-later — see COPYING.LESSER and COPYING.

Metadata

Release files for extapps 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for extapps 0.9.0
File Interpreter ABI Platform Actions
extapps-0.9.0-py3-none-any.whl Python 3 none any Details for extapps-0.9.0-py3-none-any.whl

Release files / extapps-0.9.0-py3-none-any.whl

Download URL extapps-0.9.0-py3-none-any.whl
Size 521.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fa7b21ed41cbe394401e8fa7337083bead2cba7ee8fc4472c035b4efaadc36cb
BLAKE2b-256 checksum
How to use checksums
0fabffb82a200a5a2a3ac7beae007484ce7d8394d9b37b5d84d1743fe49a4d37
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.18

Security for extapps 0.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.9.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page