]winerun v1.3
After years of using PoL and Lutris I wrote this shell-script to have a faster, simpler and more intuitive way to start and manage my many wine-prefixes.
Its for all those who like to work from the command line without all the unnecessary ballast a GUI ships with.
install with:
chmod a+x winerun/winerun
sudo cp winerun/winerun /usr/local/bin/
see first post for general description
- this is intended as a cmd-line only addition or replacement for PoL or Lutris
- this is mainly for wine users that need a fast way to manage different WINEPREFIXes from the shell prompt or script
- it will use present PREFIXes and some parameters from Lutris configuration (mainly wine-version) if found
- it can also create new WINEPREFIX independetly from Lutris,PoL
- it does not alter the PREFIX’s configuration other than using a different wine-version if changed with ‘version’
you should now be able to simply run any exe in its existing WINEPREFIX with:
winerun
if more than one is found all alternatives are printed out.
if you prefix isn’t found than either cd into a prefix or prefix-collection folder or define the WINEDRIVES enviroment var with a comma separated list of prefix collection folders.
best added to ~/.bashrc : (example)
export WINEDRIVES="/home/user1/WinePrefixes /media/User1/wingames"
There are many more options - especial useful is ‘winerun copy’ and to create symbolic links to either the prefix winerun copy or the original winrun
Enjoy
winerun -- wine cmdline tool
version 1.3
* no need to set WINEPREFIX or "cd" into the right folder
* easy version management
* auto-restores screen-size if changed within wine
* intuitive, small and fast
syntax:
winerun [gdb|dbg|dryrun|copy] [[version] <wineversion>|wine|lutris>] [prefix] <wineprefix>|<exe> [new] [cd] [[exec] <exe>|<shellscript>] [<args>]
winerun [gdb|dbg|dryrun] [[version] <wineversion>]|wine|lutris>] [prefix] <wineprefix>|<exe> [cd] [winecfg|regedit|msiexec|regsvr32|reg|cmd|winetricks|noteapad] [<args>]
winerun [dryrun] [prefix] <wineprefix>|<exe> [edit|firefox|gimp|kill|suspend|resume] <args>
<exe name> [gdb|dbg|dryrun] [[version] <wineversion>|wine|lutris>] [[exec <exe>|<shellscript>]|winecfg|regedit|msiexec|regsvr32|reg|cmd|winetricks|noteapad|edit|firefox|gimp] [<args>]
with:
- <wineprefix>: either a full path or defined in WINEDRIVES
- <exe>: a full or partitional path with shell patterns (*?) with or without ".exe" extensions
- <exe name>: renamed/liked winerun with the filename of any *.exe inside of a prefix with or without ".exe" extensions
- copy: copies the winrun script to <prefix>/<exe without path> to be started with that script by calling it directly or symolic linking it
- copy additonal creates <prefix>/<exe without path>.desktop file (does not overwrite existing file)
- if both wrestool (icoutils) and convert (ImageMagic) are installed copy creates an <exe>.png iconfile from the windows icon (no overwrite)
- can be killed, resumed or suspended - kill can have a different signal than default 9 as argument
- <shellscript>: a full or partitional path with shell patterns with ".sh" extensions
- <wineversion>: either a folder defined in WINERUNNERS or a number used as pattern in the same WINERUNNERS folders
- cd: changes dir to the same folder the <exe> is found or to <prefix>/drive_c if no <exe> is given
- new: creates new prefix (in the first WINEDRIVES folder if no absolute path is given)
- dpg / gdb use internal or gdb as debugger
- dryrun: do not execute or create anything (apart from .sh scripts in <prefix>) but print-out the actions
- also "wine" or "lutris" can be used for version: it removes any saved version and default to either system wine or the lutris version defined in .yml
- when "exec" is not used then "cd" is assumed
- all exept <prefix> ignore case distinction
- if only prefix is given then it will try to find the exe and path from a Lutris .yml configuration
- in most places "find" is used to find the file if no absolute path is given
- will not follow linked folders
- if more then one alternative is found then the command will be interupted and the alternatives printed on screen
examples:
winerun GRunner
winerun GRunner kill
winerun 4.24 grunner -fullscreen y
winerun version 4.24 prefix WGame cd exec grunner.exe -fullscreen y -playnet 2
winerun wine ~/WPrefixes/WGame new exec /media/user1/CD1/Setup.exe
winerun Grun* notepad readme.txt
winerun version lutris-4.21-x86_64 WGame Bin/Release/GRunner
winerun GRunner.exe edit gfx.ini
winerun dryrun GRunner.exe regedit myconfig.reg
winerun lutris WGame exec lvlEdit
winerun WGame gimp image/sell0.png
winerun copy 4.24 GRun* -fullscreen y
./WGame/GRunner -playnet 2
env vars: (auto-assigned)
WINEDRIVES (/files/Games)
WINERUNNERS (/files/wine)
WINE (wine)
WINEEDITOR (/usr/bin/mcedit)
<prefix>/winerun.sh file:
- will contain the last WINE=<version>
- can also contain any user-defined script like "export WINEDEBUG=+loaddll"
- will be removed when empty
- can use relative path for wine binary with <prefix> as start (to use as bottle)
<prefix>/<exe name without .exe>.sh file:
- shellscript will be sourced before running exe with the same name
- autoupdates with options="<cmdline options>" when "copy" is used
vars to be used with the above .sh scripts:
noscreen_restore=1 (disables the auto restore screensize feature)
options="<args to exe>" (will by prefixed to cmdline args)
<prefix>/<exe name without .exe>.lua file:
- will call lua with the script and the wine exe call as arguments
- non zero exit status will stop winerun
- will be ignored while dryrun
linked/renamed winerun:
- linked/renamed winerun will run winerun with <filename> as <exe>
- renamed copy of winerun in a WINEPREFIX will be used as <exe> inside of the prefix (can be created with: 'winerun copy' )
- above copy can be symbolical linked (link name can be anything)Download: