WEM Tips
→ wem help
Running wem help
will print out detailed information of all arguments and subcommands.
→ wem man
The WEM manpage can be accessed via the wem man
command. It should serve as an offline reference for WEM commands and options.
→ wem tutorial
The WEM tutorial is a short guide that's built into WEM and accessed via the wem tutorial
command.
It's meant to be a quick introduction to the usage patterns of WEM, and to give you an idea of the sort of things that can be done.
→ Shell Completions
The wem completion
command can generate shell completions for fish
or bash
.
Shell completion makes using WEM much more convenient as it can help discover and explain the many available options. In particular with fish
, which has support for autocompleting not only all commands and arguments, but also for available envs and installed DXVK/VKD3D/wine versions.
→ Winetricks
Winetricks can be invoked for an env via wem run tes3 --winetricks
. WEM provides the necessary context to ensure the right prefix, wine executable, and other variables are made available to winetricks.
The protontricks tool is automatically used when umu-launcher is used.
→ Compatibility
Use these resources to find information about whether or not an application runs with wine.
- If you're having trouble getting an application an application to work with wine, try using Kron4ek Wine or umu-launcher which may have more and better compatibility out of the box than your system's wine.
- You can use gamescope to easily scale games, this can be particularly useful for older games that shipped with support for only lower resolutions.
- Valve's official issue tracker for Proton is a great place to find or open reports about game compatibility. Enter a game title or AppID in the search bar and see if anything's already been submitted.
- The Wine AppDB is another great place to look for and provide reports about compatibility.
- Lutris game installers often contain useful information about what might be required to get something working. Find your game, and click the arrow next to the button labeled "Install". This will give you a few options; select "View install script" to see a YAML-formatted file with installation steps.
If the game or program you are looking for isn't already documented, then that's a good opportunity to help change that!
→ Pre/Post Commands
WEM allows running arbitrary commands before and after both the install and run processes as described in the options documentation.
Under the hood, the cmd
and args
you supply are passed to Go's exec.Command()
. It is important to note that this is not a shell, but you can invoke a shell to use its features:
[[InstallPost]]
cmd = "sh"
args = ["-c", "mv -v foo/* bar/"]
The above snippet would run the equivalent of sh -c "mv -v foo/* bar/"
, using shell globs to move an entire directory's worth of files.
WARNING: You should exercise extreme caution when using this feature, running arbitrary commands can cause undesired results on your system if you are not careful!
→ Recommended Reading
These references will help you better understand the various patterns around working with wine.