{"id":17295205,"url":"https://github.com/lorhansohaky/wsl-manager","last_synced_at":"2025-04-14T11:55:52.007Z","repository":{"id":114801084,"uuid":"602855518","full_name":"LorhanSohaky/wsl-manager","owner":"LorhanSohaky","description":"An easy way to maintain your WSL distros. Being able to reduce disk usage, move wsl and restore from vhdx file","archived":false,"fork":false,"pushed_at":"2025-01-14T12:08:02.000Z","size":176,"stargazers_count":10,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-14T11:55:42.773Z","etag":null,"topics":["disk-space","recovery","vhdx","vhdxfiles","windows-subsystem-for-linux","windows-subsystem-linux","wsl","wsl-manager","wsl2"],"latest_commit_sha":null,"homepage":"","language":"Python","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/LorhanSohaky.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"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}},"created_at":"2023-02-17T04:35:08.000Z","updated_at":"2025-02-01T18:59:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"5178a438-131d-43c8-b44f-a0f5342b5272","html_url":"https://github.com/LorhanSohaky/wsl-manager","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LorhanSohaky%2Fwsl-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LorhanSohaky%2Fwsl-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LorhanSohaky%2Fwsl-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LorhanSohaky%2Fwsl-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LorhanSohaky","download_url":"https://codeload.github.com/LorhanSohaky/wsl-manager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248878020,"owners_count":21176242,"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":["disk-space","recovery","vhdx","vhdxfiles","windows-subsystem-for-linux","windows-subsystem-linux","wsl","wsl-manager","wsl2"],"created_at":"2024-10-15T11:09:42.935Z","updated_at":"2025-04-14T11:55:51.955Z","avatar_url":"https://github.com/LorhanSohaky.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# WSL Manager\n\n**An easy way to maintain your WSL distros**\n\nIt allows you to shrink your distro and move it to another drive or path\n\n[Features](#features) |\n[Installation](#installation) |\n[Usage](#usage) |\n[License](#license) |\n[Contributing](#contributing)\n\n\u003c/div\u003e\n\n## Status\n\u003ca href=\"https://github.com/LorhanSohaky/wsl-manager/blob/master/LICENSE.md\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/LorhanSohaky/wsl-manager?style=flat-square\"\u003e\u003c/a\u003e\n\u003cimg src=\"https://img.shields.io/badge/OS-windows-blue??style=flat\u0026logos=Windows\u0026logoColor=b0c0c0\u0026labelColor=363D44\u0026style=flat-square\" alt=\"Operating systems\"/\u003e\n\u003ca href=\"https://github.com/LorhanSohaky/wsl-manager/issues\"\u003e\u003cimg alt=\"Issues\" src=\"https://img.shields.io/github/issues/LorhanSohaky/wsl-manager?style=flat-square\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/LorhanSohaky/wsl-manager/pulls\"\u003e\u003cimg alt=\"Pull requests\" src=\"https://img.shields.io/github/issues-pr/LorhanSohaky/wsl-manager?style=flat-square\"\u003e\u003c/a\u003e\n\n## Features\n\n- Shrink your distro\n- Move your distro to another drive or path\n- Restore your distro from a vhdx file\n\n## Installation\n\nDownload the latest release from the [releases page](https://github.com/LorhanSohaky/wsl-manager/releases/latest).\n\nIf you only want to execute the `wsl-manager`, you can download the `wsl-manager.zip` file, extract it and run the `wsl-manager.exe` file.\n\n### Custom build\n\nIf you want to build the project yourself, you will need clone the repository and install the dependencies. Here is the commands you need to run:\n\n```bash\npoetry install\npoetry shell\n```\n\nAfter that, you can run the `build` script to build the project:\n\n```bash\npoe build\n```\n\n\n## Usage\n\nWhen you run the `wsl-manager.exe` file, you will see the following [menu](#main-menu). Here you can choose between shrink and move options.\n\n\u003ca name=\"main-menu\"\u003e![Main menu](docs/img/main-menu.png)\u003c/a\u003e\n\n### Shrinking\n\nWhen selecting the shrink option, you will select the distro you want to shrink. After that, you will see the script that will be executed. If you want to continue, just press any key. As you can see in the [image below](#srink-script).\n\n\u003ca name=\"srink-script\"\u003e![Shrink script](docs/img/shrink-script.png)\u003c/a\u003e\n\n### Moving\n\nWhen selecting the move option, you will select the distro you want to move. After that, you will need to select the strategy that you want to use. You can choose between `tar file` and `windows registry`. As you can see in the [image below](#move-strategies).\n\n\n\u003e **Warning**\n\u003e\n\u003e The `tar file` strategy uses official `wsl` commands and was used by a lot of people. Nevertheless some people had weird issues that resulted in broken WSL disks.\n\u003e Make sure you have a backup of your data, so you can restore in case of an error.\n\n\u003cdetails\u003e\u003csummary\u003eTechnical details\u003c/summary\u003e\n\u003cp\u003e\n\nIf you choose `tar file`, internally the code will run `wsl` commands to `export` the distro to a tar file and then `import` the distro from the tar file into the new path. Finally, some `windows registry` keys will be changed to keep the same default user.\n\nIf you choose `windows registry`, the code will move the `ext4.vhdx` file to the new path and change the `windows registry` keys that point to the distro path. This is the fastest way to move the distro, **but it should be used at your own risk** because it not used by default by the `wsl`. Finally, some `windows registry` keys will be changed to keep the same default user.\n\u003c/p\u003e\n\u003c/details\u003e\n\n\u003ca name=\"move-strategies\"\u003e![Move strategies](docs/img/move-strategies.png)\u003c/a\u003e\n\n### Restoring\n\nWhen selecting the restore option, you will select the vhdx file of the distro you want to restore. After that, you will input the name of the distro and others information.\n\n## License\n\nThis project follows the [MIT license](LICENSE.md).\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details the process for submitting pull requests to us.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Florhansohaky%2Fwsl-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Florhansohaky%2Fwsl-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Florhansohaky%2Fwsl-manager/lists"}