From c202f5ad1d812226e4dff98a90d2dfb20697ef6c Mon Sep 17 00:00:00 2001 From: Nicholas O'Connor Date: Wed, 12 Apr 2017 11:27:14 -0700 Subject: [PATCH] somehow i never included a readme --- README.md | 37 +++++++++++++++++++++++++++++++++++++ cogrc | 2 +- 2 files changed, 38 insertions(+), 1 deletion(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ccf0646 --- /dev/null +++ b/README.md @@ -0,0 +1,37 @@ +# cellar +### bottle management tool for WINE connoisseurs + +## Installation +```sh +$ mkdir build && cd build +$ cmake .. +$ make -j4 +$ sudo make install +``` + +## Quick Usage Primer +```sh +$ 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 `. 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)[LICENSE]. diff --git a/cogrc b/cogrc index 84f00c7..252f51d 100644 --- a/cogrc +++ b/cogrc @@ -1,3 +1,3 @@ [version] release=no -release_version=0.2 +release_version=0.3