{"id":15032585,"url":"https://github.com/bottlesdevs/bottles","last_synced_at":"2026-01-25T07:11:34.529Z","repository":{"id":36971042,"uuid":"106949285","full_name":"bottlesdevs/Bottles","owner":"bottlesdevs","description":"Run Windows software and games on Linux","archived":false,"fork":false,"pushed_at":"2025-04-13T12:55:45.000Z","size":36880,"stargazers_count":7039,"open_issues_count":564,"forks_count":297,"subscribers_count":38,"default_branch":"main","last_synced_at":"2025-05-12T13:19:46.936Z","etag":null,"topics":["appimage","archlinux","bottles","bottles-versioning","dxvk","games","gaming","linux","msi","ppa","proton","python","wine","wine-prefixes","wineprefix","wineprefix-manager"],"latest_commit_sha":null,"homepage":"https://usebottles.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bottlesdevs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"liberapay":"Bottles","github":["bottlesdevs"],"custom":["https://usebottles.com/funding"]}},"created_at":"2017-10-14T17:42:31.000Z","updated_at":"2025-05-11T20:39:03.000Z","dependencies_parsed_at":"2023-12-13T08:57:19.737Z","dependency_job_id":"40c32b95-de59-41d3-9451-ffb650c930d9","html_url":"https://github.com/bottlesdevs/Bottles","commit_stats":null,"previous_names":[],"tags_count":205,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlesdevs%2FBottles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlesdevs%2FBottles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlesdevs%2FBottles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlesdevs%2FBottles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bottlesdevs","download_url":"https://codeload.github.com/bottlesdevs/Bottles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745197,"owners_count":21957320,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appimage","archlinux","bottles","bottles-versioning","dxvk","games","gaming","linux","msi","ppa","proton","python","wine","wine-prefixes","wineprefix","wineprefix-manager"],"created_at":"2024-09-24T20:18:47.035Z","updated_at":"2026-01-25T07:11:34.500Z","avatar_url":"https://github.com/bottlesdevs.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/bottlesdevs/Bottles/main/data/icons/hicolor/scalable/apps/com.usebottles.bottles.svg\" width=\"64\"\u003e\n  \u003ch1 align=\"center\"\u003eBottles\u003c/h1\u003e\n  \u003cp align=\"center\"\u003eRun Windows Software on Linux\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://flathub.org/apps/com.usebottles.bottles\"\u003e\n    \u003cimg alt=\"Flathub\" src=\"https://img.shields.io/flathub/downloads/com.usebottles.bottles\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://hosted.weblate.org/engage/bottles\"\u003e\n    \u003cimg src=\"https://hosted.weblate.org/widgets/bottles/-/bottles/svg-badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.codefactor.io/repository/github/bottlesdevs/bottles/overview/main\"\u003e\n    \u003cimg src=\"https://www.codefactor.io/repository/github/bottlesdevs/bottles/badge/main\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/bottlesdevs/Bottles/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-GPL--3.0-blue.svg\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://stopthemingmy.app\" title=\"Please do not theme this app\"\u003e\n    \u003cimg src=\"https://stopthemingmy.app/badge.svg\"\u003e\n  \u003c/a\u003e\n\n  \u003chr /\u003e\n\n  \u003ca href=\"https://docs.usebottles.com\"\u003eDocumentation\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/orgs/bottlesdevs/discussions\"\u003eForums\u003c/a\u003e ·\n  \u003ca href=\"https://discord.gg/wF4JAdYrTR\"\u003eDiscord\u003c/a\u003e ·\n  \u003ca href=\"https://usebottles.com/funding\"\u003eFunding\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n![Bottles Dark](docs/screenshot-dark.png#gh-dark-mode-only)![Bottles Light](docs/screenshot-light.png#gh-light-mode-only)\n\n## Installation\n\n\u003ca href='https://flathub.org/apps/com.usebottles.bottles'\u003e\u003cimg width='240' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png'/\u003e\u003c/a\u003e\n\n## Contributing\n\nRefer to the [Contributing](CONTRIBUTING.md) page.\n\n## Building\n\n⚠️ Be sure to backup all your data before testing experimental builds of Bottles!\n\nThere 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.\n\n### org.flatpak.Builder\n\n1. Install [`org.flatpak.Builder`](https://github.com/flathub/org.flatpak.Builder) from Flathub\n1. Clone `https://github.com/bottlesdevs/Bottles.git` (or your fork)\n1. 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)\n1. Run `flatpak run com.usebottles.bottles.Devel` to launch it\n\n### Meson\n\nSince Bottles is primarily and officially distributed as a Flatpak, we only provide instructions to directly build it inside a Flatpak environment:\n\n1. 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)\n2. 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.\n3. Run `./build/bin/bottles` to launch Bottles\n\nDue 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.\n\n## Code of Conduct\nThis 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.\n\n## Sponsors\n\u003ca href=\"https://www.jetbrains.com/?from=bottles\"\u003e\u003cimg height=\"55\" src=\"https://unifiedban.solutions/static/images/jetbrains-logos/jetbrains.png\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://www.gitbook.com/?ref=bottles\"\u003e\u003cimg height=\"55\" src=\"https://www.gitbook.com/cdn-cgi/image/height=55,fit=contain,dpr=1,format=auto/https%3A%2F%2F2775338190-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNkEGS7hzeqa35sMXQZ4X%252Flogo%252FTO5E3RjWKeaJmYYWMGWV%252Fspaces_gitbook_avatar-rectangle.png%3Falt%3Dmedia%26token%3Da34e957e-f044-4bee-abee-23946d2e9cfb\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://www.linode.com/?from=bottles\"\u003e\u003cimg height=\"48\" src=\"https://usebottles.com/uploads/linode-brand.png\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003ca href=\"https://appwrite.io?from=bottles\"\u003e\u003cimg height=\"48\" src=\"https://usebottles.com/uploads/built-with-appwrite.svg\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://hyperbit.it?from=bottles\"\u003e\u003cimg height=\"48\" src=\"https://hyperbit.it-mil-1.linodeobjects.com/assets/full_dark_logo/HyperBit_Dark_Extended_Logo.png\"/\u003e\u003c/a\u003e\n","funding_links":["https://liberapay.com/Bottles","https://github.com/sponsors/bottlesdevs","https://usebottles.com/funding"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbottlesdevs%2Fbottles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbottlesdevs%2Fbottles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbottlesdevs%2Fbottles/lists"}