Skip to main content

Manage Wine environments

Project description

winenv is an environment manager for Wine.

It automates the management of different Wine architectures, locales, and prefixes.

Dependendies

  • Python 3

Installation

System-wide or for packaging:

python setup.py install

For the current user:

python setup.py install --user

You will have to add ~/.local/bin to your shell’s PATH if it isn’t present already; this is where Python installs scripts for users.

Shell setup

You need to set up your shell as well. winenv works with POSIX sh or any compatible shell (Bash, ZSH, etc.).

Put the following in your configuration file:

wenv() {
    eval "$(winenv load $1)"
}

wenvoff() {
    eval "$(winenv reset)"
}

fish shell is also supported:

function wenv -a env_name
  eval (winenv load --shell fish $env_name)
end

function wenvoff
  eval (winenv reset --shell fish)
end

Usage

Adding environments

First, you add environments:

$ winenv add program1 -a win32 -l en_US.UTF-8 -p ~/.local/share/wineprefixes/program1

This adds an environment named program1, with the associated environment variables WINEARCH=win32, LANG=en_US.UTF-8, WINEPREFIX=~/.local/share/wineprefixes/program1.

The options are optional. -a defaults to win32, -l defaults to en_US.UTF-8, and -p defaults to ~/.local/share/wineprefixes/<name of environment>.

The default architecture and locale can be configured (see Configuration section). In particular, you should configure the default locale to match your system.

Here are some more examples:

$ winenv add touhou -a win32 -l ja_JP.UTF-8
$ winenv add photoshop -a win64
$ winenv add testing -p ~/temp

Loading environments

You can load an environment using the shell function defined previously:

$ env | egrep -i "lang|wine"
LANG=en_US.UTF-8

$ wenv touhou
$ env | egrep -i "lang|wine"
LANG=ja_JP.UTF-8
WINEPREFIX=/home/user/.local/share/wineprefixes/touhou
WINEARCH=win32

$ wenv photoshop
$ env | egrep -i "lang|wine"
LANG=en_US.UTF-8
WINEPREFIX=/home/user/.local/share/wineprefixes/photoshop
WINEARCH=win64

After loading an environment, you can use wine and winecfg freely without worrying about your Wine environment.

Listing environments

You can list existing environments:

$ winenv list
touhou
photoshop

Verbose listing:

$ winenv list -v
touhou
prefix=/home/user/.local/share/wineprefixes/touhou
arch=win32
lang=ja_JP.UTF-8

photoshop
prefix=/home/user/.local/share/wineprefixes/photoshop
arch=win64
lang=en_US.UTF-8

Resetting environments

You can reset Wine environment settings using the shell function defined previously:

$ env | egrep -i "lang|wine"
LANG=en_US.UTF-8

$ wenv touhou
$ env | egrep -i "lang|wine"
LANG=ja_JP.UTF-8
WINEPREFIX=/home/user/.local/share/wineprefixes/touhou
WINEARCH=win32

$ wenvoff
$ env | egrep -i "lang|wine"
LANG=en_US.UTF-8

More help

Make use of the --help option as needed.

Configuration and data

winenv stores its data in a configuration file. The default path is ~/.config/winenv/config.ini. You can supply a different file via the --config option.

The configuration file uses the INI format, as parsed by Python’s configparser module.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mir.winenv-0.3.1.tar.gz (8.6 kB view details)

Uploaded Source

Built Distribution

mir.winenv-0.3.1-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file mir.winenv-0.3.1.tar.gz.

File metadata

  • Download URL: mir.winenv-0.3.1.tar.gz
  • Upload date:
  • Size: 8.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for mir.winenv-0.3.1.tar.gz
Algorithm Hash digest
SHA256 67f6729409f296a713b55d31261ea1fc146b13c5813cd474cc10c71c469c18fc
MD5 8ddcc569ec97d0644abdfd74866e238d
BLAKE2b-256 e0357cd0b4dd114cef28aa2695936d5d507077cd22bdaaeb5e854a24761c3971

See more details on using hashes here.

File details

Details for the file mir.winenv-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mir.winenv-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 57baf05bd248591a7f82b4959656c6f7044104d323f2b8e0d9f06f138040015d
MD5 886731072ad4e063ef9ed469272e4766
BLAKE2b-256 8107f8ae0089919e214972134c4827fffd22f78f6fd0aee2cf87db62d8cdc2b0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page