๐Ÿš€ Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more โ†’

streamlit-shortcuts

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

streamlit-shortcuts

Streamlit keyboard shortcuts for your buttons.

1.0.1
Maintainers
1

Streamlit Shortcuts

Add keyboard shortcuts to your Streamlit buttons! ๐Ÿš€

[!WARNING] Breaking Changes in v1.0

The API has been completely redesigned. If upgrading from v0.x:

# Old v0.x
button("Click me", "ctrl+k", lambda: st.write("Hi"))

# New v1.0  
if shortcut_button("Click me", "ctrl+k"):
    st.write("Hi")

See migration guide below.

๐ŸŽฏ Mirrors the native st.button pattern

# Before using native st.button:
if st.button("Save", type="primary", use_container_width=True):
    save()

# After (just change function name & add shortcut):
if shortcut_button("Save", "ctrl+s", type="primary", use_container_width=True):
    save()

๐ŸŽจ Add shortcuts to ANY Streamlit widget

name = st.text_input("Name", key="name_input")

# Add shortcuts to any widget with a key
add_shortcuts(
    name_input="ctrl+n",     # Focus name field
)

Streamlit Shortcuts Demo

Try the live demo or check out the example code

๐Ÿ“ฆ Installation

pip install streamlit-shortcuts

๐Ÿ“– API Reference

shortcut_button(label, shortcut, **kwargs)

Drop-in replacement for st.button with keyboard shortcut support.

Parameters:

  • label (str): Button text
  • shortcut (str): Keyboard shortcut (e.g., "ctrl+s", "alt+enter", "f1")
  • key (str, optional): Unique key for the button
  • hint (bool, optional): Show shortcut hint in button label (default: True)
  • **kwargs: All other st.button parameters (help, on_click, args, type, icon, disabled, use_container_width)

Returns: bool - True if clicked

add_shortcuts(**shortcuts)

Add keyboard shortcuts to any Streamlit widgets.

Parameters:

  • **shortcuts: Keyword arguments where key is the widget's key and value is the shortcut

Example:

add_shortcuts(
    save_btn="ctrl+s",
    search_input="ctrl+f",
    submit_form="ctrl+enter"
)

โŒจ๏ธ Keyboard Shortcuts

  • Modifiers: ctrl, alt, shift, meta (cmd on Mac)
  • Common keys: enter, escape, space, tab, delete
  • Letters: a-z
  • Numbers: 0-9
  • Function keys: f1-f12
  • Arrow keys: arrowleft, arrowright, arrowup, arrowdown

Examples:

  • ctrl+s - Ctrl + S
  • ctrl+shift+d - Ctrl + Shift + D
  • alt+enter - Alt + Enter
  • f1 - F1 key

๐Ÿ’ป Platform Notes

  • On macOS, ctrl works as expected (not cmd)
  • For OS-specific shortcuts, use meta (Windows key on PC, Cmd on Mac)
  • Some shortcuts may conflict with browser/OS shortcuts

๐Ÿšจ v1.0 Breaking Changes - complete rewrite

  • โญ No more API hijacking - v0.x monkey-patched Streamlit's API. Now we respect it:
    # v0.x - Hijacked the API, confusing and unpythonic
    button("Save", "ctrl+s", lambda: save())  # What is this? Not st.button!
    
    # v1.0 - Respects Streamlit patterns, works like st.button
    if shortcut_button("Save", "ctrl+s"):     # Familiar pattern!
        save()
    
    # Or use native st.button unchanged
    if st.button("Save", key="save_btn"):
        save()
    add_shortcuts(save_btn="ctrl+s")
    
  • ๐Ÿ“‰ From 277 lines โ†’ 91 lines total (across 5 Python files โ†’ 1 file)
  • ๐Ÿ—‘๏ธ Removed 15 files of configuration bloat
  • ๐Ÿ“ No more src/ directory - just one flat file
  • โŒ Deleted all tests - meaningless tests that tested nothing, replaced with assertions that actually fail
  • ๐Ÿ”ฅ Modern Python tooling - replaced setup.py/MANIFEST/VERSION with pyproject.toml + uv
  • ๐Ÿงน Ruff instead of 5 linters - removed flake8, black, isort, mypy, pre-commit hooks
  • โšก 3 workflows โ†’ 1 workflow - simple CI/CD

If upgrading from v0.x:

# Old v0.x API
button("Click me", "ctrl+k", lambda: st.write("Hi"))

# New v1.0 API  
if shortcut_button("Click me", "ctrl+k"):
    st.write("Hi")

# Or use st.button + add_shortcuts
if st.button("Click me", key="btn"):
    st.write("Hi")
add_shortcuts(btn="ctrl+k")

๐Ÿ“„ License

MIT

๐Ÿ™ Credits

Built by the Streamlit community! ๐ŸŽˆ

Special thanks to:

Inspired by Streamlit discussion #1291

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts