[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-95105":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},95105,"MAKO","eugeniosegala\u002FMAKO","eugeniosegala","Next-generation, Vulkan-powered graphics layer for Linux gaming, bringing Lossless Scaling frame generation and scaling to Steam Deck, Steam Machine and desktop Linux.","",null,"C++",198,4,3,0,13,74,100,89.5,"Other",false,"main",[],"2026-08-24 04:01:23","# MAKO - Frame Generation on SteamOS\u002FLinux\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"plugin\u002Fassets\u002Fmako-logo.webp\" width=\"256\" alt=\"MAKO logo\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002FMAKO\u002Factions\u002Fworkflows\u002Ftests.yml\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Feugeniosegala\u002FMAKO\u002Ftests.yml?branch=main&style=flat-square&label=tests\" alt=\"Tests status\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002FMAKO\u002Freleases\u002Flatest\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Feugeniosegala\u002FMAKO?filter=plugin-%2A&display_name=tag&sort=semver&style=flat-square&label=Decky&color=1d4ed8\" alt=\"Latest MAKO Decky release\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002FMAKO\u002Freleases?q=render-v\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Feugeniosegala\u002FMAKO?filter=render-%2A&display_name=tag&sort=semver&style=flat-square&label=Renderer&color=1d4ed8\" alt=\"Latest MAKO Renderer release\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"LICENSE.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-GPL--3.0--or--later-0f766e?style=flat-square\" alt=\"GPL-3.0-or-later license\" \u002F>\u003C\u002Fa>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-SteamOS%20%7C%20Linux-6b8e23?style=flat-square\" alt=\"SteamOS and Linux\" \u002F>\n\u003C\u002Fp>\n\n\u003C!-- prettier-ignore -->\n> [!IMPORTANT]\n> **[Decky LSFG-VK Experimental](https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002Fdecky-lsfg-vk-experimental) and [LSFG-VK Experimental](https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002Flsfg-vk-experimental) are now MAKO.** This repository is their new home and continuation. Future development, releases, documentation, and issue tracking happen here.\n\n> **Independent project:** MAKO is independently developed and maintained for Steam Deck and Steam Machine. **MAKO Decky** provides per-game controls and integration, while **MAKO Renderer** supplies the Vulkan frame-generation layer. The project builds on work by **[PancakeTAS and the lsfg-vk contributors](https:\u002F\u002Fgithub.com\u002FPancakeTAS\u002Flsfg-vk)** and **[xXJSONDeruloXx, the original Decky LSFG-VK developer](https:\u002F\u002Fgithub.com\u002FxXJSONDeruloXx\u002Fdecky-lsfg-vk)**, whom MAKO gratefully thanks. Frame generation is available today, with scaling planned. MAKO requires `Lossless.dll` from a licensed [Lossless Scaling](https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F993090\u002FLossless_Scaling\u002F) installation but does not bundle, copy, or modify it. Test it per game; MAKO is not an official Lossless Scaling, Decky Loader, or lsfg-vk release.\n\n## Downloads\n\n| Component | Recommended for | Releases |\n| --- | --- | --- |\n| **MAKO Decky** | Steam Deck, Steam Machine, and Decky Loader users | [Latest MAKO Decky release (ZIP under Assets)](https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002FMAKO\u002Freleases\u002Flatest) |\n| **MAKO Renderer** | Direct Vulkan-layer installation without Decky | [Latest MAKO Renderer release (Linux archive under Assets)](https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002FMAKO\u002Freleases\u002Ftag\u002Frender-v2.1.0) |\n\n\u003C!-- prettier-ignore -->\n> [!NOTE]\n> Check the Downloads table regularly for updates. MAKO Decky and MAKO Renderer are published independently.\n\nPublished Renderer packages currently target x86_64 Linux hosts and include layers for both 64-bit and 32-bit x86 game processes. Native AArch64\u002FArmada packages are not included in this release.\n\n## ✨ Highlights\n\n|  | Highlight | What it brings |\n| :-: | --- | --- |\n| 🖼️ | **Full-quality frame generation** | Uses the Lossless Scaling frame-generation models from the user's licensed installation, with quality and performance controls per profile. |\n| 👻 | **Significantly reduced ghosting** | The full-quality v2 model with Performance Mode disabled can show noticeably less ghosting than the older layer. Supported AMD GPUs also gain extra protection against ghosting and corrupted moving edges. Results remain game-dependent. |\n| 🎯 | **Adaptive Frame Generation** | Optionally targets 30–240 FPS while MAKO Renderer varies generated frames up to a selected 2x–4x ceiling. |\n| 🌈 | **HDR foundation** | MAKO Renderer includes HDR10\u002FPQ and linear-scRGB groundwork. MAKO Decky keeps HDR exposure disabled while activation, presentation, colour, and performance are validated across games. |\n| 🧩 | **64-bit and 32-bit x86 Vulkan** | Ships architecture-matched host and Flatpak layers so Vulkan can select the correct library for each game process. |\n| 🛡️ | **Gamescope recovery** | Bounded presentation recovery preserves native presentation and resumes generation only after the game cadence becomes stable again. |\n| ⏯️ | **Live frame-generation switch** | Turns frame generation on or off without discarding the selected Fixed or Adaptive settings. |\n| 🗂️ | **Dedicated game\u002Fprocess profiles** | Capture a running game once and keep its renderer and compatibility settings. MAKO automatically selects it by Steam app ID or process, with isolated per-profile controls including ALSA audio. |\n| 🎮 | **Per-game Heroic and EmuDeck support** | Enables MAKO only for the Heroic games and EmuDeck titles you choose, using the same private configuration and engine as native Steam games. |\n\n## What MAKO is\n\nMAKO is a next-generation, Vulkan-powered graphics project for Linux gaming, built to bring Lossless Scaling frame generation and scaling (**scaling coming soon**) to Steam Deck, Steam Machine, SteamOS, and Linux more broadly. Frame generation is available today, with scaling as the next planned capability.\n\nThe project consists of two closely integrated components:\n\n- **MAKO Decky** is the Decky Loader component, providing per-game controls, installation, updates, Flatpak preparation, and game launch integration.\n- **MAKO Renderer** is the Vulkan layer that provides the graphics pipeline for frame generation and future scaling capabilities.\n\nChoose one launch workflow for each installation: MAKO Decky uses `mako-run`, while a directly installed MAKO Renderer uses `mako-launch`. Do not stack the two launchers or combine MAKO with another frame-generation wrapper for the same game.\n\n## 🎮 In-game considerations\n\n\u003C!-- prettier-ignore -->\n> [!TIP]\n> **Try the game's V-Sync setting both on and off.** It can make frame delivery feel steadier, but it may also add input lag or clash with the game's FPS cap, VRR, or compositor. Compare both options and keep the one that feels smoother and more responsive.\n\nEvery game, renderer, and display setup behaves differently. Compare Fixed and Adaptive Frame Generation one setting at a time. For most games, fullscreen is the best starting point for performance and frame pacing. Restart after major display or model changes, and keep the configuration that works best for that game.\n\n## Install and use\n\n1. **Install Decky Loader** if needed. Switch to Desktop Mode and follow the [official Decky Loader installation guide](https:\u002F\u002Fgithub.com\u002FSteamDeckHomebrew\u002Fdecky-loader#-installation), then return to Game Mode.\n2. **Install [Lossless Scaling](https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F993090\u002FLossless_Scaling\u002F) from Steam.** MAKO needs the licensed installation's `Lossless.dll`.\n3. Open the [latest MAKO Decky release](https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002FMAKO\u002Freleases\u002Flatest) and download its ZIP under **Assets**.\n4. In Decky's settings, enable **Developer Mode**, then select **Developer > Install Plugin from Zip**.\n5. Open **MAKO Decky** and select **Install MAKO Renderer**. This required step installs the bundled renderer into the plugin's private location.\n6. Leave the defaults in place unless a game needs adjustment. Fixed 2x is the normal starting point; Adaptive Frame Generation is optional.\n7. For a native Steam or Proton game, add this under **Steam Properties > Launch Options**:\n\n    ```text\n    \u002Fhome\u002Fdeck\u002F.local\u002Fbin\u002Fmako-run %command%\n    ```\n\n8. Start the game normally.\n\n\u003C!-- prettier-ignore -->\n> [!IMPORTANT]\n> If Decky does not show or reload **MAKO Decky** after installing a ZIP, uninstall it, install the ZIP again, and restart your Steam Deck or Steam Machine. Then open the plugin and repeat step 5.\n\n### Optional graphics integrations\n\nMAKO Decky provides an experimental per-profile Gamescope WSI compatibility toggle and supports host-installed MangoHud and experimental vkBasalt under **External Tools**. These optional Vulkan layers are mutually exclusive. See [optional graphics integrations](engine\u002Fdocs\u002FLAYER-CHAINING.md) for limits, verification, MangoHud customization, manual activation, and advanced integrations such as OBS Vulkan Capture, RenderDoc, ReShade, and OptiScaler.\n\n### Heroic and other Flatpak applications\n\nThe Steam launch wrapper cannot enter a Flatpak sandbox directly, so configure Heroic through **Flatpak Setup**:\n\n1. Select **Flatpak Setup** in MAKO Decky.\n2. Under **Flatpak Applications**, prepare **Heroic**. If the matching runtime extension is missing, MAKO tells you which runtime to install, commonly **25.08**. Preparing Heroic grants access to the wrapper, configuration, and `Lossless.dll`; it does not enable frame generation for every Heroic game.\n3. In every Heroic game you want to enable, open **Settings > Advanced** and set the first **Wrapper** field to the SteamOS wrapper path:\n\n    ```text\n    \u002Fhome\u002Fdeck\u002F.local\u002Fbin\u002Fmako-run\n    ```\n\n    MAKO also shows the exact **Wrapper path for this device** under **Flatpak Setup**. Use that displayed path when it differs, such as on Bazzite or with a custom username. Leave **Arguments** empty and do not use `%command%` in Heroic.\n\n4. Start that game normally from Heroic or its Steam shortcut.\n\nThe wrapper applies only to the selected Heroic games and enables the private MAKO Renderer Flatpak layer for that game.\n\n\u003C!-- prettier-ignore -->\n> [!IMPORTANT]\n> After installing a newer MAKO ZIP, return to **Flatpak Setup** and select **Update** for Heroic's matching runtime extension. This replaces Heroic's Flatpak engine with the version bundled in the new ZIP while preserving its preparation and per-game Wrapper commands.\n\n### EmuDeck\n\nFor any EmuDeck emulator installed as a Flatpak:\n\n1. In MAKO Decky, select **Flatpak Setup** and prepare the emulator you use. Install its matching runtime extension when prompted.\n2. Select **Vulkan** as that emulator's graphics backend when it offers one.\n3. In Desktop Mode, open the Steam shortcut for each EmuDeck game you want to configure, then set these fields under **Properties > Shortcut**:\n\n    - **Target**\n\n        ```text\n        \u002Fhome\u002Fdeck\u002F.local\u002Fbin\u002Fmako-run\n        ```\n\n        This is the standard SteamOS path. If MAKO shows a different **Wrapper path for this device** under **Flatpak Setup**, use the displayed path.\n\n    - **Start In**\n\n        ```text\n        \u002Fusr\u002Fbin\n        ```\n\n    - **Launch Options:** leave the EmuDeck-generated value unchanged. It already contains the correct emulator ID, ROM path, and flags for that shortcut.\n\nIf EmuDeck installed an emulator as a native application or AppImage instead, it is not a Flatpak workflow: use the normal Steam launch option `\u002Fhome\u002Fdeck\u002F.local\u002Fbin\u002Fmako-run %command%` for that shortcut.\n\n\u003C!-- prettier-ignore -->\n> [!IMPORTANT]\n> After updating MAKO, return to **Flatpak Setup** and select **Update** for every prepared emulator's matching runtime extension.\n\nFor a step-by-step guide that creates a shareable report on the Desktop, see [Collect MAKO Decky Diagnostics](plugin\u002Fdocs\u002FCOLLECT_DIAGNOSTICS.md).\n\n### Updating MAKO Decky\n\nThe clean update path avoids Decky retaining an older backend or bundled payload:\n\n1. Quit games using `\u002Fhome\u002Fdeck\u002F.local\u002Fbin\u002Fmako-run`.\n2. Uninstall MAKO Decky, then install the newer ZIP through **Developer > Install Plugin from Zip**.\n3. Restart your Steam Deck or Steam Machine.\n4. Open MAKO Decky and select **Install MAKO Renderer** to install the native renderer bundled in the ZIP.\n5. If you use Heroic or EmuDeck Flatpak emulators, open **Flatpak Setup** and select **Update** for each prepared application's matching runtime extension shown by MAKO.\n\n\u003C!-- prettier-ignore -->\n> [!IMPORTANT]\n> **Preferred clean update:** To prevent Decky retaining a previous plugin backend or bundled payload, especially when moving between local test ZIPs, uninstall **MAKO Decky**, install the newer ZIP, restart your Steam Deck or Steam Machine, then open it and select **Install MAKO Renderer**.\n\nProfiles and Steam launch options are retained. The private native engine and launcher are recreated in step 4; shared Flatpak extensions are retained and then refreshed in step 5.\n\n## Use MAKO Renderer directly\n\nDecky is optional. Desktop Linux users can install the published MAKO Renderer archive directly:\n\n1. Purchase and install [Lossless Scaling](https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F993090\u002FLossless_Scaling\u002F) through Steam.\n2. Open the [latest MAKO Renderer release](https:\u002F\u002Fgithub.com\u002Feugeniosegala\u002FMAKO\u002Freleases\u002Ftag\u002Frender-v2.1.0) and download `MAKO-Renderer-v\u003Cversion>-linux.tar.xz` under **Assets**.\n3. Extract it into your user-local prefix:\n\n```bash\nmkdir -p ~\u002F.local\ntar -xJf MAKO-Renderer-v\u003Cversion>-linux.tar.xz -C ~\u002F.local\n```\n\n4. Open **MAKO Renderer Configuration** from the application launcher or run `~\u002F.local\u002Fbin\u002Fmako-ui`.\n5. Add a game profile, then activate MAKO only for that game. In Steam launch options, use:\n\n```text\n~\u002F.local\u002Fbin\u002Fmako-launch %command%\n```\n\n`mako-launch` activates MAKO for that game through its private Vulkan layer boundary. It prevents Steam's Vulkan Fossilize\u002Foverlay hooks, competing frame-generation layers, and system-wide presentation hooks from bypassing MAKO's swapchain interception. Gamescope and the Steam\u002FGame Mode interface remain active outside the application layer chain. Game-local integrations such as OptiScaler are not removed, but use only one frame-generation implementation per game. The archive includes both 64-bit and 32-bit Vulkan layers. Flatpak applications need the separate runtime extension. See the dedicated [MAKO Renderer installation and usage guide](engine\u002FREADME.md) for Qt requirements, manual configuration, validation, benchmarking, Flatpak setup, source builds, and troubleshooting.\n\n## Documentation\n\n- [Configuration guide](plugin\u002Fdocs\u002FCONFIGURATION.md): Fixed and Adaptive modes, quality and performance settings, profiles, and compatibility options.\n- [Troubleshooting](plugin\u002Fdocs\u002FTROUBLESHOOTING.md): Gamescope recovery, HDR compatibility, and diagnostic logs.\n- [Collect MAKO Diagnostics](COLLECT_DIAGNOSTICS.md): choose the MAKO Decky or standalone renderer collection workflow and submit one shared report.\n- [Local packaging and publishing](plugin\u002Fdocs\u002FPACKAGING.md): build a ZIP for a Steam machine or publish a release.\n- [Release process](HOW_TO_RELEASE.md): publish both components end to end with one versioned command.\n- [Testing](TESTING.md): pull-request gates, sanitizer coverage, SteamOS hardware validation, and the runtime compatibility boundary.\n- [MAKO Renderer documentation](engine\u002FREADME.md): engine identity, source builds, configuration, and direct use.\n\n## Featured in\n\nCommunity creators have covered and tested the project on Steam Deck hardware. See [Featured In](plugin\u002Fdocs\u002FFEATURED_IN.md) for video links, channels, and coverage details.\n\n## Credits and project lineage\n\nMAKO is built on the work of two open-source projects and their communities:\n\n- **[Kurt Himebauch \u002F xXJSONDeruloXx](https:\u002F\u002Fgithub.com\u002FxXJSONDeruloXx\u002Fdecky-lsfg-vk)** created the original Decky LSFG-VK plugin that formed the foundation of MAKO's Decky interface, installation workflow, and per-game controls.\n- **[PancakeTAS](https:\u002F\u002Fgithub.com\u002FPancakeTAS\u002Flsfg-vk)** and the **lsfg-vk contributors** created the Vulkan layer and Linux integration on which MAKO Renderer is based.\n\nMAKO also thanks the **Lossless Scaling developers** for the frame-generation and scaling technology accessed through each user's licensed installation, and the **Decky Loader team**, community contributors, testers, guide authors, and creators who helped make the project possible.\n\nThe original copyright and license notices are preserved in [LICENSE.md](LICENSE.md). MAKO is an independent community project and is not affiliated with or endorsed by Lossless Scaling, Decky Loader, or either upstream project.\n\n## License\n\nMAKO is distributed under [GPL-3.0-or-later](LICENSE.md). The root license also preserves the BSD-3-Clause and MIT notices required by incorporated upstream code.\n\n## AI-assisted development\n\nMAKO uses coding agents as part of an evidence-driven engineering workflow while keeping architecture, review, validation, and release decisions under human ownership. See [AI use in MAKO](AI_USE.md) for the full approach.\n","MAKO 是一个面向 Linux 游戏平台的下一代 Vulkan 图形层，专为 Steam Deck、Steam Machine 及桌面 Linux 设计，提供基于 Lossless Scaling 的无损帧生成（Frame Generation）与后续计划支持的动态缩放功能。其核心采用 Vulkan API 实现低开销帧插值，通过独立的 MAKO Renderer（Vulkan 层）与 MAKO Decky（Decky Loader 插件）协同工作，支持 per-game 精细控制。项目不捆绑 Lossless Scaling 二进制文件，需用户自行安装正版 Lossless Scaling 并提供 lossless.dll。适用于追求高帧率与流畅性的 Linux 游戏玩家，尤其适合 Steam Deck 等便携式游戏设备。",2,"2026-08-21 02:30:11","CREATED_QUERY"]