{"id":48813312,"url":"https://github.com/dekomote/vermouth","last_synced_at":"2026-04-14T10:01:18.987Z","repository":{"id":347157214,"uuid":"1193063799","full_name":"dekomote/vermouth","owner":"dekomote","description":"A no-frills Proton and Wine app/game launcher for KDE","archived":false,"fork":false,"pushed_at":"2026-04-03T08:09:14.000Z","size":1033,"stargazers_count":22,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-03T14:42:25.613Z","etag":null,"topics":["game","kde","launcher","linux"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dekomote.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-26T20:50:59.000Z","updated_at":"2026-04-03T08:09:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dekomote/vermouth","commit_stats":null,"previous_names":["dekomote/vermouth"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dekomote/vermouth","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekomote%2Fvermouth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekomote%2Fvermouth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekomote%2Fvermouth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekomote%2Fvermouth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dekomote","download_url":"https://codeload.github.com/dekomote/vermouth/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekomote%2Fvermouth/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31791171,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["game","kde","launcher","linux"],"created_at":"2026-04-14T10:00:58.852Z","updated_at":"2026-04-14T10:01:18.976Z","avatar_url":"https://github.com/dekomote.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build AppImage](https://github.com/dekomote/vermouth/actions/workflows/build-appimage.yml/badge.svg)](https://github.com/dekomote/vermouth/actions/workflows/build-appimage.yml)\n[![Build DEB](https://github.com/dekomote/vermouth/actions/workflows/build-deb.yml/badge.svg)](https://github.com/dekomote/vermouth/actions/workflows/build-deb.yml)\n[![Build RPM](https://github.com/dekomote/vermouth/actions/workflows/build-rpm.yml/badge.svg)](https://github.com/dekomote/vermouth/actions/workflows/build-rpm.yml)\n[![Build Flatpak](https://github.com/dekomote/vermouth/actions/workflows/build-flatpak.yml/badge.svg)](https://github.com/dekomote/vermouth/actions/workflows/build-flatpak.yml)\n[![Build Arch Package](https://github.com/dekomote/vermouth/actions/workflows/build-arch.yml/badge.svg)](https://github.com/dekomote/vermouth/actions/workflows/build-arch.yml)\n[![Build Arch Package](https://github.com/dekomote/vermouth/actions/workflows/build-arch.yml/badge.svg)](https://github.com/dekomote/vermouth/actions/workflows/build-arch.yml)\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/com.dekomote.vermouth.svg\" width=\"128\" height=\"128\" alt=\"Vermouth logo\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eVermouth\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eA no-frills game (or any Windows exe) launcher for KDE.\u003cbr\u003e\nPoint it at Windows executables and run them with Proton or Wine.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/screen1.png?t=1.0\" alt=\"Vermouth screenshot\" width=\"400\"\u003e\n  \u003cimg src=\"assets/screen2.png?t=1.0\" alt=\"Vermouth screenshot\" width=\"400\"\u003e\u003cbr\u003e\n  \u003cimg src=\"assets/screen3.png?t=1.0\" alt=\"Vermouth screenshot\" width=\"400\"\u003e\n  \u003cimg src=\"assets/screen4.png?t=1.0\" alt=\"Vermouth screenshot\" width=\"400\"\u003e\n\u003c/p\u003e\n\n## What it does\n\nVermouth keeps a list of your games and applications, paired with a Proton or Wine version. Double-click to launch. That's pretty much it.\nIt works like Lutris, Heroic, Fagus or Bottles, but:\n\n- It's KDE first (written in Qt/Qml and using Kirigami)\n- It tries to be lighter and easier to use - less buttons, checks and knobs, just the bare necessities.\n\nAdditionally:\n\n- It searches for Proton versions from your Steam installation automatically, including custom ones like GE-Proton\n- You can also download the latest GE Proton release and set everything up with one click, if you don't have Steam\n- You can place custom proton builds in its local folder (usually ~/.local/share/vermouth/protons, there's a button to open it)\n- Wine works too - just point it at the Wine binary and set a prefix folder\n- It will try to extract icons from .exe files so the grid actually looks nice, you just install `icoutils`\n- You can define launch options with `%command%` placeholder, same as in Steam (e.g. `mangohud %command%`)\n- You can run a separate .exe inside an existing prefix (useful for installers, config tools, etc.)\n- You can run the common wine utilities in the prefixes - winecfg, regedit, winetricks\n- You can create start menu entries and desktop shortcuts for individual games, and they work without opening the application window\n\n## Installing\n\nIn the [releases section](https://github.com/dekomote/vermouth/releases/latest), you can find pre-built packages:\n\n- The deb package can be used for Ubuntu 25.04 and onward\n- The rpm package can be used for Fedora 41+ and OpenSuse\n- The flatpak package and the AppImage are universal for x86_64. See [FLATPAK NOTES](#flatpak-notes)\n- You can also find a package for Archlinux as well as PKGBUILD pack\n\nI have limited testing capabilities at the moment, so please, report any bugs you might find.\n\nFor icon extraction from .exe files, install `icoutils` (provides `wrestool` and `icotool`).\n\n## Building from source\n\nYou need Qt 6 and CMake. On Fedora:\n\n```\nsudo dnf install cmake gcc-c++ extra-cmake-modules qt6-qtbase-devel qt6-qtdeclarative-devel qt6-qtquickcontrols2-devel kf6-kirigami-devel kf6-kcoreaddons-devel kf6-ki18n-devel kf6-qqc2-desktop-style\n```\n\nOn *buntu:\n\n```\nsudo apt install build-essential cmake extra-cmake-modules qt6-base-dev qt6-declarative-dev qt6-tools-dev-tools libkirigami-dev libkf6coreaddons-dev libkf6i18n-dev libkf6qqc2desktopstyle-dev\n```\n\nOn Arch and derrivatives:\n\n```\npacman -S --needed base-devel cmake ninja extra-cmake-modules qt6-base qt6-declarative kirigami ki18n kcoreaddons qqc2-desktop-style\n```\n\nThen inside the root folder of the project:\n\n```\ncmake -B build\ncmake --build build\n./build/bin/vermouth\n```\n\nFor icon extraction from .exe files, install `icoutils` (provides `wrestool` and `icotool`).\n\n## How to use it\n\nOpen the app, click the \"Add App/Game\" button on the top right, browse for the exe file, choose the Proton version in the dropdown (click Download GE Proton if you don't have any versions in the list) and then launch the game from the grid!\n\nThe optional fields can be ommited. The name, and icon will be inferred from the exe (you need icoutils for the icon), the prefix will be set based on the game name and the default prefix folder.\n\nThe launch options field lets you wrap the command with tools like mangohud, gamescope, or gamemoderun. Use `%command%` as the placeholder for where the actual game command goes. If you leave out `%command%`, your options get prepended automatically.\n\nIn the app's settings you can set the default prefix folder to your liking and add additional folders to be scanned for Proton versions.\n\n## FLATPAK NOTES\n\nWhen running Vermouth as a Flatpak, it is sandboxed and cannot access your filesystem by default. You need to grant it access to the folder(s) containing your games. You can do this using [Flatseal](https://flathub.org/apps/com.github.tchx84.Flatseal) or through your desktop environment's application permissions settings. Add the relevant paths (e.g. your games folder) under \"Filesystem\" permissions.\n\nIf you want Vermouth to detect Proton versions from your Steam installation, add `~/.steam:ro` and `~/.local/share/Steam:ro` to the filesystem permissions.\n\nIf you want to create desktop shortcuts for your games, add `xdg-desktop` to the filesystem permissions.\n\n## How it works\n\nGames are stored in `~/.config/vermouth/apps.json`. Proton is launched the same way Steam does it, by calling the `proton run` script with `STEAM_COMPAT_DATA_PATH` set to your prefix. Wine games just get `WINEPREFIX` set and the binary called directly.\n\n\n## AI Disclaimer\n\nThe code has been developed, reviewed and tested by a human. However, development included assistance of AI tools, so keep that in mind.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdekomote%2Fvermouth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdekomote%2Fvermouth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdekomote%2Fvermouth/lists"}