Skip to content

Commit

Permalink
Guide improvements
Browse files Browse the repository at this point in the history
  • Loading branch information
IsaacMarovitz committed Apr 3, 2024
1 parent 589ffc5 commit dfa5b1b
Showing 1 changed file with 16 additions and 6 deletions.
22 changes: 16 additions & 6 deletions src/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@

Glad you're here. Here's how to get up and running in a breeze.

1. Download Whisky
- Download the latest release [here](https://github.com/IsaacMarovitz/Whisky/releases)
1. [Download Whisky](https://github.com/IsaacMarovitz/Whisky/releases)
2. Move Whisky to your Applications folder
3. Open Whisky
4. Follow on-screen instructions
Expand All @@ -12,7 +11,9 @@ Glad you're here. Here's how to get up and running in a breeze.

## Making your first bottle

Bottles are the bread and butter of Wine. Bottles are like little Windows filesystems, and they appear on your computer as a normal folder. In a bottle, you'll find programs, registry files, and everything else you need to install and configure your Windows 'machine'. Each bottle is self-contained and will only have the programs you installed in that bottle.
Bottles are the bread and butter of Wine. Bottles are like little Windows filesystems, and they appear on your computer as a normal folder.
In a bottle, you'll find programs, registry files, and everything else you need to install and configure your Windows 'machine'.
Each bottle is self-contained and will only have the programs you installed in that bottle.

1. Press the plus button in the top right-hand corner
2. Give your bottle a name, and select the Windows version you want
Expand All @@ -22,7 +23,8 @@ Bottles are the bread and butter of Wine. Bottles are like little Windows filesy

Programs are installed much like you would on a regular Windows machine.

1. Download the program you want to run. It should be the *Windows* version (`.exe` or `.msi`); 64-bit programs are preferable
1. Download the program you want to run. It should be the *Windows* version (`.exe` or `.msi`);
> 64-bit programs are preferable.
2. Click on the bottle you want to install your program into
3. Press the `Run...` button in the bottom right
4. Navigate to where you downloaded your `.exe` or `.msi` file in Finder
Expand All @@ -32,8 +34,16 @@ Whisky will then open and run the program. It may take a few seconds for the win

## Configuring your bottle

In the `Config` menu of your bottle, you can adjust a number of parameters, including the Windows version and build the number of your bottle, enable and disable the Metal HUD, configure ESync, and open Wine's many configuration tools like the Control Panel, Registry Editor, and Wine Configuration dialogues.
In the `Config` menu of your bottle, you can adjust a number of parameters,
including the Windows version and build the number of your bottle, enable and disable the Metal HUD,
configure ESync, and open Wine's many configuration tools like the Control Panel, Registry Editor, and Wine Configuration dialogues.

## When should I make a new bottle?

The usual convention is to limit a bottle to one game, as dependencies and such can get messy with more installed in one place. If a game requires more extensive configuration to get working, it's usually a good idea to keep it contained. Overal, trust your judgment and separate where it feels right.
The usual convention is to limit a bottle to one game, as dependencies and such can get messy with more installed in one place.
If a game requires more extensive configuration to get working, it's usually a good idea to keep it contained.
Overall, trust your judgment and separate where it feels right.

For Steam games, you can create one shared Windows game library that you use between all of your bottles.
This helps keep your game installations detached from your bottle instances,
so you won't have to re-download everything if your bottle mucks up.

0 comments on commit dfa5b1b

Please sign in to comment.