Giter Club home page Giter Club logo

scrolla.docs's Introduction

Grab scrollable areas under macOS, and scroll using Vim moves.

awesome stuff happening in there again


The Site

Best marketing site for any of my apps so far: Scrolla.app

Why Scrolla

I'm lazy af. Can't be bothered moving the hands away from the keyboard.

License

No license. Scrolla is free. It's not open-source because it's sharing private packages with kindaVim and Wooshy. But maybe one day.

Manual

Navigate

Navigate through the different Scroll Areas of the frontmost window with:

scroll area key
next tab or down or control n
previous shift tab or up or control p
first command up
last command down
halfway up control up
halfway down control down
exit escape or return or i or your global hotkey

If you use kindaVim, then you'll be able to navigate with Vim moves by entering Normal Mode and:

scroll area kindaVim move
next j or down or control j or control n
previous k or up or control p
first gg
last G
halfway up control b or control u
halfway down control f or control d

Scroll

Scroll with:

scroll area key
up a bit k
right a bit l
down a bit j
left a bit h
up a lot u or control u or b or control b
down a lot d or control d or f or control f
to the top gg
to the most right $
to the bottom G
to the most left 0

APIs

Distributed Notifications

Scrolla sends Distributed Notifications to macOS when it starts highlighing Areas, and when it backs off. You can listen to those Notifications with external tools like BetterTouchTool or Hammerspoon and build your own custom workflows as a result of those Notifications.

The Notifications Names are:

  • ScrollaDidEngage
  • ScrollaDidDisengage

Custom URLs

You can control Scrolla programmatically by calling the following Custom URLs:

  • start: scrolla://start
  • stop: scrolla://stop
  • toggle: scrolla://toggle

Alternatives to Scrolla

scrolla.docs's People

Contributors

godbout avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

scrolla.docs's Issues

issue with showing canvas in certain cases

at least two cases:

  1. own Sl Settings window. may need to extra handling for own app as the AX is gonna have to ping something different (focused window vs main window)
  2. float panels like Alfred etc. The Canvas should be drawn on the app that gets back the focus once those apps like Alfred disappear. currently my guess is that The Canvas is drawn on those apps, that disappear, but

then the scrolling event can still be emitted on the app below. UX is messy.

ScreenFlow.mp4

URI controls

Same as Wooshy & kV๐Ÿ˜‡ Here I don't have any fancy ideas for what else URIs could do, I think just open, close & toggle would be good!

Allow "acceleration" option for scrolling

To enable smoother scrolling, I think it would be beneficial to have an acceleration parameter in the settings. This would essentially enable scrolling to start slow and ramp up to full speed when using j or k. Not only does having a small amount of acceleration feel more natural, it also enables smaller scroll motions when tapping j or k quickly as the application doesn't immediately jump to a full-speed scroll.

This should definitely be an optional parameter, as I know many people dislike scroll acceleration, but it could help Scrolla feel a bit less "abrupt" when trying to scroll smaller motions.

Edit: I would suggest this should be a numeric parameter in ms. Essentially: "Acceleration Time: 0ms" would be the current behavior. Anything >0ms would be the time it takes to accelerate from motionless to full-speed.

Active app unable to receive keystrokes after Scrolla on Spotlight

With Safari on this issue active, if I

  1. Press cmd+space to open Spotlight
  2. Activate Scrolla
  3. Deactivate Scrolla with its hotkey
  4. Press cmd+space to close Spotlight

Safari looks like it is focussed but can't receive any keystrokes anymore. Mouse works but whatever key or key-combination I press (cmd-q and the like included), my computer always makes the annoying "you can't do this" sound we talked about earlier. Only way to fix it from there seems to be to switch focus to another app and back to Safari.


Might be that this will already get resolved with the new release regarding #3?

not working on Arc

While I am able to scroll through the sidebar, I am unable to highlight any fields on actual websites to scroll on.

Selection border not showing for scrolling in `qlmanage` PDF preview

This might be a hardcore edge-case but who knows, maybe it'll uncover something else:

Running qlmanage -p <some PDF> and then using Scrolla to scroll the preview window works (it does scroll) but the selection border is missing. Interestingly enough, opening Quicklook from the Finder (i.e. pressing space on the same PDF) instead of running qlmanage directly does not have the issue.

Feedback when no scroll areas were found

Right now, the focus changes to Scrolla and back for a split second (which makes the active app flicker) when trying to scrolla when there are no scroll areas. It might be hard to realize what's going here on for some people. Could consider adding a little popup that stays for a second or so saying there are no scroll areas.

maybe add option to change the default keys?

I know this is vim-inspired and it's awesome (absolutely mind blowing), but, considering there is people using a different keyboard distro (non-qwerty), may be adding an option to override the defaults may be helpful.

Seems to get the main window scroll only

Hi,
First, thanks for putting this app together!

I'm facing an issue that inVentura 13.2.1 it seems to be picking up only the main window. I tried with tab, up/down and CTRL n, but nothing. It seems just to be able to control the scroll of the main window.

image

Best,

David

Show AX splash-screen on hotkey if missing access

Hitting the Scrolla hotkey with missing AX permissions currently has the same behavior as hitting it when there are no scroll areas (see #3). It would probably help to have the AX splash-screen (that also appears when opening Scrolla without AX permissions) come forward in this scenario.

Distributed Notifications API

๐Ÿ™ˆ


My concrete use-case: I have a Karabiner binding to switch tabs. Since switching tabs is ctrl+tab, passthrough in kV's Normal mode doesn't work. So I use kV's DN API to keep track of the current mode and when I am in Normal mode, the binding first goes to insert mode, then switches tabs, and finally goes back to Normal mode. This way I can switch tabs with my usual binding "without exiting" kV. I would like to do the same thing with Scrolla.

Option to scroll on key press without holding

Currently, Scrolla scrolls while holding a scrolling key. I would prefer having it scroll a preset (best case customizable) amount every time the key is pressed; still smoothly of course. I really like how Vimari scrolls.

Arguments

  • number of key-presses is more consistent & predictable compared to holding time
  • holding would still work because the OS sends repeated key strokes while holding
  • having to hold anything always gives me the feeling I'm waiting for something

Allow passthrough

Like in kV, it would be great to allow modifiers like command to passthrough, i.e. deactivating Scrolla to send the keystrokes to the underlying app

Feature Request: double tap for faster scrolling

Title mostly covers it ๐Ÿ˜„ it would be great to be able to double tap j / k for faster scrolling speed.

Not a huge issue, as other commands (d / u etc) mostly cover the same use case, but if it's not hard to implement, I'd definitely use

Arc browser main pane not supported when sidebar is open

Thanks so much for the awesome app. I enjoy the mouse-less life with Scrolla.

When the sidebar (of the arc browser) is open, the scrolla doesn't recognize the main pane of the browser. Please see the screenshots below.

not working in the main pane
ScreenShot_2023-05-29 at 09 20 55

working fine with the sidebar closed
ScreenShot_2023-05-29 at 09 21 26

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.