We love pull requests from everyone. By participating in this project, you agree to abide by Code of Conduct.
# Code contributions
Run the following to get started:
git clone --recursive --branch develop https://github.com/wslutilities/wslu.git ./configure.sh make sudo make res_install
wslu |-src | |-etc | | |-wsl.ico: legacy default icon for wslusc | | |-wsl-gui.ico: default icon for wslusc GUI shortcut | | |-wsl-term.ico: default icon for wslusc cli shortcut | | |-sudo.ps1: helper script for wslgsu | | |-wslsc-helper.sh: helper script for wslusc on WSL side | | \-runHidden.vbs: helper script for wslusc on Windows side | |-wslu-header: Header file of all script | \-<components>.sh: Components of script |-tests: location for script tests \-extras |-bats: testing utility |-scripts: scripts \-build |-debian: files for building .deb |-rpm: files for building .rpm |-arch: files for building Arch Linux packages \-alpine: files for building Alpine Linux packages
configure.sh is the script to complete some preprocessing task for both developing and packaging building.
Following parameter is available for developing:
-e, --env-- Environment Check, check whether it is using Fake WSL Environment, normal Linux or WSL.
-p, --prsh-- Check Status of
-P, --pkg-- Install Needed Packages required by your system for building.
Following parameter is available for package building:
--build-- helper to add the version to wslu header.
--deb <distro>-- preprocessing script for deb packages.
<distro>should be version code name like
--rpm-- preprocessing script for rpm packages.
# Build & Install
make to build executables to
out folder and manages to
make doc to build manpage only.
make clean to remove
make test to run tests.
make install to install.
make res_install to install just resources.
make uninstall to uninstall.
cd extras/scripts && ./builder-docs.sh to build docs to
Pass necessary environment variables if necessary. The default installation is in
DESTDIR: You can change the destination installation folder. It is empty by default.
PREFIX: You can change the prefix for where to install. It is
# Push Requests
Make sure that the codes changed are tested.
Then create Pull requests here.
# Financial contributions
We also welcome financial contributions in full transparency on our open collective. Anyone can file an expense. If the expense makes sense for the development of the community, it will be "merged" in the ledger of our open collective by the core contributors and the person who filed the expense will be reimbursed.
Thank you to all our backers! [Become a backer]
Thank you to all our sponsors! (please ask your company to also support this open source project by becoming a sponsor)