Repolode
Submit
bottlesdevs

bottlesdevs/Bottles

A GTK4/libadwaita app for Linux that manages Wine prefixes so Windows software and games can run with prepared runners and dependencies.

View on GitHubWebsite
Stars
9,053
Forks
385
Open issues
32
Last commit
yesterday

What is it?

Bottles is a Linux desktop application for running Windows software and games. It organizes Wine prefixes, called bottles, each with its own runner, components and settings, so applications can be installed and launched without manually configuring Wine.

The project is written in Python and uses GTK4 with libadwaita for its interface. Its topics point to supporting tools commonly used in this space, including DXVK, Proton and MSI installers, and the app is distributed mainly as a Flatpak through Flathub.

The repository includes a development Flatpak manifest for building from source, along with instructions for building a release locally from the Flathub manifest. Contributions follow a documented process and an AI-assisted commit format.

Key features

  • 01Manages separate Wine prefixes (bottles) with their own runners and settings.
  • 02Built with GTK4 and libadwaita for a native GNOME-style interface.
  • 03Distributed as a Flatpak via Flathub, with a development build option.
  • 04Supports DXVK, Proton and MSI installers as part of the Wine setup.

Use cases

  • Running Windows games on a Linux desktop without manually managing Wine.
  • Installing Windows applications that need isolated Wine environments.
  • Testing or developing Bottles itself using the Flatpak development manifest.

Quick start

  1. 1

    Install Bottles from Flathub using the Download on Flathub badge

  2. 2

    Launch Bottles from your application menu

Things to know

  • Bottles is a Linux-only app, so it does not run on Windows or macOS.
  • The README officially supports only Flatpak distribution, and building it outside a Flatpak environment is involved.
  • Experimental builds may break data, so the README advises backing up your data before testing them.

Topics

#wine#linux#gaming#windows-compatibility#flatpak#gtk#python#bottles#bottles-versioning#dxvk

FAQ

What is Bottles?
A GTK4/libadwaita app for Linux that manages Wine prefixes so Windows software and games can run with prepared runners and dependencies. Bottles is a Linux desktop application for running Windows software and games. It organizes Wine prefixes, called bottles, each with its own runner, components and settings, so applications can be installed and launched without manually configuring Wine.
Is Bottles free to use? What license does it have?
Bottles is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is Bottles still maintained?
Actively maintained. The last commit to Bottles was on Nov 6, 2026.
What can I use Bottles for?
Running Windows games on a Linux desktop without manually managing Wine. Installing Windows applications that need isolated Wine environments. Testing or developing Bottles itself using the Flatpak development manifest.
How do I install Bottles?
Install Bottles from Flathub using the Download on Flathub badge Launch Bottles from your application menu
Where can I get Bottles?
The source code and installation instructions are on GitHub: https://github.com/bottlesdevs/Bottles

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects