KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

awesome-leader

★ 17 Open GitHub ↗

Leader key for Awesome WM

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# awesome-leader

This module lets you string together key combinations in awesome triggered by pressing a leader key. It should roughly emulate vim's behavior here. Count arguments before combinations are also supported.

Note: This version needs the latest awesome-git

## Instructions

```
local leader = require "awesome-leader"

local tab_keys = leader.bind_actions({
    {"t",
     function(args)
       awful.tag.add("new", {index=args.count})
     end,
     "New tag!"
    },
})

local rec_leader =
  leader.wrap(
    leader.repeat_count,
    leader.bind({
        {"t", tab_keys, "Tags"},
  }))

local root_leader = leader.leader(rec_leader)

awful.key({ modkey }, "z", root_leader)
```

Use `bind_actions` to bind a list of simple Lua functions, keys and
descriptions. To build up more complicated bindings (in this example, to put
`tab_keys` behind the `t` key) use `bind`.

With this config, we can press combinations like `<modkey-z>2t2` to add 2 new tabs at index 2.
We also get nifty popups at each stage telling us what keys are available.

The `wrap` and second `bind` call are just examples, we can leave them out and directly call
`leader.leader(tab_keys)`.

awesome-leader

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README