FreshRSS/FreshRSS

[Feature] Use "key code" for the hotkeys, instead of the actual letters

Open

#7954 opened on Sep 12, 2025

View on GitHub
 (8 comments) (2 reactions) (0 assignees)PHP (15,022 stars) (1,171 forks)batch import
Feature RequestGood first issue 1️⃣Shortcuts ⌨help wanted

Description

Is your feature request related to a problem? Please describe.

Currently, when you set a hotkey for navigation (j/k/etc.) — they are processed as actual letters of the alphabet. This creates problems for users using multiple different languages on their computers. E.g. Latin letter j and Cyrillic letter о are on the same key on the keyboard, but navigation in FreshRSS will work only for the former, when the currently active layout is the Latin-based one.

Use case

Changing the behaviour will allow users not to care about the currently selected language, and they will always be able to navigate in FreshRSS.

Describe the solution you’d like

Rely on event.code for the shortcuts, instead of the event.key as it currently is. E.g. both Latin j and Cyrillic о will trigger an event with code="KeyJ".

Describe alternatives you’ve considered

No response

Additional context

No response

Contributor guide

Tech stack
javascript
Domain
frontend
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic JavaScriptUnderstanding of key events
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75
Research direction
Locate the JavaScript file(s) that handle keyboard shortcuts, likely in the app/ or scripts/ directories. In those files, find where event.key is used for hotkey detection and replace with event.code. Ensure to test with different keyboard layouts. Check the issue's 8 comments for any maintainer guidance or additional context.