qmk-keychron-q3-colemak-dh/users/miles2go/babblePaste.md

## Babblepaste, a universal translator for keyboard shortcuts

The idea is to have one "paste" key do the right thing for any operating system.
Put the keyboard in Windows mode, and  "paste" means Ctrl-v.
Switch to Emacs and "Paste" means Ctrl-y.  Mac is GUI-v and so on.

Currently supported modes are Windows, OS X, Gnome/KDE, Emacs, VI , ChromeOS, and Readline, with 70+ common macro actions.

The babblepaste library looks for the current OS in the babble_mode global variable.
To switch modes, run the switch_babble_mode() function, or a pre defined BABL_DO_x macro.

**BE CAREFUL**
  * Not all actions are defined for all OSes. The default is to do nothing.
  * Not all actions are _TESTED_ on all OSes.
  * Keys can have very different meanings between windows in the same OS. If you switch apps without switching modes, bad things can happen.

###To use the library
#### Add #defines to your config.h.
```
    #define USE_BABBLEPASTE
    
    //// Uncomment the modes you want to enable
    #define BABL_WINDOWS
    #define BABL_READMUX
    #define BABL_VI
    #define BABL_MAC
    #define BABL_LINUX
    #define BABL_EMACS
    #define BABL_CHROMEOS
    
    //// These enable subsets of babble macros. Disable options to save space
    #define BABL_MOVE // Uncomment to add basic cursor movement
    #define BABL_OSKEYS // This adds Cut, paste, window movement and common OS shortcuts
    #define BABL_BROWSER // Browser shortcuts
    
    //// What Browser shortcuts?
    #define BABL_BROWSER_CHROME // Chrome browser, Google apps
    //#define BABL_BROWSER_MS
    //#define BABL_BROWSER_SAFARI // Safari, Apple defaults.
    
    //// applications vary even more between OSes. We'll do our best.
    #define BABL_APP
    // To enable specific App options.
    #define BABL_APP_CELLS // spreadsheets and tables
    #define BABL_APP_EDITOR // Fancy editor commands
    #define BABL_APP_WINDOWSPLITTING // splitting frames & windows
    
    //// What App keybinding is assumed?
    //#define BABL_APP_GOOGLE // Google office
    #define BABL_APP_MSOFFICE // MS office
    //#define BABL_APP_APPLE // Apple office
    #define BABL_APP_SUBLIME
```

#### Enable Babblepaste in your Keymap

Add the following to your keymap in process_record_user, before the main switch statement.
```
  #ifdef USE_BABBLEPASTE
       if( keycode > BABBLE_START && keycode < BABBLE_END_RANGE )  {
          if (record->event.pressed)  { // is there a case where this isn't desired?
            babblePaste ( keycode );
          } else{
            return true;
          }
        }
  #endif
```

#### Add makefile rules

Update your rules.mk to include the modes you want.

    `SRC += babblePaste.c babl_windows.c babl_mac.c babl_vi.c babl_readmux.c  babl_chromeos.c babl_emacs.c babl_linux.c`


#### Custom Keycodes

If you are using custom keycodes, update the safe range in your user.h
```
  #if defined(BABBLE_END_RANGE)
        #define USER_START BABBLE_END_RANGE
  #else
      #if defined(KEYMAP_SAFE_RANGE)
          #define USER_START KEYMAP_SAFE_RANGE
      #else
          #define USER_START SAFE_RANGE
      #endif
  #endif
```

#### Add Babblepaste actions to your keymap.
See the full list in babblePaste.h, or the list below
```
  B_WIN // switch babblepaste to  windows mode.
  B_MAC // Mac Mode
  B_LNX // switch to linux
  B_VI // switch to Vi mode
  B_EMAX //  switch mode to emacs
  B_READ // switch to readline /tmux mode
  B_CROM // switch to chromeos mode.

  #define B_L1C  BABL_GO_LEFT_1C
  #define B_R1C  BABL_GO_RIGHT_1C
  #define B_L1W  BABL_GO_LEFT_WORD
  #define B_R1W  BABL_GO_RIGHT_WORD
  #define B_GSOL  BABL_GO_START_LINE
  #define B_GEOL  BABL_GO_END_LINE
  #define B_GTOP  BABL_GO_START_DOC
  #define B_GEND  BABL_GO_END_DOC
  #define B_DOWN  BABL_GO_NEXT_LINE
  #define B_UP    BABL_GO_PREV_LINE
  #define B_PTOP  BABL_GO_PARA_START
  #define B_PEND  BABL_GO_PARA_END
  #define B_PGDN  BABL_PGDN
  #define B_PGUP  BABL_PGUP
  #define B_DEL    BABL_DEL_RIGHT_1C
  #define B_DLW    BABL_DEL_LEFT_WORD
  #define B_DRW    BABL_DEL_RIGHT_WORD
  #define B_DEOL  BABL_DEL_TO_LINE_END // delete from cursor to end of line
  #define B_DSOL  BABL_DEL_TO_LINE_START // delete from cursor to begining line
  #define B_MODE   BABL_MODE //type out name of current mode.

  #define B_UNDO    BABL_UNDO
  #define B_REDO    BABL_REDO
  #define B_CUT     BABL_CUT
  #define B_COPY    BABL_COPY
  #define B_PASTE    BABL_PASTE
  #define B_SELALL    BABL_SELECT_ALL
  #define B_SELA    BABL_SELECT_ALL
  #define B_FIND     BABL_FIND
  #define B_FINDN    BABL_FIND_NEXT
  #define B_FINDP    BABL_FIND_PREV
  #define B_RPLACE    BABL_FIND_REPLACE
  #define B_RUNAPP    BABL_RUNAPP
  #define B_NAPP  BABL_SWITCH_APP_NEXT
  #define B_PAPP  BABL_SWITCH_APP_LAST // previous
  #define B_CAPP  BABL_CLOSE_APP
  #define B_HELP  BABL_HELP

  #define B_NTAB  BABL_BROWSER_NEW_TAB
  #define B_CTAB  BABL_BROWSER_CLOSE_TAB
  #define B_ROTB  BABL_BROWSER_REOPEN_LAST_TAB
  #define B_NXTB  BABL_BROWSER_NEXT_TAB
  #define B_PTAB  BABL_BROWSER_PREV_TAB
  #define B_NURL  BABL_BROWSER_URL_BAR
  #define B_BFWD  BABL_BROWSER_FORWARD
  #define B_BBAK  BABL_BROWSER_BACK
  #define B_BFND  BABL_BROWSER_FIND
  #define B_BOOK  BABL_BROWSER_BOOKMARK
  #define B_BDEV  BABL_BROWSER_DEV_TOOLS // hard one to remember
  #define B_BRLD  BABL_BROWSER_RELOAD
  #define B_BFULL BABL_BROWSER_FULLSCREEN
  #define B_ZIN    BABL_BROWSER_ZOOM_IN
  #define B_ZOUT  BABL_BROWSER_ZOOM_OUT

  #define B_PASTV BABL_APP_PASTE_VALUES
  #define B_CALN  BABL_APP_CENTER_ALIGN
  #define B_CFMT  BABL_APP_CLEAR_FORMATTING
  #define B_SCLA  BABL_APP_SCROLL_ACTIVE_CELL
  #define B_NCEL  BABL_NEWLINE_IN_CELL
  #define B_IPRW  BABL_INSERT_ROW_ABOVE
  #define B_ICOL  BABL_INSERT_COL_LEFT
  #define B_IROW  BABL_INSERT_ROW
  #define B_DROW  BABL_DELETE_ROW
  #define B_SELC  BABL_SELECT_COL
  #define B_SELR  BABL_SELECT_ROW

  #define B_MSEL    BABL_APP_MULTI_SELECT
  #define B_VSPLIT  BABL_SPLIT_FRAME_VERT
  #define B_VUNSPT  BABL_UNSPLIT_FRAME_VERT
  #define B_HSPLIT  BABL_SPLIT_FRAME_HORIZONTAL
  #define B_HUNSPT  BABL_UNSPLIT_FRAME_HORIZONTAL
  #define B_NXTFM   BABL_NEXT_FRAME
  #define B_PRVFM   BABL_PREV_FRAME
```


## Development FAQs

**Todos**
eeprom store state of babble_mode? or update docs so that people can change the order of the enum in
babblespace.h?

**You have huge ifdef stanzas instead of functions**
This fails gracefully if you don't have all options defined. Patch if you can think how to use fewer defines.

** Why not an array of arrays as a lookup instead of a function?**
This would allow you to store the lookup table in PROGMEM.
True, but that takes more pre-processor skill than I have, and may be less portable to ARM or other flash mappings.

** Have you tested every key on every platform?**
No. Be careful, submit a patch.

** Why not update Apps at the same global level as the OS? **
This is only a good thing if it doesn't confuse the user. If you can show state of OS vs App, it's probably a good thing.

** Can the OS tell the keyboard what mode to use? **
The keyboard side is easy to do with virtser_recv & a function that updates babble_mode. It still needs a PC side app to track where the keyboard focus is.
One could use a keyboard macro to launch an app & switch modes for that app.

## Thanks

Thanks to [wikipedia shortcuts page](https://en.wikipedia.org/wiki/Table_of_keyboard_shortcuts)
and [Jeebak's keymap](https://github.com/qmk/qmk_firmware/blob/master/keyboards/planck/keymaps/jeebak/keymap.c)
this [howtogeek shortcuts page](https://www.howtogeek.com/115664/42-text-editing-keyboard-shortcuts-that-work-almost-everywhere/)
And of course QMK...