Dear Community Friends,

With the recent update, we have unified the system shortcut service to work consistently under both Treeland (Wayland) and X11. As part of this, the configuration storage has been migrated from the keybinding module of dde-daemon to the shortcut module of dde-services. The new service uses a different data format and execution model; for technical details, please refer to the developer documentation linked at the end of this post.

Because the new service no longer reads the old configuration files, user‑defined custom shortcuts will not appear automatically after the upgrade. We sincerely apologise for the inconvenience this causes for some of you.

Scope of impact:

• System predefined shortcuts do not need migration; some of them may have slightly changed default key combinations or display names.
• UOS AI shortcuts are now provided by the application itself and are grouped under the separate “Xiao U” section. They will not appear under the “Custom” group. The migration script automatically skips these entries to avoid duplication.
• Only user‑added custom shortcuts need to be migrated.

Migration Method

We provide a migration script that reads your old configuration and re‑registers it through the new service interface. No root privileges are required.

Download the script : migrate-custom-shortcuts.zip

After downloading the archive, extract it to any directory to obtain the migrate-custom-shortcuts.py script. Open a terminal in that directory and run the following commands:

# 1. Preview the migration plan – no changes will be made
python3 migrate-custom-shortcuts.py --dry-run

# 2. After confirming the plan, perform the migration
python3 migrate-custom-shortcuts.py

# 3. If the result is not satisfactory, roll back the newly created shortcuts in one go
python3 migrate-custom-shortcuts.py --undo

Important notes:

• Run the script as your current user in the terminal session; do not use sudo.
• The old configuration files are only read, never modified – you can rerun the script at any time.
• The script is idempotent; it will not create duplicate shortcuts.
• Shortcuts provided by applications themselves (e.g., UOS AI) are automatically skipped to avoid conflicts.
• Complex commands that rely on old‑style shell syntax (e.g., pipelines, &&, variables) are automatically rewritten; the script will show each change line by line.
• Entries that cannot be determined automatically are marked as MANUAL / CONFLICT with a reason; they require manual confirmation.

If You Encounter Issues

If some shortcuts still do not work after migration, or if the script reports errors, please reply to this thread with the script’s output (the --dry-run output is sufficient – it contains no personal information). We will follow up promptly and our developers will help you complete the migration.

Important Notes (also printed at the end of the script)

-- Notes -------------------------------------------------------------
The new shortcut service runs shortcut actions through dde-am, as
    dde-am -c  -- 
No shell is involved, and the program must be a real executable (absolute
path, or resolvable in PATH). If a migrated shortcut does not work, run
`dde-am -h` in a terminal for its usage, or replay the "dde-am :" line
printed above by hand to see whether the command starts at all.
  dde-am source          : https://github.com/linuxdeepin/dde-application-manager
  Shortcut service       : https://github.com/linuxdeepin/dde-services
  Developer guide        : https://github.com/linuxdeepin/dde-services/blob/master/src/plugin-qt/shortcut/DEVELOPER_GUIDE.md

Related Links

• dde-am (application launcher, the actual executor of shortcut actions): https://github.com/linuxdeepin/dde-application-manager
• Shortcut service (the shortcut module of dde-services): https://github.com/linuxdeepin/dde-services
• Developer guide for the new shortcut service : DEVELOPER_GUIDE.en.zip

Thank you for your understanding and support!

deepin Community Team