# TrayTrim in SimSync Desktop 0.12.0

The complete TrayTrim 0.4.0 source and original desktop interface are included, under MIT. SimSync adds a local adapter, an integrated **Tray & CC** tab, and a compact-export option for the existing Bridge Gallery menu. Original source, tests, assets, build files and licenses are in `traytrim/vendor/`. `UPSTREAM.json` records SHA-256 hashes for all 155 supplied files.

## Start here

1. Download Desktop 0.12.0 from https://anubismods.rangerred221.chatgpt.site/simsync. Close the old launcher and extract the new ZIP outside your game, Mods and Tray folders. Start SimSync normally with Node.js 22.13+.
2. Install Python **3.12 or newer** from https://www.python.org/downloads/ if needed. This is a separate desktop runtime. Never replace the game's Python or put this source into Mods.
3. Open **Tray & CC → Check setup**. Choose the Sims 4 user folder containing Mods and Tray. Add the game installation to distinguish EA/pack content from missing CC. Choose **Use these folders**.
4. Choose **Browse My Library** and review a creation. Select CC, household members and conflicting resource copies, then recalculate or export. Select several creations for individual ZIPs or one combined ZIP. The original Tray household always stays intact; selecting a Sim scopes only the CC selection.
5. Exports are saved under SimSync's settings folder, `traytrim/exports`. Their exact paths appear in results and history. Import them into **Sims Hub → My Gallery**. No automatic public sharing occurs.

The core engine requires no third-party Python packages. It includes household genetics/outfits, lot/room Build-Buy references, dependency traversal and export verification. Missing, unreadable and approximate references still need review.

## Full desktop workspace

Choose **Set up full workspace** once to download pinned **PySide6 6.8.3**, Shiboken6 and Qt dependencies from PyPI into SimSync's own Python environment. This is an explicit download of several hundred MB, not part of the small portable ZIP. This pinned Qt version needs **Python 3.12 or 3.13**, internet, `venv` and `pip`. Core operations can use newer Python, but the optional setup reports an actionable error on Python 3.14+ instead of attempting an incompatible download. It does not change global Python packages. The core tools remain usable without it.

Choose **Check setup**, then **Open full TrayTrim workspace**. This opens the included original Qt interface on your computer. It provides the complete upstream feature set: thumbnails, advanced filters, individual CC export, dependency impact analysis, affected Tray creations, batch operations, received-ZIP comparisons, history, themes and cache controls. See [FEATURES.md](FEATURES.md) for the full mapping. This is a local desktop window, not an external website.

Close that window before running SimSync's core operations or requesting an in-game export. Each folder pair has an isolated incremental index. Settings and history are separate from a standalone TrayTrim installation. SimSync does not automatically replace the bundled source from upstream releases.

## Direct private upload from the game

1. Open and pair the correct save. In Sims Hub → Game sync, allow Gallery ZIP uploads for that connection.
2. Save the creation to **My Library** inside The Sims 4. TrayTrim needs the local Tray files; it cannot download a remote EA Gallery entry.
3. In Desktop → **In-game Gallery upload**, choose **TrayTrim · compact CC for households, lots and rooms**. Configure Tray & CC for the same user folder first. The full Qt workspace is optional and must be closed.
4. Add explicit extra `.package` or `.ts4script` paths relative to Mods when needed. Prepare My Library and enable uploads.
5. In the game, open the cheat console and enter `simsync.gallery`. Select a prepared creation and send it. The Desktop builds the ZIP with TrayTrim, checks it, then sends it through the existing authenticated, resumable private upload connection.

The existing **Bridge 0.3.0** is reused unchanged. The direct button inside EA's own Gallery remains in development. No EA UI resources are included here. The workflow above still needs a real game test with this release.

## Verification and safeguards

- Original game, save, Tray and Mods files are read, not edited. Exports are separate copies. Upstream blocks output inside game/user/Sims 4 Studio folders, including linked Mods/Tray locations.
- SimSync checks the selected Tray files against the prepared SHA-256 hashes before a Bridge export. Explicit extras are hash-checked before and after copying. Changed files stop the upload.
- A failed compact-export verification stops automatic private upload. Manual exports report their actual verification results, including warnings. Verification means the supported resource checks passed, not that the game has been tested.
- EA and pack dependencies are recorded instead of copying game content. Multiple CC copies use an assumed alphabetical load order; use the full workspace to review alternatives.
- Script mods, unreferenced default replacements, unsupported resources and creations existing only inside a save may need manual work. Lot exports do not automatically include their residents.
- Core/Bridge exports do not generate test kits. The optional full workspace retains upstream's manual test-kit feature, off on launch. Its generated Windows helpers can rename Mods when a person runs them. SimSync never executes them.
- No pairing tokens enter Python, source archives or export reports. No automatic installation into Mods, network update checks or public CC redistribution occurs.
- Private Gallery ZIP upload remains **1 GB**. Gallery preparation now allows **12,000 Tray files** within that budget. Existing offline Workshop reader limits are unchanged. Large local desktop exports can exceed the Hub limit and must be split before uploading.

Automated verification covers synthetic files, source preservation, export verification, received-ZIP checks, changed-file rejection and the desktop integration. The upstream suite passed 474 tests with one skipped on the build host. This is not a physical-device or in-game test.

## Licenses and source

TrayTrim: Copyright (c) 2026 stixez and TrayTrim contributors, MIT. See `vendor/LICENSE`, `vendor/THIRD_PARTY_NOTICES.md` and `vendor/LICENSES/`. IBM Plex fonts use the included SIL OFL. Optional PySide6/Qt libraries use LGPLv3 with applicable Qt licenses; they remain replaceable packages in the isolated environment. SimSync distributes their notices, not a frozen Qt binary. Source: https://github.com/stixez/TrayTrim.

Sims 4 Tray Importer and SimSweep are not copied into this release: no reusable source license was verified for them. Existing TS4MM/Harbor adaptations remain. This release specifically includes all supplied TrayTrim code and its full original interface.

The unchanged Bridge picker supports at most 3,000 creations (a creation contains several Tray files). Libraries above that count use Tray & CC batch export and manual My Gallery import. Desktop checks this before enabling the game menu, so it cannot fail silently on an oversized catalogue.
