Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tobi-wan-kenobi/scusage
scusage is a small tool for i3wm to analyze your keyboard shortcut usage
https://github.com/tobi-wan-kenobi/scusage
Last synced: about 1 month ago
JSON representation
scusage is a small tool for i3wm to analyze your keyboard shortcut usage
- Host: GitHub
- URL: https://github.com/tobi-wan-kenobi/scusage
- Owner: tobi-wan-kenobi
- License: mit
- Created: 2022-09-16T10:23:33.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2022-12-11T10:27:38.000Z (almost 2 years ago)
- Last Synced: 2024-09-13T22:54:28.097Z (2 months ago)
- Language: Python
- Size: 39.1 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
scusage
=====================================================
[](https://github.com/tobi-wan-kenobi/scusage/actions/workflows/codeql-analysis.yml)
`scusage` is a small tool to analyze your keyboard shortcut usage (hence the name -
**S**hort**C**ut **usage**) to help you find optimal keybindings.
Currently, it only supports the i3 window manager.
# Installation
```
$ pip install --user scusage
```
# Usage
```
$ ./bin/scusage -h
usage: scusage [-h] [--file FILE] [--resume]
monitor and report i3 keyboard shortcut usage
options:
-h, --help show this help message and exit
--file FILE, -f FILE file for reading and writing usage data. if not specified, no data will be written.
--resume if provided, data is appended to . otherwise, is overwritten
```
If you run `scusage` without parameters, you simply use your window manager, and
when you want to get the results, you terminate `scusage` using `Ctrl+C`:
```
$ scusage
# let scusage run while you go about your daily business
# when you are done, terminate the tool with Ctrl+C
shortcut count
-------------------------------------------------------------------------------- ------- ------------------------------
Mod4+2: workspace "2: " 7 (22%) ==============================
Mod4+3: workspace "3: " 7 (22%) ==============================
Mod4+4: workspace "4: " 5 (16%) =====================
Mod4+5: workspace "5: " 3 (9%) ============
Mod4+r: exec "rofi -modi window,drun,ssh,combi -show combi" 3 (9%) ============
Mod4+1: workspace "1: " 2 (6%) ========
Mod4+s: mark swapee; focus right; swap container with mark swapee; unmark swapee 2 (6%) ========
Mod4+8: workspace "8: " 1 (3%) ====
Mod4+9: workspace "9: " 1 (3%) ====
Mod4+0: workspace "10: " 1 (3%) ====
```
The idea is that this tool helps you identify which shortcuts you use most often,
so that you can bind them to convenient and easy to reach key combinations.
For collecting data across window manager sessions, you can use `--file`
and `--resume` to store and load usage data from a file.