https://github.com/notnew/awesome-scratch

scratchpad windows for awesome wm
https://github.com/notnew/awesome-scratch

List: awesome-scratch

awesomewm lua run-or-raise scratchpad

Last synced: 4 months ago
JSON representation

scratchpad windows for awesome wm

• Host: GitHub
• URL: https://github.com/notnew/awesome-scratch
• Owner: notnew
• Created: 2014-11-10T21:06:30.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2024-06-22T09:56:12.000Z (8 months ago)
• Last Synced: 2024-10-04T16:01:16.332Z (4 months ago)
• Topics: awesomewm, lua, run-or-raise, scratchpad
• Language: Lua
• Size: 395 KB
• Stars: 29
• Watchers: 1
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-awesomewm-modules-widgets-and-libraries - awesome-scratch
• awesome-awesomewm-modules-widgets-and-libraries - awesome-scratch

README

        
awesome-scratch

===============

scratchpad windows (similar to a quake console) for awesome wm

###Usage

`scratch.toggle` is used to show and hide scratch windows.  It takes a shell command to launch the scratch window and a rule to match the scratch window.

for example using ezconfig we can add bindings for a scratch terminal and a scratch python repl:

```

  local launchprogs = ezconfig.keytable.join({

      -- scratchpad programs

       ['M-c']   = { scratch.toggle, "urxvt -name scratch-term"             

                                   , { instance = "scratch-term" } }

     , ['M-S-p'] = { scratch.toggle, "urxvt -name scratch-python -e python"

                                   , { instance = "scratch-python" } }

     ...

```

You'll also probably want to add a rule to make the scratch windows float:

```

    awful.rules.rules = {

        ...

        { rule = { instance = "scratch" },

          properties = { floating = true} },

    }

```