{"id":51149012,"url":"https://github.com/tkvsc-team/totk-vscode","last_synced_at":"2026-06-26T05:00:19.516Z","repository":{"id":360135505,"uuid":"1248454876","full_name":"TKVSC-Team/totk-vscode","owner":"TKVSC-Team","description":"Canonically Amazing!","archived":false,"fork":false,"pushed_at":"2026-06-21T03:56:21.000Z","size":148408,"stargazers_count":7,"open_issues_count":13,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-21T04:20:12.321Z","etag":null,"topics":["modding-tool","totk","vscode-extension","zelda"],"latest_commit_sha":null,"homepage":"https://discord.gg/vwPnX2uB8s","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TKVSC-Team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-24T17:02:12.000Z","updated_at":"2026-06-21T03:56:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TKVSC-Team/totk-vscode","commit_stats":null,"previous_names":["mindstormman06/totk-vscode","tkvsc-team/totk-vscode"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/TKVSC-Team/totk-vscode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TKVSC-Team%2Ftotk-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TKVSC-Team%2Ftotk-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TKVSC-Team%2Ftotk-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TKVSC-Team%2Ftotk-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TKVSC-Team","download_url":"https://codeload.github.com/TKVSC-Team/totk-vscode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TKVSC-Team%2Ftotk-vscode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34803678,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["modding-tool","totk","vscode-extension","zelda"],"created_at":"2026-06-26T05:00:18.141Z","updated_at":"2026-06-26T05:00:19.434Z","avatar_url":"https://github.com/TKVSC-Team.png","language":"TypeScript","funding_links":["https://www.patreon.com/cw/TKVSC"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/TKVSC-Team/totk-vscode/blob/main/graphics/logo/Logo_FancyShading.png?raw=true\" width=\"300vh\"\u003e\n  \u003ch1\u003eTears of the Kingdom VSCode Extension\u003c/h1\u003e\n  \n  \u003ca href=\"https://discord.gg/vwPnX2uB8s\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/1508590792149827745?style=for-the-badge\u0026logoColor=5865F2\u0026color=5865F2\u0026labelColor=2A2C33\u0026logo=discord\u0026label=discord\" alt=\"Discord\"/\u003e\n  \u003c/a\u003e \u0026nbsp;\n  \u003ca href=\"https://github.com/TKVSC-Team/totk-vscode/releases/latest\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/tag/TKVSC-Team/totk-vscode?style=for-the-badge\u0026logoColor=ffffff\u0026color=C71B42\u0026labelColor=2A2C33\u0026logo=github\u0026label=Version\" alt=\"Latest Release\"\n  \u003c/a\u003e \u0026nbsp;\n  \u003ca href=\"https://github.com/TKVSC-Team/totk-vscode\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/TKVSC-Team/totk-vscode?style=for-the-badge\u0026color=FFCB41\u0026labelColor=2A2C33\u0026logo=github\" alt=\"Stars\"/\u003e\n\n  \u003c/a\u003e \u0026nbsp;\n  \u003ca href=\"https://github.com/TKVSC-Team/totk-vscode/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/TKVSC-Team/totk-vscode/total?style=for-the-badge\u0026labelColor=2A2C33\u0026color=31c059\u0026logo=data:image/svg%2bxml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iaXNvLTg4NTktMSI/Pg0KPCEtLSBVcGxvYWRlZCB0bzogU1ZHIFJlcG8sIHd3dy5zdmdyZXBvLmNvbSwgR2VuZXJhdG9yOiBTVkcgUmVwbyBNaXhlciBUb29scyAtLT4NCjxzdmcgZmlsbD0iIzMxYzA1OSIgaGVpZ2h0PSI4MDBweCIgd2lkdGg9IjgwMHB4IiB2ZXJzaW9uPSIxLjEiIGlkPSJDYXBhXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiDQoJIHZpZXdCb3g9IjAgMCA0NzEuMiA0NzEuMiIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI+DQo8Zz4NCgk8Zz4NCgkJPHBhdGggZD0iTTQ1Ny43LDIzMC4xNWMtNy41LDAtMTMuNSw2LTEzLjUsMTMuNXYxMjIuOGMwLDMzLjQtMjcuMiw2MC41LTYwLjUsNjAuNUg4Ny41Yy0zMy40LDAtNjAuNS0yNy4yLTYwLjUtNjAuNXYtMTI0LjgNCgkJCWMwLTcuNS02LTEzLjUtMTMuNS0xMy41cy0xMy41LDYtMTMuNSwxMy41djEyNC44YzAsNDguMywzOS4zLDg3LjUsODcuNSw4Ny41aDI5Ni4yYzQ4LjMsMCw4Ny41LTM5LjMsODcuNS04Ny41di0xMjIuOA0KCQkJQzQ3MS4yLDIzNi4yNSw0NjUuMiwyMzAuMTUsNDU3LjcsMjMwLjE1eiIvPg0KCQk8cGF0aCBkPSJNMjI2LjEsMzQ2Ljc1YzIuNiwyLjYsNi4xLDQsOS41LDRzNi45LTEuMyw5LjUtNGw4NS44LTg1LjhjNS4zLTUuMyw1LjMtMTMuOCwwLTE5LjFjLTUuMy01LjMtMTMuOC01LjMtMTkuMSwwbC02Mi43LDYyLjgNCgkJCVYzMC43NWMwLTcuNS02LTEzLjUtMTMuNS0xMy41cy0xMy41LDYtMTMuNSwxMy41djI3My45bC02Mi44LTYyLjhjLTUuMy01LjMtMTMuOC01LjMtMTkuMSwwYy01LjMsNS4zLTUuMywxMy44LDAsMTkuMQ0KCQkJTDIyNi4xLDM0Ni43NXoiLz4NCgk8L2c+DQo8L2c+DQo8L3N2Zz4=\u0026cache=1\" alt=\"Downloads\"/\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003cbr /\u003e\n\nThe **T**ears of the **K**ingdom **V**isual **S**tudio **C**ode Extension or **TKVSC** is a Visual Studio Code extension for editing and browsing **Tears of the Kingdom** (**TotK**) game files.\n\n\u003csup\u003e\u003c/sub\u003eIt also pairs well with **TKMM!**\u003c/sup\u003e\u003c/sub\u003e\n\n**TKVSC Website**: https://tkvsc.dev/\n\n**TKVSC** GameBanana page: https://gamebanana.com/tools/22893\n\n**Game Dump Guide** (required): https://gamebanana.com/tuts/19858\n\n## DISCLAIMER\n**WE ARE NOT RESPONSIBLE IF YOUR MOD BREAKS. THIS TOOL IS IN ACTIVE BETA AND THINGS WILL BREAK. MAKE FREQUENT BACKUPS**\n\n## Features\nPreview and edit subfiles of SARC and BNTX archives\n\n \u003cimg src=\"https://github.com/TKVSC-Team/totk-vscode/blob/main/graphics/Promo/SARC_Edit.png?raw=true\" width=\"720vh\"\u003e\n\n### Supported Filetypes \n\n\n#### Text Editor\n- BYML\n- BGYML\n- AAMP\n- MSBT\n- ASB (Changes automatically applied to corresponding BAEV)\n- BAEV (Changes automatically applied to corresponding ASB)\n- XLINK\n- PCHTXT\n- TKMM Config Files\n\n#### Texture Viewer/Replacer\n- BNTX\n- Tex2Go\n- **Unsupported**\n- - VSP\n\n#### Audio Player\n- Bars\n- BFWAV\n\n---\n\n### Activity Bar Tabs\n\n \u003cimg src=\"https://github.com/TKVSC-Team/totk-vscode/blob/main/graphics/Promo/ActivityBarGuide.png?raw=true\" width=\"400vh\"\u003e\n\n\n**Your Projects**\n- Add the current folder open in VS Code to a list of Project Folders\n\n**TotK Dump**\n- Browse your dump of TotK in Read-Only mode. Right click to add a file to the correct romfs path within a Project Folder of your choosing\n\n### Additional capabilities:\n\n- Archives within archives (e.g. a `.sarc` inside a `.pack`) can be browsed and edited\n- Search for romfs contents, including filenames inside of SARCs\n- Right-click a file within an archive to export it to a Project Folder.\n- File templates: Rather than the typical method of copying, pasting, and wiping an existing file to make a new file of the same format, TKVSC can create empty files of formats supported by the editor.\n- Preview `.bntx` subfiles and `.txtg` files as PNGs\n- Visual editor for [TKMM](https://tkmm.org) `.tkproj` files\n- For files TKVSC does not support, such as `.bfres`, the user can choose external programs to open them in by default (separate from similar features in the OS).\n\n \u003cimg src=\"https://github.com/TKVSC-Team/totk-vscode/blob/main/graphics/Promo/tkproj_Edit.png?raw=true\" width=\"800vh\"\u003e\n\n## Canonical Path Saving\n\nThe canonical path of a file is where the file exists in the game's memory, as opposed to the romfs path which describes its location within a game dump. Using the romfs file located at `\\Pack\\Actor\\Armor_001_Head.pack.zs\\Component\\ArmorParam\\Armor_001_Head.game__component__ArmorParam.bgyml` as an example, the canonical path would be `\\Component\\ArmorParam\\Armor_001_Head.game__component__ArmorParam.bgyml`.\n\nAnyone who has made changes to an upgradeable armor set, or to any parameter file that is parented to a file used in another actor pack, is familiar with needing to make the same edits to an identically named file in several different locations in order for everything to work nicely ingame. TKVSC builds a database of all canonical paths in your game dump and in each of your mod projects and automatically saves changes to all instances of a file's canonical path, pulling files in from the game dump as needed when it isn't already present in your mod project.\n\nTo demonstrate with a direct comparison, modifying the defense of every level of the Champion's Leathers would take **15 file modifications without TKVSC**, and only **5 with TKVSC**.\n\n## Planned Features\n\n*( if there are any features you don't see on here, feel free to make an issue on this GitHub! )*\n\n- Node Based Editors (AINB, ASB, BAEV, and EVFL are all planned.)\n- BFRES Support (Preview, Editing.)\n- Audio Support (BARS, BWAV.) (Read currently supported, write W.I.P)\n- Actor Tooling (Automating the process as much as possible.)\n- Full romfs file content string searching\n\n- \u003csub\u003e\u003c/sup\u003ePTCL/Effect support is being researched but not confirmed.\u003c/sup\u003e\u003c/sub\u003e\n\n## Setup\n\n### Requirements\n* [Python 3.13+](https://www.python.org/downloads/)\n* [Microsoft C++ Redis](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170)\n* Node.js (if building extension from source)\n* Python 3.13-venv (on Linux)\n* Valid TotK dump\n\n### Steps\n1. Install the extension (VSIX).\n2. Follow the prompt to select your romfs dump path.\n\n\n### Python troubleshooting\n\n**`python3` works in CMD but the extension cannot find Python?** VSCode is often launched without your full user PATH (unlike a terminal you opened yourself). Fix:\n\n1. **TKVSC: Select Python (from detected installs)** - scans `where python3`, common install folders, and `py`.\n2. **TKVSC: Browse for python.exe** - point at the real interpreter (e.g. `%LocalAppData%\\Programs\\Python\\Python314\\python.exe`).\n3. Or set **TKVSC → Python Path** to that full path, then **TKVSC: Set Up Python Environment** again.\n\nIf setup fails, run **TKVSC: Set Up Python Environment** from the Command Palette.\n\n## Build Instructions\n\nA VSIX file is the installable extension package. Build it from the project root:\n\n```bash\nnpm install\nnpm run package:vsix\n```\n\nThat produces `totk-vscode-0.0.3-beta.1.vsix` (version comes from `package.json`).\n\n\n### Contributing:\n\nSee: [CONTRIBUTING.md](./.github/CONTRIBUTING.md)\n\n### Addon development\n\nCompanion VS Code extensions can extend TKVSC via the exported API. See [docs/api/addon-development.md](docs/api/addon-development.md) (guide) and [docs/api/v1.md](docs/api/v1.md) (full API reference).\n\n## Credits\n### TKVSC Team\n**Mind** - Project Lead, Developer\\\n**The5thTear** - Developer, Research\\\n**Aster** - Graphics, Documentation\n\n### Contributors\n**Clonephaze** - [GitHub Template Refactor](https://github.com/TKVSC-Team/totk-vscode/pull/62)\n\n### Third-Parties\n**dt13245**: [ASB fork](https://github.com/TKVSC-Team/asb), [AINB fork](https://github.com/TKVSC-Team/AINB), and [XLink2](https://github.com/dt-12345/xlink2) (legacy version) binaries integrated into codebase\\\n**P1gyy**: [pymsbt fork](https://github.com/TKVSC-Team/pymsbt) integrated into codebase\\\n**AeonSake**: [MSBT Editor](https://gitlab.com/AeonSake/msbt-editor) - TotK Config included\\\n**LordBubbles**: [TKMM](https://tkmm.org/) - Assistance with implementing TKMM compatibility\\\n**KillzXGaming**: [Switch Toolbox](https://github.com/KillzXGaming/Switch-Toolbox) - image handling referenced\\\n**Arch Leaders**: [NX Editor](https://github.com/NX-Editor/NxEditor) - text formatting referenced\\\n**SolidLink**: [Totkbits](https://github.com/SolidLink95/TotkBits) - Tag.Product \u0026 text formatting referenced, bphcl \u0026 ptcl implementation used\\\n\n## Help and Community\n\n- [Discord Server](https://discord.gg/vwPnX2uB8s)\n- [Documentation](https://tkvsc.dev/docs/index.html)\n- [Patreon](https://www.patreon.com/cw/TKVSC)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftkvsc-team%2Ftotk-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftkvsc-team%2Ftotk-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftkvsc-team%2Ftotk-vscode/lists"}