Bottles

Easily run Windows Software using Bottles

---

Documentation · Forums · Discord · Funding

📚 Documentation

Before opening a new issue, check if the topic has already been covered in our documentation.

Please note that some pages of the documentation are still being written.

🗣 Help Bottles speak your language

Read here how to translate Bottles to your language or how to help improve existing ones.

🦾 Features

• Create bottles based on environments (a set of rules and dependencies)
• Access to a customizable environment for all your experiments
• Automated installers
• Run every executable (.exe/.msi/.bat) in your bottles, using the context menu in your file manager
• Integrated management and storage for executable file arguments
• Support for custom environment variables
• Simplified DLL overrides
• Manage and install multiple wine/proton/dxvk versions and on-the-fly change
• Various optimizations for better gaming performance (esync, fsync, dxvk, cache, shader compiler, offload ... and much more.)
• Tweak different wine prefix settings, without leaving Bottles
• Automated dxvk installation
• System for checking runner updates for the bottle and automatic repair in case of breakage
• Integrated Dependencies installer with compatibility check based on a community-driven repository
• Detection of installed programs
• Integrated Task manager for wine processes
• Easy access to ProtonDB and WineHQ for support
• Configurations update system across Bottles versions
• Backup and Import bottles from older version and from other managers (Lutris, POL, ..)
• Bottles versioning
• ... and much more that you can find by installing Bottles!

🚧 Work in progress

• Layers (dependencies and programs on different layers) #510

↗️ Install

Bottles is officially provided as Flatpak.

Read here how to install Bottles on your distribution.

Shortcuts

Shortcut	Action
Ctrl+Q	Close Bottles
Ctrl+R	Reload the Bottles list
F1	Go to the documentation
Esc	Go back

FAQ

• Why Bottles?
• Where is Winetricks?
• Older versions will be deprecated?
• Backward compatibility?

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, project's social media, messenger chats and forums. Bigotry and harassment will not be tolerated.

Sponsors