Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: about 1 month 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 (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-05-01T07:15:57.000Z (8 months ago)
- Last Synced: 2024-05-01T09:42:38.681Z (8 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: 33.2 MB
- Stars: 5,851
- Watchers: 35
- Forks: 255
- Open Issues: 362
-
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)
README
Bottles
Run Windows Software on Linux
![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 com.usebottles.bottles.yml` in the terminal from the root of the repository (use `--user` if necessary)
1. Run `flatpak run com.usebottles.bottles//master` 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//master` from the root of the repository, followed by `./utils/install.sh`. This will build Bottles and install it under the `build/` directory.
3. Run `./build/bin/bottles` to launch BottlesDue 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.