bottlesdevs /Bottles

Run Windows software and games on Linux

★ 9,083⑂ 386👁 37⑃ 1,206● 3,249▤ 233
PythonGPL-3.0Created 2017-10-14usebottles.com
Download: 67.667.6 ↓67.62026-11-04
+1
Daily
9,083
stars
386
forks
37
watchers
1,206
prs
3,249
issues
233
releases

README

Bottles
  Run Windows Software on Linux





  
  
  
  
  
  

  

  Documentation ·
  Forums ·
  Discord ·
  Funding




!Bottles Dark!Bottles Light

 Installation




 Contributing

Refer to the Contributing page.

 Building

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

Use the development manifest in this repository when working on Bottles. To build a stable release locally, use the manifest maintained by Flathub.

 Development Flatpak

1. Install org.flatpak.Builder from Flathub
2. Clone https://github.com/bottlesdevs/Bottles.git (or your fork)
3. 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)
4. Run flatpak run com.usebottles.bottles.Devel to launch it

 Release Flatpak

The authoritative manifest for the stable package is maintained in the Flathub repository. It defines the Bottles source, dependencies, runtime, and permissions used for each release.

1. Install org.flatpak.Builder from Flathub
2. Clone https://github.com/flathub/com.usebottles.bottles.git
3. Run the following command from the root of the cloned repository:

   shell
   flatpak run org.flatpak.Builder \
     --user \
     --install \
     --install-deps-from=flathub \
     --default-branch=local \
     --force-clean \
     build-dir \
     com.usebottles.bottles.yml
   

4. Run flatpak run com.usebottles.bottles//local to launch it

The local branch is installed alongside the Flathub branch. Both use the same application ID and Bottles data directory, so changes made by either build affect the other. To build an older release, use git log -- com.usebottles.bottles.src.yaml to find and check out its Flathub commit before running the build command.

 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. 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-builder2061 for more context. This is the best workaround we can provide.

 Code of Conduct
This project follows the GNOME Code of Conduct. 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.

 Use of Generative AI
Some maintainers use generative AI tools as assistants while working in Bottles, in the spirit of Open Sou

Top issues

Discussions

Latest release

67.6 67.6 2026-11-04
What's Changed
 Added bottle moves between directories and a destination picker when duplicating bottles.
 Added per-bottle notes and library sorting by bottle name.
 Added Default, Application and System DPI scaling modes in Advanced Display Settings.
 Added optional UMU controls, support for launch wrappers and download status in the library.
 Added a playtime reset button and warnings for missing program files without removing shortcuts.
 Fixed interrupted downloads on slow connections with a longer read timeout and bounded retries.
 Fixed startup delays, repeated Battle.net launches and sa

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON