https://github.com/bottlesdevs/Bottles

Run Windows software and games on Linux
https://github.com/bottlesdevs/Bottles

appimage archlinux bottles bottles-versioning dxvk games gaming linux msi ppa proton python wine wine-prefixes wineprefix wineprefix-manager

Last synced: 28 days ago
JSON representation

Run Windows software and games on Linux

• Host: GitHub
• URL: https://github.com/bottlesdevs/Bottles
• Owner: bottlesdevs
• License: gpl-3.0
• Created: 2017-10-14T17:42:31.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-10-29T07:16:05.000Z (6 months ago)
• Last Synced: 2024-10-29T15:04:48.843Z (6 months ago)
• Topics: appimage, archlinux, bottles, bottles-versioning, dxvk, games, gaming, linux, msi, ppa, proton, python, wine, wine-prefixes, wineprefix, wineprefix-manager
• Language: Python
• Homepage: https://usebottles.com
• Size: 34 MB
• Stars: 6,360
• Watchers: 40
• Forks: 267
• Open Issues: 471
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: COPYING.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-steam-deck - Bottles - Run Windows software and games under Linux. (Launcher)
• awesome-starred - bottlesdevs/Bottles - Run Windows software and games on Linux (Python)

README

        


  

  
Bottles

  
Run Windows Software on Linux








  

    

  

  

    

  

  

    

  

  

    

  

  


  

    

  


  


  Documentation ·

  Forums ·

  Discord ·

  Funding






![Bottles Dark](docs/screenshot-dark.png#gh-dark-mode-only)![Bottles Light](docs/screenshot-light.png#gh-light-mode-only)

## Installation



## Contributing

Refer to the [Contributing](CONTRIBUTING.md) page.

## Building

⚠️ Be sure to backup all your data before testing experimental builds of Bottles!

There are two methods to build Bottles. The first and longer method is using `org.flatpak.Builder`, and the second but shorter method is building directly.

### org.flatpak.Builder

1. Install [`org.flatpak.Builder`](https://github.com/flathub/org.flatpak.Builder) from Flathub

1. Clone `https://github.com/bottlesdevs/Bottles.git` (or your fork)

1. Run `flatpak run org.flatpak.Builder --install --install-deps-from=flathub --default-branch=master --force-clean build-dir build-aux/com.usebottles.bottles.Devel.json` in the terminal from the root of the repository (use `--user` if necessary)

1. Run `flatpak run com.usebottles.bottles.Devel` to launch it

### Meson

Since Bottles is primarily and officially distributed as a Flatpak, we only provide instructions to directly build it inside a Flatpak environment:

1. Download and install the latest build of Bottles: [bottles-x86_64.zip](https://nightly.link/bottlesdevs/Bottles/workflows/build_flatpak/main/bottles-x86_64.zip). Unzip it, and run `flatpak install bottles.flatpak` (use `--user` if necessary)

2. Run `flatpak run -d --filesystem=$PWD --command=bash com.usebottles.bottles.Devel` from the root of the repository, followed by `./build-aux/install.sh`. This will build Bottles and install it under the `build/` directory.

3. Run `./build/bin/bottles` to launch Bottles

Due to GNOME Builder limitations, Builder cannot build Bottles for the time being; see [GNOME/gnome-builder#2061](https://gitlab.gnome.org/GNOME/gnome-builder/-/issues/2061) for more context. This is the best workaround we can provide.

## Code of Conduct

This project follows the [GNOME Code of Conduct](https://wiki.gnome.org/Foundation/CodeOfConduct). You are expected to follow it in all Bottles spaces, such as this repository, the project's social media, messenger chats and forums. Bigotry and harassment will not be tolerated.

## Sponsors