Skip to content

Add warp-deck plugin#1074

Open
rosakodu wants to merge 4 commits into
SteamDeckHomebrew:mainfrom
rosakodu:add-warp-deck
Open

Add warp-deck plugin#1074
rosakodu wants to merge 4 commits into
SteamDeckHomebrew:mainfrom
rosakodu:add-warp-deck

Conversation

@rosakodu

@rosakodu rosakodu commented Jun 27, 2026

Copy link
Copy Markdown

Add warp-deck to Plugin Store

A Decky Loader plugin for bypassing DPI and connecting to Cloudflare WARP via AmneziaWG. It automatically registers anonymous Cloudflare accounts, generates obfuscated WireGuard configurations (using HTTP3/QUIC handshake signatures), and connects natively on the Steam Deck to bypass DPI blocking without requiring paid VPN subscriptions.

Task Checklist

Developer

  • I am the original author or an authorized maintainer of this plugin.
  • I have abided by the licenses of the libraries I am utilizing, including attaching license notices where appropriate.
  • Generative AI was NOT used to write a majority of the code I am submitting.

Plugin

  • I have verified that my plugin works properly on the Stable and Beta update channels of SteamOS.
  • I have verified my plugin is unique or provides more/alternative functionality to a plugin already on the store.

Backend

  • No: I am using a custom backend other than Python.
  • Yes: I am using a tool or software from a 3rd party FOSS project that does not have it's dependencies statically linked.
  • No: I am using a custom binary that has all of it's dependencies statically linked.

Community

  • I have tested and left feedback on two other pull requests for new or updating plugins.
  • I have commented links to my testing report in this PR.

Testing

  • Tested by a third party on SteamOS Preview update channel.

@rosakodu rosakodu requested a review from a team as a code owner June 27, 2026 09:03
@github-actions github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label Jun 27, 2026
@github-actions

Copy link
Copy Markdown

Issues Found

No issues with your PR description were found.

Next Steps

  1. If we found any issues above, please edit your pull request description to resolve them and leave a comment saying you've done so.
  2. For the quickest review, please see the Community section of the pull request template for how you can help other developers.
  3. Once your description is correct, a maintainer will review your pull request as soon as possible.

Thank you for your contribution! If you need any help, please reach out on our Discord server. ❤️

@bizworkdeal

bizworkdeal commented Jul 4, 2026

Copy link
Copy Markdown

Plugin Testing Report

Plugin: WARP Deck
PR: #1074
Tester: @bizworkdeal
Device: Steam Deck OLED 512GB
SteamOS channel: Stable 3.8.14
Decky Loader version: 3.2.6
Install method: ZIP import

Summary

I tested WARP Deck on a real Steam Deck in Game Mode. The plugin installed successfully, appeared in Decky Loader, and the main features (WARP generation, custom config import, and AmneziaWG connections) worked as expected.

Test Environment

  • Steam Deck: real hardware
  • Mode: Game Mode
  • SteamOS channel: Stable 3.8.14
  • Decky Loader: 3.2.6
  • Network: Home Wi-Fi / Mobile Hotspot

Installation

  • Installed WARP Deck using the release ZIP file.
  • The plugin appeared correctly in the Decky quick access menu.
  • Opened the plugin UI without any crashes or freezes.
  • No Decky Loader restart loops or plugin load failures were observed.

Result: Pass

Cloudflare WARP Generation

  • Clicked "Update" to trigger the WARP generator.
  • Successfully generated a new WARP VPN profile directly from the UI without manual setup.
  • The profile was marked as "available".

Result: Pass

VPN Connection (AmneziaWG)

  • Enabled the generated warp-deck VPN profile using the toggle switch.
  • The connection established successfully and the status changed to "VPN Enabled".
  • The AmneziaWG obfuscation parameters (such as I1 QUIC signatures and junk packet settings) worked properly, bypassing ISP blocks.
  • Disabled the VPN profile; connection closed successfully.

Result: Pass

Custom Config Import

  • Clicked "Import config" and selected a custom AmneziaWG .conf file from the local storage.
  • The custom profile was imported and saved successfully.
  • Connected and disconnected the custom profile successfully.

Result: Pass

Diagnostics Check

  • Ran the built-in connectivity test.
  • Correctly verified connection status to 1.1.1.1, Google, and RuTracker.

Result: Pass

Persistence & Profile Management

  • Switched between different config profiles without issues.
  • Deleted a profile, and it was removed from both the UI and system storage.
  • Restarted Decky Loader / rebooted Steam Deck; all config profiles remained saved and usable.

Result: Pass

Issues Found

None

Final Result

Pass.

WARP Deck worked correctly across all tested workflows (WARP generation, AmneziaWG connection, config management, and diagnostics) on a real Steam Deck. Additionally, the Decky Loader store loaded successfully, which was previously unavailable in Russia.

@ViktorKoval5734

Copy link
Copy Markdown

Plugin Testing Report

Plugin: WARP Deck
PR: https://github.com/SteamDeckHomebrew/decky-plugin-database/pull/1074
Tester: [@ViktorKoval5734]
Device: Steam Deck OLED
OS: CachyOS Handheld Edition
Decky Loader version: 3.2.6
Install method: ZIP import

Summary

I tested WARP Deck on a real Steam Deck in Game Mode. The plugin installed successfully, appeared in Decky Loader, and all main features worked as expected.

Test Environment

  • Steam Deck: Real hardware
  • Mode: Game Mode
  • OS: CachyOS Handheld Edition
  • Decky Loader: 3.2.6
  • Network: Home Wi-Fi

Installation

  • Installed the plugin using the provided release ZIP.
  • The plugin appeared correctly in the Decky Quick Access menu.
  • The interface opened normally without crashes or freezes.
  • No Decky Loader restart loops or plugin loading failures were observed.

Result: Pass

Cloudflare WARP Generation

  • Clicked "Update" to trigger the WARP profile generator.
  • Successfully generated a new WARP VPN profile directly from the UI.
  • The profile was correctly marked as "available".

Result: Pass

VPN Connection (AmneziaWG)

  • Enabled the generated warp-deck profile using the toggle.
  • Connection established successfully and status changed to "VPN Enabled".
  • AmneziaWG obfuscation (I1 QUIC signatures, junk packets, etc.) worked properly and bypassed ISP blocks.
  • Successfully disconnected the VPN profile.

Result: Pass

Custom Config Import

  • Imported a custom AmneziaWG .conf file from local storage.
  • Custom profile was successfully imported and saved.
  • Able to connect and disconnect the custom profile without issues.

Result: Pass

Diagnostics Check

  • Ran the built-in connectivity diagnostics.
  • Correctly verified connectivity to 1.1.1.1, Google, and RuTracker.

Result: Pass

Persistence & Profile Management

  • Switched between different profiles without problems.
  • Deleted profiles successfully (removed from UI and system storage).
  • All profiles persisted after Decky Loader restart and full Steam Deck reboot.

Result: Pass

Issues Found

None

Final Result

Pass.

WARP Deck performed reliably across all tested scenarios, including WARP profile generation, AmneziaWG connectivity, custom configuration import, diagnostics, and profile management.

@github-actions

Copy link
Copy Markdown

This pull request is stale as no updates or testing reports have been posted within the last 7 days. Please ensure you are actively recruiting testers or resolving the issues discussed. If you do not remove the stale label or comment, this will be closed in 7 days. Please close this pull request if you need more time to resolve issues so we can keep our repo healthy.

@github-actions github-actions Bot added the stale label Jul 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

plugin-addition Adding a plugin to the Plugin Store stale

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants