Go to file
Nicole O'Connor 81732eab03 fix incorrect license value in RPM 2024-03-18 18:35:58 -07:00
cmake/Modules cmake update 2018-03-13 20:30:47 -07:00
doc Update copyright years in man page 2019-05-15 18:08:38 -07:00
include fixed occurrence of deadname 2023-06-30 17:34:16 -07:00
packaging fix incorrect license value in RPM 2024-03-18 18:35:58 -07:00
src cellar create will now create ~/.local/share/cellar if it does not already exist 2023-06-30 17:34:46 -07:00
.gitignore fix *.in files being mistakenly ignored by git, fixed missing cmake.hpp.in 2023-06-30 17:18:19 -07:00
CMakeLists.txt translates windows drive letters to canonical paths 2019-05-15 18:03:15 -07:00
LICENSE clarifying this is MIT code 2017-03-28 12:45:00 -07:00
README.md honestly the mirror line is both inaccurate and silly 2023-06-30 17:48:20 -07:00
cogrc undo erroneous version bump 2018-03-13 20:59:11 -07:00

README.md

cellar

bottle management tool for WINE connoisseurs

(this software is considered unfinished, use at own risk)

Installation

$ mkdir build && cd build
$ cmake ..
$ make -j4
$ sudo make install

cellar also supports the use of clang as your compiler and/or ninja as your make system, for those of you who have opinions on such things.

Quick Usage Primer

$ cellar create steam
$ cellar -b steam winetricks vcrun2012

# without the -b argument, cellar assumes you want to deal with ~/.wine
# you can manage which bottle that points to with this command
$ cellar activate steam

# arguments passed to "cellar launch" are passed to wine
$ cellar launch /mnt/windows/Steam/Steam.exe

Features

  • Corking: Saves a bottle's configuration, including any pressed installers (see below) or installed winetricks, to a directory, then removes the WINE bottle from disk. You can then easily rebuild that WINE bottle later by uncorking it, which will automatically rebuild the WINE bottle with your active (or specified) version of WINE, as well as install any saved winetricks or run any pressed installers.
  • Pressed Installers: Saves a copy of an installer to ~/.cellar, writes it down in the bottle configuration, then runs it within your WINE bottle. If you choose to cork this bottle later, this installer will automatically be run after uncorking. If the installer comes with "unattended install" arguments, it's recommended you press those in too.
  • Easy WINE and bottle management: Need a specific bottle for a specific program? cellar -b bottlename <command>. Does the bottle need to run a specific instance of WINE? cellar config wine-path /opt/wine-specific/bin/wine. Confused about which bottle is "active"? cellar active will tell you. Different programs may need drastically different WINE configurations, but that doesn't mean you need the drastic headaches.

License

Cellar is available under the MIT license.