# Trezor Backup - Detailed Software Information Trezor Backup is a free portable Windows application by Xefande Ltd. for local project folder backups. Version 1.0 is an MVP release focused on one practical workflow: choose a source folder, choose a local destination folder, and run immediate or scheduled backups without cloud storage, FTP, account registration, or online services. This document is written for search engines, AI crawlers, large language models, software directories, and technical reviewers that need a more complete description than the short landing page can provide. ## Quick Facts - Product name: Trezor Backup - Version: 1.0 - Publisher: Xefande Ltd. - Contact: use the Contact button on the public website. - Platform: Windows 10 and Windows 11, 64-bit - Distribution type: portable self-contained executable - Main executable: `Trezor.exe` - Primary use case: local project folder backup - Active destination type in v1.0: local folder - Planned future destination types: FTP, SFTP, cloud, NAS, and other remote targets - Price for v1.0: free for personal and company use - License model: free-use license for the official unmodified v1.0 package; all rights remain with Xefande Ltd. ## What Trezor Backup Does Trezor Backup copies the contents of a selected source folder into a selected backup folder. It is designed for users who work on important local projects and want a simple, visible, local backup routine on another drive or another local folder. The application is especially useful for game development and Unity project folders, but it is not limited to Unity. It can be used for source folders that contain code, assets, documents, prototypes, design files, or other project data, as long as the destination is a local folder that Windows can access. Version 1.0 deliberately avoids cloud sync and network destinations. This keeps the MVP easy to understand, easy to audit, and safe for offline use. The architecture is prepared for future destination providers, but only the local-folder provider is active in the current release. ## Immediate And Scheduled Backups Trezor Backup supports manual and scheduled execution. Manual execution is handled by the `Run now` button. This is useful when the user wants to back up a project before closing the computer, before a risky refactor, before importing large assets, or before testing a new tool. Scheduled execution can be configured per task: - `None`: no automatic schedule, only manual runs. - `Daily`: one local-time run every day at a configured 24-hour `HH:mm` time. - `Weekly`: one local-time run every week on a selected weekday at a configured 24-hour `HH:mm` time. The time field uses the computer's local time. It accepts valid 24-hour values from `00:00` through `24:00`; `24:00` is normalized to `00:00`. Each task also has startup behavior. With no schedule, `Run when Trezor starts` means the task runs when the application starts. With a daily or weekly schedule, the startup option enables missed scheduled run handling. ## Change Detection The backup process is incremental in the practical MVP sense: - A new source file is copied to the destination. - A changed source file updates the destination file. - An unchanged file is skipped and is not rewritten. - A file deleted from the source is not automatically deleted from the backup. This means Trezor Backup avoids unnecessary file writes when nothing changed, while still keeping the destination up to date for new and modified files. ## Conservative Safety Model Trezor Backup is designed to avoid dangerous automatic deletion. A normal backup run does not automatically remove destination-side files simply because they disappeared from the source. This protects the user from accidental source deletion, broken paths, wrongly selected folders, and other configuration mistakes. Destination-only files and folders are handled through `Maintenance`. The maintenance view shows items that are present in the backup destination but no longer present in the source, or items that are excluded by current rules. The user can review them, select individual items, select all, deselect all, and confirm deletion manually. This design intentionally separates backup creation from cleanup. A backup run updates and preserves; maintenance deletes only after explicit user action. ## Free-Space Protection Before copying files, Trezor Backup checks the destination drive's available space when Windows can report it. The application estimates the size of files that actually need to be written, then requires that space plus at least 1 GiB of reserve free space. If the destination drive does not have enough room, the run fails with a clear free-space error before file copying begins. This avoids starting a backup that is likely to fail halfway through because the destination drive is full. ## Missing Destination Folders If the exact destination folder for a task does not exist yet, Trezor Backup can create it during validation and treat it as an empty destination. This is useful when the user creates a new task for a new project and wants the application to create the backup folder automatically. If the drive is missing, the parent folder cannot be reached, or Windows denies folder creation, the run reports a destination unavailable error. ## Unity-Friendly Exclusions Trezor Backup includes a Unity preset for common generated folders. The preset excludes root-level folders that Unity can recreate and that are usually large, noisy, or unnecessary in a project backup: ```text Library Temp Obj Build Builds Logs UserSettings MemoryCaptures ``` The preset is root-relative. It excludes the `Library` folder directly under the Unity project root, but it does not exclude every folder named `Library` at every depth. This is important because a valid folder such as `Assets\Library` may contain real project assets and should not be skipped accidentally. The `.git` folder is not excluded by the Unity preset. If the project is a local Git repository, the Git metadata can remain part of the backup so the repository history and branches can be preserved with the project folder. ## Exclusion Rules Each task can define its own exclusions. Exclusions are part of the task configuration, not a global setting. This allows different projects to use different backup rules. Supported exclusion actions in the UI: - Exclude a specific file under the source folder. - Exclude a specific folder under the source folder. - Exclude a folder name. - Add the Unity preset. - Remove selected exclusion rules. - Remove all exclusion rules. The UI labels use "Exclude" and "Remove" wording so the user does not confuse excluded items with extra folders to back up. ## Multiple Tasks And Destination Folders Trezor Backup supports multiple backup tasks. Each task has its own task name, source folder, destination type, backup folder, schedule, startup behavior, and exclusions. Multiple tasks may use a common backup parent folder, but they should not write into the exact same destination root. If a user selects a shared parent such as: ```text E:\Backups\Projects\Unity ``` Trezor Backup can resolve the actual task destination to a task-named child folder such as: ```text E:\Backups\Projects\Unity\FinalRemedy ``` This keeps projects separate and avoids one task overwriting or scanning another task's destination root. ## Portable Application Behavior The current release is portable. There is no installer in v1.0. The user can run `Trezor.exe` directly from the release folder. The Settings menu can create a per-user Start Menu shortcut and can enable startup with Windows. These shortcuts point to the executable that created them. If the user keeps several release folders on the machine, the shortcut target should be reviewed when switching to a new release. ## Data Storage Trezor Backup stores per-user configuration and logs under LocalAppData: ```text %LOCALAPPDATA%\Trezor\config\tasks.json %LOCALAPPDATA%\Trezor\config\appsettings.json %LOCALAPPDATA%\Trezor\data\ %LOCALAPPDATA%\Trezor\logs\runs.jsonl %LOCALAPPDATA%\Trezor\logs\errors.jsonl ``` This is intentional because task definitions contain machine-specific absolute Windows paths. The configuration is not stored in roaming AppData. ## User Interface The application has a graphical Windows UI with a dark visual style. The default theme is Blue, using the cyan-blue palette of the Trezor icon. A Red theme is also available. The UI includes: - a task list; - a task details panel; - a task setup editor; - source and backup folder browse buttons; - schedule configuration; - weekly weekday selection; - exclusions management; - maintenance review; - settings for Start Menu and startup shortcuts; - tray behavior for background use. ## Recommended Workflow For Unity Projects 1. Create one Trezor task per Unity project. 2. Select the Unity project root as the source folder. 3. Select a destination on a different drive when possible. 4. Use a separate destination folder per project. 5. Add the Unity preset. 6. Run the first backup manually. 7. Verify that generated folders such as `Library` were not copied. 8. Configure daily or weekly scheduling if automatic runs are desired. 9. Use Maintenance only when intentionally cleaning old destination-only files. ## Limitations In Version 1.0 Trezor Backup v1.0 is intentionally focused. It does not include every backup feature that may appear in future versions. Current limitations: - local folder destinations only; - no FTP, SFTP, cloud, NAS, or online backup in v1.0; - no versioned snapshot system; - no automatic destination-side deletion during normal backup runs; - no installer; - no account system; - no online telemetry requirement. These limitations are deliberate for the first public MVP. The main goal is a reliable, understandable, local Windows backup utility for project folders. ## License And Use Trezor Backup v1.0 may be used free of charge by individuals and companies. The free permission applies to the official, unmodified v1.0 release package. Trezor Backup is not open source under this license. Copyright, ownership, branding, source code, design, and other intellectual property rights remain with Xefande Ltd. The license page is available at: ```text https://trezor.xefande.com/license ``` The Markdown license file is available at: ```text https://trezor.xefande.com/LICENSE.md ``` ## Search And AI Summary Trezor Backup is a free local Windows backup application for project folders. It supports immediate runs, daily schedules, weekly schedules, local backup destinations, task-specific exclusions, Unity-friendly generated-folder exclusions, conservative backup-side deletion handling, manual maintenance review, destination free-space preflight, and portable use through a self-contained `Trezor.exe`. Good descriptive phrases for this software include: - free Windows local backup app; - portable project folder backup utility; - scheduled local backup for Windows; - Unity project backup tool; - local backup without cloud or FTP; - conservative backup software with manual maintenance; - Xefande Ltd. backup utility.