Skip to content

Add DeckBridge to Plugin Store - #1081

Open
Janleyx wants to merge 1 commit into
SteamDeckHomebrew:mainfrom
Janleyx:agent/add-deckbridge
Open

Add DeckBridge to Plugin Store#1081
Janleyx wants to merge 1 commit into
SteamDeckHomebrew:mainfrom
Janleyx:agent/add-deckbridge

Conversation

@Janleyx

@Janleyx Janleyx commented Jul 13, 2026

Copy link
Copy Markdown

Add DeckBridge to Plugin Store

DeckBridge is a self-contained Decky Loader plugin that turns the HTTP CONNECT proxy exposed by PdaNet+, NetShare, or Egern into transparent IPv4 TCP internet access. Users connect to the phone Wi-Fi network, choose the provider, and toggle the connection card; no Steam or system proxy configuration is required.

The plugin uses an isolated nftables path on supported kernels and a userspace-TUN fallback elsewhere. It bundles the official sing-box 1.13.14 x86_64 and ARM64 executables, documents their exact source, licenses, and hashes, and restores only DeckBridge-owned routes, DNS state, services, and firewall rules.

DeckBridge differs from TunnelDeck because it is not a VPN manager. It adapts phone-sharing applications that expose local HTTP proxies into transparent system networking and supports Android and iPhone providers.

Development disclosure: Codex generative AI was used extensively while building DeckBridge. The AI attestation below is intentionally left unchecked rather than making an inaccurate declaration. The complete source, third-party provenance, test records, and reproducible package script are public for review.

Device validation completed before submission:

  • Steam Deck on SteamOS: PdaNet+ and NetShare
  • Legion Go on SteamOS: Egern
  • ROG Ally X on Bazzite: Egern
  • Odin 2 on Armada: ARM64 userspace-TUN fallback

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 its dependencies statically linked.
  • No: I am using a custom binary that has all of its 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

The bundled upstream executables contain dynamic dependencies, so the Preview-channel testing requirement is retained below.

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

@Janleyx
Janleyx requested a review from a team as a code owner July 13, 2026 10:12
@github-actions github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label Jul 13, 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. ❤️

@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 21, 2026
@Janleyx

Janleyx commented Jul 21, 2026

Copy link
Copy Markdown
Author

Actively recruiting an independent Steam Deck tester for DeckBridge.

DeckBridge provides transparent internet access through PdaNet+, NetShare, or Egern without configuring Steam's proxy settings.

Testing requirements:

  • Steam Deck running the SteamOS Preview channel
  • Decky Loader
  • Access to PdaNet+, NetShare, or Egern
  • Willing to install DeckBridge from Decky's Testing Store and post a testing report on this PR

The Store build is currently waiting for approval of its testing_env deployment. Once it becomes available, I am looking for someone to test connecting, internet access, disconnecting, Restore Internet Settings, and reboot cleanup.

I am actively seeking testers through the Decky community and will post progress here.

@github-actions github-actions Bot removed the stale label Jul 22, 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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant