/jumpy

An Atom package that creates dynamic hot keys to jump around files and across visible panes.

Primary LanguageCoffeeScriptMIT LicenseMIT

Jumpy

An Atom package that creates dynamic hot keys to jump around files and across visible panes.

How to jump

  1. Hit shift + enter
  2. Choose from your presented labels:
  3. Enter two characters.
  4. Keep coding!

Jumpy in Action! - (gif made with recordit.co)

Install

On command line:

apm install jumpy

Notes

  • Works great with or without vim-mode!
    • Vim modes supported:
      • command mode
      • insert mode
      • visual mode (sorry cancels select at the moment)
    • Recommended key mappings to replace 'f' in vim-mode see 'Settings' below.
  • Recommended custom cursors:

Key Bindings

Defaults

  • Enter jump mode
    • shift + enter
  • Reset first character entered
    • backspace
  • Cancel/exit jump mode (any)
    • shift + enter
    • enter
    • esc
    • space

Settings

Jumpy preferences

( Preferences cmd+, ) -> search for 'jumpy'

  • Font Size: If set, must be a decimal value less than 1.
  • High Contrast: If checked, uses a more colorful and fun (usually green) label.
  • Use Homing Beacon Effect On Jumps (needs React Editor enabled, see below): If left on, will display a homing beacon (usually red) after all jumps.

Note: After selecting 'Use React Editor' in Preferences -> Settings you will have to either restart Atom or enter ctrl+alt+cmd+l (lower case L).

Jumpy settings

'vim-mode' Users (Strongly Recommended Override)

Put this override in your 'Atom' -> 'Open Your Stylesheet' settings:

'.editor:not(.mini).vim-mode:not(.insert-mode):not(.jumpy-jump-mode)':
    'f': 'jumpy:toggle'

This will bind 'f' to toggle Jumpy.

This has not been made the default because it changes vim's native behavior. With Jumpy, however, after jumping to the nearest word, you can probably word or character jump over to your target quickly. The Vimium chrome extension chose this binding. Please let me know what you think about this binding for Jumpy here!

Jumpy Styles

Note: Styles can be overridden in "Atom" -> "Open Your Stylesheets" (see examples below)

.jumpy {
    &.label {
    }
    &.jump {
    }
}

Example (orange labels)

TODO

  • Better highlighting in visual mode.

Keywords

(A little SEO juice since "apm search" only searches package name at the moment)

  • Hot keys
  • Key bindings
  • Shortcuts
  • Navigation
  • Productivity
  • Mouseless
  • Plugin
  • Extension