Skip to content

Add KDEck#1055

Open
BRiAn3274 wants to merge 5 commits into
SteamDeckHomebrew:mainfrom
BRiAn3274:add-kdeck
Open

Add KDEck#1055
BRiAn3274 wants to merge 5 commits into
SteamDeckHomebrew:mainfrom
BRiAn3274:add-kdeck

Conversation

@BRiAn3274

@BRiAn3274 BRiAn3274 commented May 28, 2026

Copy link
Copy Markdown

Add KDEck to Plugin Store

KDEck is a Decky Loader plugin for Steam Deck game mode. It provides a minimal KDE Connect-compatible receiver so a phone can send clipboard text into the Decky panel and files into /home/deck/Downloads.

Submitted Version

This PR submits KDEck v0.4.2 for Plugin Store review.

v0.4.2 is the current stable release I consider mature enough for store submission. Later versions exist, but they are currently treated as beta builds because they have had less testing. They are not part of this store submission.

The submodule is intentionally pinned to the v0.4.2 commit instead of the latest beta branch.

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.
  • No: 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.

KDEck uses a Python backend. It can call SteamOS-provided KDE Connect tools for legacy diagnostics, but the user-facing receive path uses KDEck's own minimal LAN receiver.

Scope

  • Receives KDE Connect clipboard text from a phone.
  • Receives KDE Connect shared files from a phone.
  • Does not provide notifications, SMS, remote input, media control, or the full KDE Connect desktop feature set.

Isolation

  • Uses a separate KDEck device ID, certificate, and plugin data directory.
  • Does not register org.kde.kdeconnect.
  • Does not write to the desktop KDE Connect pairing configuration.
  • Pauses its receiver in Plasma desktop mode and resumes in game mode.

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.

Self-tested on SteamOS Stable with Steam Deck OLED:

  • Plugin loads in Decky Loader.
  • Android KDE Connect can discover and pair with KDEck.
  • Clipboard receive works.
  • File receive saves to /home/deck/Downloads.
  • Desktop mode isolation verified with KDEck receiver pause/resume.

@BRiAn3274 BRiAn3274 requested a review from a team as a code owner May 28, 2026 16:09
@github-actions github-actions Bot added the not-plugin Not related to plugins themselves label May 28, 2026
@github-actions

Copy link
Copy Markdown

Issues Found

  • Neither testing box is present in your description. Please include one of them per the Markdown comment above the testing section.

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 github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label May 28, 2026
@BRiAn3274

Copy link
Copy Markdown
Author

Updated the PR description to include the required testing checkboxes.

@BRiAn3274

Copy link
Copy Markdown
Author

Updated the PR description to include the testing section.

Self-tested on SteamOS Stable with Steam Deck OLED:

  • Plugin loads in Decky Loader.
  • Android KDE Connect can discover and pair with KDEck.
  • Clipboard receive works.
  • File receive saves to /home/deck/Downloads.
  • Desktop mode isolation was verified with receiver pause/resume.

@BRiAn3274

Copy link
Copy Markdown
Author

Testing checkboxes added, ready for review

@BRiAn3274

Copy link
Copy Markdown
Author

Hi, I noticed this PR was labeled not-plugin, but this is a Decky plugin addition to the Plugin Store. Could you please confirm whether the label was added intentionally, or remove it if it was accidental?

@
Pin KDEck to v0.5.2

v0.5.2 is the store submission version:
- All version numbers consistent (package.json + index.tsx)
- Auto-accept pairing restored for new devices
- Log export flush before zipping
- Frontend split into types/i18n/utils/components
- GitHub Actions CI + ruff lint
@
@BRiAn3274

Copy link
Copy Markdown
Author

The not-plugin label was added by the bot on my initial submission when the PR description was incorrect. I have since updated the PR according to the review requirements and removed defaults.txt from the submodule. Could you please confirm whether the not-plugin label can be removed, and whether the PR is now only waiting for loader-team review / testing_env approval?

@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 Jun 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

not-plugin Not related to plugins themselves plugin-addition Adding a plugin to the Plugin Store stale

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant