{"id":13400390,"url":"https://github.com/yuk7/wsldl","last_synced_at":"2025-05-14T08:07:13.830Z","repository":{"id":26072206,"uuid":"107250913","full_name":"yuk7/wsldl","owner":"yuk7","description":"Advanced WSL launcher / installer. (Win10 FCU x64/arm64 or later.)","archived":false,"fork":false,"pushed_at":"2025-05-11T13:26:15.000Z","size":2459,"stargazers_count":1835,"open_issues_count":5,"forks_count":135,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-05-11T14:30:43.866Z","etag":null,"topics":["linux","windows-10","windows-11","windows-subsystem-linux","windows-terminal","wsl","wsldl"],"latest_commit_sha":null,"homepage":"https://git.io/wsldl","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yuk7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"yuk7","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":"https://paypal.me/yuk77"}},"created_at":"2017-10-17T10:04:09.000Z","updated_at":"2025-05-11T13:26:19.000Z","dependencies_parsed_at":"2023-02-12T16:30:39.674Z","dependency_job_id":"cf9fda8e-2a6b-4387-9ab4-fd1c89ae6de2","html_url":"https://github.com/yuk7/wsldl","commit_stats":{"total_commits":487,"total_committers":32,"mean_commits":15.21875,"dds":0.2073921971252567,"last_synced_commit":"8a66c55691c3181939dfe211637c10c9462ffc36"},"previous_names":[],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuk7%2Fwsldl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuk7%2Fwsldl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuk7%2Fwsldl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuk7%2Fwsldl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yuk7","download_url":"https://codeload.github.com/yuk7/wsldl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254101618,"owners_count":22014909,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["linux","windows-10","windows-11","windows-subsystem-linux","windows-terminal","wsl","wsldl"],"created_at":"2024-07-30T19:00:51.517Z","updated_at":"2025-05-14T08:07:08.816Z","avatar_url":"https://github.com/yuk7.png","language":"Go","funding_links":["https://github.com/sponsors/yuk7","https://paypal.me/yuk77"],"categories":["Go","HarmonyOS","Unofficial Distributions"],"sub_categories":["Windows Manager","10. GUI Apps"],"readme":"# wsldl\nAdvanced WSL Distribution Launcher / Installer\n\n![wsldl logo](https://github.com/yuk7/wsldl/assets/29954265/8c8804f7-29a2-43c7-a9ed-c763a2196100)\n\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/yuk7/wsldl/ci.yml?style=flat-square)](https://github.com/yuk7/wsldl/actions/workflows/ci.yml)\n[![Github All Releases](https://img.shields.io/github/downloads/yuk7/wsldl/total.svg?style=flat-square)](https://github.com/yuk7/wsldl/releases/latest)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n![License](https://img.shields.io/github/license/yuk7/wsldl.svg?style=flat-square)\n\n\n### [Detailed documentation is here](https://git.io/wsldl-doc)\n\n## 💻Requirements\n* Windows 10 1709 Fall Creators Update or later(x64/arm64).\n* Windows Subsystem for Linux feature is enabled.\n\n## 📦Install with Prebuilt Packages\n[**You can see List on docs**](https://wsldl-pg.github.io/docs/Using-wsldl/#distros)\n\n**Note:**\nExe filename is using to the instance name to register.\nIf you rename it, you can register with a different name.\n\n\n## 🔧Install with any rootfs tarball\n\n**Note:**\nThe filesystem needs to be in the root of the tarball, some rootfs tarballs may need to be repacked.\n\n#### 1. [Download wsldl.exe](https://github.com/yuk7/wsldl/releases/latest)\n(wsldl.exe is x86_64, wsldl_arm64.exe is ARM64 build)\n#### 2. Rename it for distribution name to register.\n(Ex: Rename to Arch.exe if you want to use \"Arch\" for the Instance name)\n#### 3. Put your install.tar(.gz) in same directory as exe (Installation directory)\n#### 4. Run exe to install. This process may take a few minutes.\n\n## 🔧Install with any ext4 vhdx disk images (WSL2 only)\n#### 1. [Download wsldl.exe](https://github.com/yuk7/wsldl/releases/latest)\n(wsldl.exe is x86_64, wsldl_arm64.exe is ARM64 build)\n#### 2. Rename it for distribution name to register.\n(Ex: Rename to Arch.exe if you want to use \"Arch\" for the Instance name)\n#### 3. Put your install.ext4.vhdx(.gz) in same directory as exe (Installation directory)\n#### 4. Run exe to install. This process may take a few minutes.\n\n## 🔗Use as a Launcher for already installed distribution\n#### 1. [Download wsldl.exe](https://github.com/yuk7/wsldl/releases/latest)\n(wsldl.exe is x86_64, wsldl_arm64.exe is ARM64 build)\n#### 2. Rename it for registerd instance name.\nPlease check the registered instance name of the distribution with `wslconfig /l` command.\n(Ex: If the instance name is \"Ubuntu-20.04\", rename `wsldl.exe` to `Ubuntu-20.04.exe`)\n#### 4. Run exe to Launch instance or configuration.\nFor details, please see the help. (`{InstanceName}.exe help`)\n\nNote: You can distribute your distribution including wsldl exe.\n\n## 📝How-to-Use(for Installed Instance)\n#### exe Usage\n```\nUsage :\n    \u003cno args\u003e\n      - Open a new shell with your default settings.\n        Inherit current directory (with exception that %%USERPROFILE%% is changed to $HOME).\n\n    run \u003ccommand line\u003e\n      - Run the given command line in that instance. Inherit current directory.\n\n    runp \u003ccommand line (includes windows path)\u003e\n      - Run the given command line in that instance after converting its path.\n\n    config [setting [value]]\n      - `--default-user \u003cuser\u003e`: Set the default user of this instance to \u003cuser\u003e.\n      - `--default-uid \u003cuid\u003e`: Set the default user uid of this instance to \u003cuid\u003e.\n      - `--append-path \u003ctrue|false\u003e`: Switch of Append Windows PATH to $PATH\n      - `--mount-drive \u003ctrue|false\u003e`: Switch of Mount drives\n      - `--wsl-version \u003c1|2\u003e`: Set the WSL version of this instance to \u003c1 or 2\u003e\n      - `--default-term \u003cdefault|wt|flute\u003e`: Set default type of terminal window.\n\n    get [setting [value]]\n      - `--default-uid`: Get the default user uid in this instance.\n      - `--append-path`: Get true/false status of Append Windows PATH to $PATH.\n      - `--mount-drive`: Get true/false status of Mount drives.\n      - `--wsl-version`: Get the version os the WSL (1/2) of this instance.\n      - `--default-term`: Get Default Terminal type of this instance launcher.\n      - `--wt-profile-name`: Get Profile Name from Windows Terminal\n      - `--lxguid`: Get WSL GUID key for this instance.\n\n    backup [file name]\n      - `*.tar`: Output backup tar file.\n      - `*.tar.gz`: Output backup tar.gz file.\n      - `*.ext4.vhdx`: Output backup ext4.vhdx file. (WSL2 only)\n      - `*.ext4.vhdx.gz`: Output backup ext4.vhdx.gz file. (WSL2 only)\n      - `*.reg`: Output settings registry file.\n\n    clean\n      - Uninstall that instance.\n\n    help\n      - Print this usage message.\n```\n\n\n#### Just Run exe\n```cmd\n\u003e{InstanceName}.exe\n[root@PC-NAME user]#\n```\n\n#### Run with command line\n```cmd\n\u003e{InstanceName}.exe run uname -r\n4.4.0-43-Microsoft\n```\n\n#### Run with command line with path translation\n```cmd\n\u003e{InstanceName}.exe runp echo C:\\Windows\\System32\\cmd.exe\n/mnt/c/Windows/System32/cmd.exe\n```\n\n#### Change Default User(id command required)\n```cmd\n\u003e{InstanceName}.exe config --default-user user\n\n\u003e{InstanceName}.exe\n[user@PC-NAME dir]$\n```\n\n#### Set \"Windows Terminal\" as default terminal\n```cmd\n\u003e{InstanceName}.exe config --default-term wt\n```\n\n#### How to uninstall instance\n```cmd\n\u003e{InstanceName}.exe clean\n\n```\n\n#### How-to-backup\nexport to backup.tar.gz (WSL1 or 2)\n```cmd\n\u003e{InstanceName}.exe backup backup.tar.gz\n```\nexport to backup.ext4.vhdx.gz  (WSL2 only)\n```cmd\n\u003e{InstanceName}.exe backup backup.ext4.vhdx.gz\n```\n\n#### How-to-import\n.tar(.gz)  (WSL1 or 2)\n```cmd\n\u003e{InstanceName}.exe install backup.tar.gz\n```\n.ext4.vhdx(.gz)  (WSL2 only)\n```cmd\n\u003e{InstanceName}.exe install backup.ext4.vhdx.gz\n```\n\n\n\n\n## 🛠How-to-Build\nPlease see [DEVELOPERS.md](DEVELOPERS.md)\n\n## 📄License\n[MIT](LICENSES.md)\n\nCopyright (c) 2017-2025 [yuk7](https://github.com/yuk7)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuk7%2Fwsldl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuk7%2Fwsldl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuk7%2Fwsldl/lists"}