Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/steventheworker/applescripts

This is where I keep my applescript's and BetterTouchTool configuration, and some apps/automation's I use.
https://github.com/steventheworker/applescripts

Last synced: 15 days ago
JSON representation

This is where I keep my applescript's and BetterTouchTool configuration, and some apps/automation's I use.

Host: GitHub
URL: https://github.com/steventheworker/applescripts
Owner: steventheworker
Created: 2022-05-10T20:43:33.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2023-10-05T07:44:32.000Z (about 1 year ago)
Last Synced: 2024-08-01T16:32:11.737Z (3 months ago)
Language: AppleScript
Homepage:
Size: 3.95 MB
Stars: 11
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        # Install

[Watch on YouTube](https://www.youtube.com/channel/UCBcY4PTKNWXDXTt6RsHGRjQ/videos) (video coming soon)

1. After cloning, in the "BTT Settings" folder, open "triggers.bttpreset", then replace all:

     "\\/Users\\/super\\/Desktop\\/important\\/SystemFiles\\/"   --with the path you've placed the applescripts (and don't forget to add backslashes back in!)

-   Note: I put all my apps in /Applications/MyApps (barring apps that came with macOS and apps that can't be moved (eg: Karabiner, Lulu, etc.))     --apps won't show in BTT unless you do a replace all for "/MyApps"

2. Change APPLESCRIPTS_FOLDER in "afterBTTLaunched.applescript" to that same path (minus the blackslashes)

3. Compile all .applescript to .scpt by running   `bash ./compile-all.sh`

4. and finally, import the triggers (in "BTT Settings" folder) to BetterTouchTool in order to use the scripts

 

# BetterTouchTool bindings

## Global Keyboard Shortcuts

-   Autofocus textinput of many apps (eg: app store/maps/notes etc.) (With "/" or Cmd+/)

-   Cmd+Shift+E (reveal in finder / open Finder path in iTerm2/terminal)

-   Cmd+9 = switch to last space, Cmd+8 = switch to 2nd to last, Cmd 7 = switch to 3rd last

-   Cmd+0 = zoom 100%

-   Cmd+Option+Delete = Activity Monitor

-   Cmd+Control+B = Connect Airpods

-   Cmd+Option+Control+N = HTML/Network Inspector for mobile devices (Safari) (Must rename device se2020->yourdevicename)

-   Cmd+Control+[ or ] = Move mouse left/right whole monitor in pixels

-   Cmd+Option+LeftArrow or RightArrow = move to next/previous tab

-   Cmd+Option+Enter = Duplicate Tab (Safari/iTerm2)

### Windows™ window management: (requires [AltTab mod](https://github.com/steventheworker/alt-tab-macos/releases/download/1.3/DockAltTab.AltTab.v6.51.0.zip))

🟢 (green-button-click.applescript) clicking the green button will maximize the windows or restore the old window size & position like on Windows™ (w/ exceptions eg: Finder QuickLook Preview windows)

The 🌕 cmd-m, 🔴 cmd-w, & cmd-shift-w scripts minimize/close tabs or windows WITHOUT cycling (just like on Windows™).

🖱️ "click-cmd-cycle-windows" & "click-shift-file-new"      --holding shift/cmd while clicking a dock icon creates a new window / cycles an apps windows

**Troubleshoot**: if an apps tabs or popup windows aren't closing (unimplemented in the script), remap cmd+w/cmd+shift+w (for that specific app) on BTT to cmd+w w/ "prevent recursive triggers" checked (for default behavior). And [report it!](https://github.com/steventheworker/applescripts/issues)     --or disable BTT with [Fn + Ctrl + Opt + Cmd + D], close the window, and use the shortcut again to reenable BTT

 

 

## Trackpad Gestures

-   Tip tap to close window (middle, index, ring, and then pinky)

-   Corner click bottom left &&& 2 finger tap = right click

-   5 finger swipe left/right = move to tab previous / next tab

-   3 finger clickswipe up / down = Trigger (AltTab) Shortcut 1 & 2

-   4 finger swipe up/down = Show/Hide (AltTab) without switching apps

-   pinch with thumb and fingers = (Rectangle) restore default window size/position

-   spread with thumb and fingers = (Rectangle) maximize window

## Miscellaneous / Caveats

-   always show spaces thumbnails in mission control

-   show desktop: (Fn+D)

    -   Double click menu whitespace

    -   Move mouse to Corner (right) (peak w/ delay using sceenhook)

-   Cmd+Shift+H = hide on some apps (VSCode/text editors)

    -   Cmd+H = find/replace on these apps

-   Cmd+Shift+Q = quit on some apps (so I won't accidentally quit heavy apps)

    -   Cmd+Q will trigger Cmd+W (Safari/Xcode/few others)

-   Multiple instances of VLC / Blender (line 1 (APP_PATH) in click-shift-file-new)

-   Alt+Drag to move window around

Finder

-   Cmd+Opt+N = new file prompt

-   Cmd+Opt+T = new blank typescript file prompt

-   Windows navigation... Enter = Open file/app, Backspace = back arrow

-   Cmd+I => Cmd+Opt+I     &&     Cmd+Opt+I => Cmd+I     (prevents multiple info popups for selected items)

Firefox

-   (global browser shortcut) firefox-new-cmd-shift-m.applescript opens new windows in 1st container

-   Command + T= new tab in 1st container (cmd+shift+1 = no container)

-   screenhook specific features are listed in its README (paraphrased below)

Safari

-   Command+Option+Shift+M = 2nd global browser shortcut ("make" new window)

     

 

 

## "SteviaOS" -aka the almagamation of these files and these apps:

-   required:

    -   **[BetterTouchTool](https://folivora.ai/)**     --most scripts don't rely much, if at all on BTT and can be rewritten to work with other automation apps (eg: [Karabiner Elements](https://github.com/pqrs-org/Karabiner-Elements) (for mouse & key bindings only))

    -   **[scriptable AltTab](https://github.com/steventheworker/alt-tab-macos/releases/)**

        -   (global Keyboard Shortcuts) change the behavior of cmd-shift-w, cmd-w, cmd-m (cycle macOS windows like Windows™)

        -   (BTT trackpad gestures) 4 swipe up/down    --displays AltTab (all/single app view)

        -   (BTT trackpad gestures) 3 clickswipe up/down     --displays AltTab (all/single app view)      ... waits 250 milliseconds & triggers a switch (select 1st preview in list)

    -   **[screenhook](https://github.com/steventheworker/screenhook)** (listen to clicks without modifers / on the corners of the screen & run applescripts when monitors are attached)

        -   used in "cornerRightTowards" Desktop peak (BTT named triggers)     --keep Desktop Exposé showing even after "cornerRightAway" triggers

        -   when monitor is attached: run applescript to clean/sort desktop icons

    -   [Rectangle](https://rectangleapp.com/) (or whatever lets you map Cmd+Opt+Enter => maximize window & Cmd+Opt+Delete => restore window size)   --used in green-button-click.applescript

-   recommended:

    -   [DockAltTab](https://dockalttab.netlify.app/)   /   [Dock Exposé](https://dockexpose.netlify.app/)

    -   [safari-userscripts](https://github.com/steventheworker/safari-userscripts)

## ... and these System Settings

-   handled by BTT   --leaving these on messes with remapping "Mission Control Immediately" / all directions of 3 finger clickswipes

    -   Trackpad -> More Gesture -> Mission Control Off

    -   and disable 3 finger swiping between desktop

Note: I don't use 3 finger drag, and don't yet know if it will interfere