Skip to content

Conversation

@chenx-dust
Copy link
Contributor

Add Decky Clash to Plugin Store

DeckyClash is a light-weight Clash/Mihomo proxy client for Steam OS. Last submission is in #828 and all issue is solved.

What is Clash/Mihomo?

Clash is an open-source, rule-based proxy client that supports a wide variety of protocols like SOCKS5, HTTP, Shadowsocks, and VMess. It's widely used for advanced network routing, traffic splitting, and bypassing restrictions. However, the original Clash has been discontinued, and newer forks, e.g. Mihomo, have taken its place.

Mihomo depends on its configuration to work, which describes proxy server and instructs how traffic routes. Many popular proxy providers give user a URL to fetch latest configuration, but it's hard to maintain it manually, especially using Steam Deck.

In short, Clash/Mihomo is a network proxy tool, which can encrypt network traffic, bypass firewall and boost online gaming experience. And Decky Clash is a GUI wrapper of Mihomo for SteamOS users, providing many useful utilities.

flowchart LR
    A[Steam Deck] <-->|Data Traffic| B(Decky Clash)
    B <-->|Encrypted Traffic| C[Proxy Server]
    C <-->|Data Traffic| D[Internet]
Loading

Who need this?

It is really necessary for Chinese users, who are suffering from poor network connections to Steam and many other aboard gaming servers. Almost every Chinese Steam user uses proxy tool to boost their connection, while half of them are using Clash/Mihomo. Iranian and Russian users share some similar situation.

The reason why the network connections are poor for Chinese users:

  • Valve has not officially entered China, but its bussiness is allowed to due to China's membership in the WTO.
  • However, There is NO Steam CDN (except download) located in China subjected to compliance requirements.
  • International network in China suffers from congestion.
  • Censorship makes some network services unavailable.

What does this do?

This plugin provides an easy-to-use UI for SteamOS users to utilize Clash/Mihomo tool. What you can find in the screenshots is its useful UI, like subscription manager, etc.

Third-party Resources Explaination

  • mihomo.gz - Mihomo core of this plugin.
  • yq_bin - yq YAML command line editor.
  • country.mmdb , geosite.dat , asn.mmdb - IP/Domain/ASN GEO database.
  • yacd.zip , metacubexd.zip , zashboard.zip - Dashboards for Mihomo.

Screenshot

image

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.

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.
  • Yes: 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 Stable or Beta update channel.

@chenx-dust chenx-dust requested a review from a team as a code owner November 30, 2025 15:00
@github-actions github-actions bot added the plugin-addition Adding a plugin to the Plugin Store label Nov 30, 2025
@github-actions
Copy link

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. ❤️

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