bluesky-shortcuts

A browser extension for adding shortcuts to bsky.app.

Install

Development

Firefox

1. Run nvm install to install Node v24.16.0
2. Run npm install
3. Run npm run build:firefox
4. Visit the firefox addon debugging page
   1. (or enter about:debugging#/runtime/this-firefox in the address bar)
5. Click Load Temporary Add-on, and select bsky-shortcuts/build

Settings are stored with storage.sync, which Firefox only allows for add-ons with an ID. To test settings in a temporary add-on, create a config.local.js in the project root:

module.exports = {
    firefoxGuid: "your-addon-id@example.com"
};

Chrome

1. Run nvm install to install Node v24.16.0
2. run npm install
3. run npm run build:chrome
4. Visit the chrome extensions page
   1. (or enter chrome://extensions/ in the Chrome address bar)
5. Enable Developer mode in the top right
6. Click Load unpacked in the top left and select the bsky-shortcuts/build/chrome folder

Contributing

See CONTRIBUTING.md for guidelines on how to contribute to this project.

Shortcuts

Post Navigation

Key	Action
j	Move to next post
k	Move to previous post
v	Select next link in post
Shift + v	Select previous link in post
.	Load more posts

Post Actions

Key	Action
Enter	Open selected post/link
l	Like post
r	Reply to selected post
t	Repost (press again to undo)
Shift + t	Quote post
o	Expand image
h	Hide post
b	Block account
m	Mute account
x	Report post
y	Copy post text
s	Save post

Application

Key	Action
c	Cycle forward through saved feeds
Shift + c	Cycle backward through saved feeds
/	Focus Search
Alt + a	Switch to next account
?	Show shortcuts

Go To

Key	Action
g h	Go to home
g p	Go to profile
g u	Go to post author profile
g n	Go to notifications
g c	Go to chat
g f	Go to feeds
g l	Go to lists
g s	Go to settings

Changelog

See CHANGELOG.md for a complete list of changes.