dominatos
devtoolbox-cheats
Shell

Cross-Desktop cheatsheet manager for Linux with native support for GNOME, KDE, XFCE, Windows and more. Access your Markdown command references instantly from your panel or menu.

Last updated Jun 17, 2026
22
Stars
1
Forks
0
Issues
0
Stars/day
Attention Score
28
Language breakdown
Shell 56.2%
QML 26.0%
JavaScript 7.8%
PowerShell 7.4%
AutoHotkey 2.4%
VBScript 0.1%
β–Έ Files click to expand
README

πŸ“’ DevToolbox Cheats β€” Universal Linux Cheatsheet Manager

Cross-Desktop cheatsheet manager for Linux with native support for GNOME, KDE, XFCE, and more. Access your Markdown command references instantly from your panel or menu.

GNOME KDE Universal License Version [![Open-Source Software][oss icon]](https://github.com/dominatos/devtoolbox-cheats) Online Version

🌐 Online version available at cheats.alteron.net

Overview

[!IMPORTANT]
Batteries Included! This repository is not just a menu engine; it comes pre-packed with a comprehensive collection of over 100+ production-ready cheatsheets for sysadmins, DevOps, and developers.

If you like this project, consider supporting me on Buy Me a Coffee β˜•οΈ


Example Screenshots

Screenshots from GNOME ARGOS Main menu Sub menu One item
Screenshots from KDE Plasma 5/6 Main menu Sub menu
Screenshots from universal Zenity (XFCE, MATE, Cinnamon, LXQt, LXDE, Budgie, Pantheon, Deepin) Main menu Sub menu
Screenshots from Windows (Native Tray App) Windows Tray Menu

✨ Features

🌍 Universal Desktop Support

  • GNOME - Native Argos panel menu with dropdown
  • KDE Plasma 5/6 - Native widget with full UI
  • XFCE / MATE / Cinnamon - Dialog-based menus (zenity/yad)
  • LXQt / LXDE - Lightweight dialog menus
  • Budgie / Pantheon / Deepin - Dialog-based menus with auto-detection
  • Tiling WMs - Terminal-based with FZF (i3, sway, bspwm, hyprland)
  • Windows (BETA) - Native tray application via AutoHotkey with full autodiscovery & search support (View Guide)
  • Auto-Detection - Detects your DE and adapts automatically

πŸš€ Performance

  • Instant Loading - Smart caching loads 100+ cheats in <100ms
  • Fast Category Toggle - Optimized for instant expand/collapse (KDE widget)
  • Auto Cache Invalidation - Rebuilds only when files change

🎯 Core Features

  • Category Organization - Group cheats by topic with emoji icons
  • Live Search - Filter cheats as you type
  • Copy to Clipboard - One-click copy (wl-clipboard/xclip)
  • Open in Editor - Launch any editor (auto-detected or custom)
  • Export - Save individual or all cheats to Markdown/PDF
  • FZF Integration - Powerful fuzzy search in terminal with syntax highlighting
  • TLDR Generation - Compile authored Markdown cheats into external TLDR pages

πŸ”§ Generated Outputs

  • Source of Truth - Authored cheats remain in ~/cheats.d
  • Native TLDR Staging Output - Generated TLDR pages go to ~/cheats.d-gen/tldr/pages/common
  • External NAVI Path Reserved - Planned NAVI output path is ~/cheats.d-gen/navi
  • TLDR Cache Install - Generated pages are also copied into ~/.cache/tldr/pages/common by default
  • Runtime Isolation - Generated outputs stay outside CHEATS_DIR, so Argos, KDE, dialog DEs, and terminal mode are unaffected

πŸ› οΈ TLDR Generator

# Generate native TLDR pages and merge them into the local tldr cache
./generate-tldr.sh

Preview without writing files

./generate-tldr.sh --dry-run

Verify staging output and cache pages are current

./generate-tldr.sh --check

Skip cache installation and only populate the staging tree

./generate-tldr.sh --no-cache-install

Replace existing cached TLDR pages instead of merging into them

./generate-tldr.sh --overwrite-existing

After generation, test a page with the regular client:

tldr grep
tldr openssl

🎨 Smart Features (KDE Widget)

  • Editor Auto-Detection - Scans for 16+ popular editors
  • Editor Dropdown - Quick selection with βœ“ marks for installed
  • Auto-Fallback - Uses first available editor if preferred missing
  • Custom Icons - Emoji or system icons per category/cheat
  • Safe Install - No crashes, works in VMs

πŸ“¦ Installation

Choose Your Desktop Environment

πŸͺŸ Windows (Native Tray App)

DevToolbox Cheats is fully supported on Windows using an automated PowerShell installer and AutoHotkey.

See the dedicated Windows Setup Guide for full details.

Quick Automated Install

  • Open PowerShell (do not run as Administrator).
  • Navigate to the repository's Windows-beta directory:
cd "C:\path\to\devtoolbox-cheats\Windows-beta"
  • Run the installer:
powershell.exe -ExecutionPolicy Bypass -File .\install-devtoolbox.ps1
  • Double-click the generated cheats.exe to run the app.

🟠 GNOME (Argos Extension)

1. Install Argos Extension

From extensions.gnome.org or GitHub

2. Install Dependencies

# Debian/Ubuntu
sudo apt install zenity xclip fzf bat pandoc

Fedora

sudo dnf install zenity xclip fzf bat pandoc

Arch

sudo pacman -S zenity xclip fzf bat pandoc

3. Clone and Install

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

4. Restart Argos

Disable and re-enable the Argos extension, or press Alt+F2 β†’ r β†’ Enter

Result: πŸ—’οΈ icon appears in your top panel with dropdown menu. (Note: The installer also adds devtools.1m.sh to provide an additional tools menu in your panel).

πŸ”΅ KDE Plasma 5/6 (Native Widget)

Quick Install

# Clone repository
git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats

Run universal installer (auto-detects Plasma version)

./install.sh

The installer will:

  • βœ… Install widget to ~/.local/share/plasma/plasmoids/
  • βœ… Clear QML cache (ensures config shows correctly)
  • βœ… Deploy 133 example cheatsheets to ~/cheats.d
  • βœ… Install dependencies (fzf, bat, wl-clipboard, fonts)
  • βœ… Prompt for safe Plasma Shell restart

After Install

  • Add to Panel:
- Right-click panel β†’ Add Widgets - Search "DevToolbox Cheats" - Drag to panel or desktop
  • Configure:
- Right-click widget β†’ Configure - Editor Dropdown - Select from auto-detected editors (marked with βœ“) - Cheats Directory - Default: ~/cheats.d - Cache File - Default: ~/.cache/devtoolbox-cheats.json
  • Usage:
- Click widget to open - Click categories to expand - Click cheat to open in editor - Use buttons: Copy, Open, Export, FZF Search

🟒 XFCE / MATE / Cinnamon

1. Install Dependencies

# Debian/Ubuntu
sudo apt install zenity xclip fzf bat pandoc

Fedora

sudo dnf install zenity xclip fzf bat pandoc

For Wayland sessions, use wl-clipboard instead of xclip

2. Clone Repository

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

3. Run Manually or Add to Panel

Run manually:

devtoolbox-cheats-menu menu

Add to panel (XFCE):

  • Install Genmon plugin: sudo apt install xfce4-genmon-plugin
  • Right-click panel β†’ Add New Items β†’ "Generic Monitor"
  • Right-click the new monitor β†’ Properties:
- Label: πŸ—’οΈ (or leave blank) - Command: devtoolbox-cheats-menu menu - Period (s): 30

Add to panel (MATE):

  • Right-click panel β†’ "Add to Panel..."
  • Select "Custom Application Launcher" β†’ Add
  • Configure properties:
- Type: Application - Name: DevToolbox Cheats - Command: devtoolbox-cheats-menu menu - Icon: πŸ—’οΈ (click to select icon)

Add to panel (Cinnamon):

  • Right-click the Menu applet β†’ Configure β†’ Menu β†’ "Open the menu editor"
  • Select a category (e.g., Accessories) β†’ "New Item"
  • Configure properties:
- Name: DevToolbox Cheats - Command: devtoolbox-cheats-menu menu - Icon: πŸ—’οΈ (click to select icon)
  • Save and close the menu editor.
  • Open the Cinnamon Menu, search for "DevToolbox Cheats", right-click it, and select "Add to panel".

🟣 LXQt / LXDE (Lightweight)

1. Install Dependencies

# Debian/Ubuntu (LXQt)
sudo apt install zenity xclip fzf bat pandoc

Lubuntu (LXQt)

sudo apt install zenity xclip fzf bat pandoc

LXDE

sudo apt install zenity xclip fzf bat pandoc

Arch

sudo pacman -S zenity xclip fzf bat pandoc

2. Clone Repository

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

3. Add to Panel

LXQt Panel:

  • Right-click panel β†’ "Manage Widgets" β†’ "Add Widgets"
  • Select "Custom command" β†’ Add
  • Right-click the Custom command widget β†’ Configure
  • Click "+" to add new launcher:
- Name: DevToolbox Cheats - Command: devtoolbox-cheats-menu menu - Click command: devtoolbox-cheats-menu menu - Icon: Click to browse and select a suitable icon (e.g., accessories-text-editor)
  • Click OK and close
LXDE Panel (PCManFM):
  • Right-click panel β†’ "Add / Remove Panel Items"
  • Select "Application Launch Bar" β†’ Add
  • Click "Application Launch Bar" β†’ Preferences
  • Click "+" to add application:
- Browse to create desktop file or add command: - Command: devtoolbox-cheats-menu menu
  • Close preferences
Or use desktop shortcut: The installer automatically creates an application shortcut. Open your application launcher and search for DevToolbox Cheats.

Result: Clicking launches dialog menu with all cheats

🟑 Budgie Desktop

1. Install Dependencies

# Ubuntu Budgie / Solus
sudo apt install zenity xclip fzf bat pandoc

Arch (with Budgie)

sudo pacman -S zenity xclip fzf bat pandoc

3. Install and Launch

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

Find in Budgie Menu:

  • Open Budgie Menu and type "DevToolbox"
  • Drag the shortcut to your Favorites or panel.
  • Optional: Right-click any icon in Plank dock β†’ Preferences, and drag from the applications menu.
Result: Clicking launches dialog menu with zenity interface

πŸ”· Pantheon (elementary OS)

1. Install Dependencies

# elementary OS
sudo apt install zenity xclip fzf bat pandoc

3. Install and Launch

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

4. Add to Dock

  • Press Super (Windows key) to open Applications
  • Search for "DevToolbox Cheats"
  • Right-click β†’ "Add to Dock"
Or add to Wingpanel (top panel) using keyboard shortcut:
  • Open System Settings β†’ Keyboard β†’ Shortcuts β†’ Custom
  • Click "+" to add:
- Name: DevToolbox Cheats - Command: devtoolbox-cheats-menu menu - Shortcut: Press keys (e.g., Super+C)

Result: Elegant zenity dialog matching elementary OS design language

πŸ”΅ Deepin Desktop

1. Install Dependencies

# Deepin OS / UbuntuDDE
sudo apt install zenity xclip fzf bat pandoc

Arch with Deepin

sudo pacman -S zenity xclip fzf bat pandoc

3. Install and Launch

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

4. Add to Dock or Control Center

  • Open Launcher (click grid icon in dock)
  • Find "DevToolbox Cheats" in Applications
  • Right-click β†’ "Send to Desktop" or "Pin to Dock"
Or use Control Center shortcut:
  • Open Control Center β†’ Keyboard and Language β†’ Shortcuts β†’ Custom Shortcuts
  • Click "+" to add:
- Name: DevToolbox Cheats - Command: devtoolbox-cheats-menu menu - Shortcut: Click "None" and press keys (e.g., Ctrl+Alt+C)

Result: Beautiful dialog matching Deepin's aesthetic with blur effects

πŸš€ Cosmic (Pop!_OS - NEW 2025)

1. Install Dependencies

# Pop!_OS with Cosmic
sudo apt install zenity fzf bat pandoc wl-clipboard

Cosmic uses Wayland by default

3. Install and Launch

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

4. Add Keyboard Shortcut

  • Open Settings β†’ Keyboard β†’ View and Customize Shortcuts β†’ Custom Shortcuts
  • Click "+" to add:
- Name: DevToolbox Cheats - Command: devtoolbox-cheats-menu menu - Shortcut: Press keys (e.g., Super+C)

Or add to Cosmic Dock:

  • Press Super+/ to open Launcher
  • Type "DevToolbox Cheats"
  • Right-click β†’ "Pin to Dock"
Result: Modern Rust-based dialog with native Cosmic integration

⚫ Tiling WMs (i3, sway, bspwm, hyprland)

1. Install Dependencies

# X11 Window Managers (i3, bspwm, awesome)
sudo apt install fzf bat xclip pandoc zenity

Wayland Compositors (sway, hyprland, river)

sudo apt install fzf bat wl-clipboard pandoc wofi

Arch (X11)

sudo pacman -S fzf bat xclip pandoc zenity rofi

Arch (Wayland)

sudo pacman -S fzf bat wl-clipboard pandoc wofi

2. Clone Repository

git clone https://github.com/dominatos/devtoolbox-cheats.git
cd devtoolbox-cheats
./install.sh

3. Add Keybinding

i3 config (~/.config/i3/config):

bindsym $mod+c exec --no-startup-id devtoolbox-cheats-menu menu

sway config (~/.config/sway/config):

bindsym $mod+c exec devtoolbox-cheats-menu menu

bspwm config (~/.config/sxhkd/sxhkdrc):

super + c     devtoolbox-cheats-menu menu

hyprland config (~/.config/hypr/hyprland.conf):

bind = SUPER, C, exec, devtoolbox-cheats-menu menu

awesome wm config (~/.config/awesome/rc.lua):

awful.key({ modkey }, "c",     function () awful.spawn.with_shell("devtoolbox-cheats-menu menu") end,     {description = "open devtoolbox cheats", group = "launcher"})

dwm config (config.h - requires recompile):

static const char *cheatcmd[] = { "/bin/sh", "-c", "devtoolbox-cheats-menu menu", NULL }; { MODKEY, XK_c, spawn, {.v = cheatcmd } },

4. Add to Launcher Menu (Optional)

rofi (X11):

# Add this alias to ~/.bashrc or ~/.zshrc alias cheats='devtoolbox-cheats-menu menu'

Or integrate directly with rofi

bindsym $mod+c exec "rofi -show run -run-command 'bash -c devtoolbox-cheats-menu menu'"

wofi (Wayland):

# Add to sway/hyprland config bindsym $mod+c exec devtoolbox-cheats-menu menu | wofi --dmenu

Result: Opens dialog menu (if zenity/rofi installed) or FZF terminal search


πŸ“‹ Requirements

Core (All Platforms)

  • Bash 4.0+
  • find, grep, sed, awk

Desktop-Specific

| Desktop | Required | Optional | |---------|----------|----------| | GNOME | Argos extension | zenity, xclip, fzf, bat | | KDE Plasma | kdialog, wl-clipboard | fzf, bat, noto-fonts-emoji | | XFCE/MATE/Cinnamon | zenity, xclip | fzf, bat | | LXQt/LXDE | zenity, xclip | fzf, bat | | Budgie | zenity, xclip | fzf, bat | | Pantheon | zenity, xclip | fzf, bat | | Deepin | zenity, xclip | fzf, bat | | Cosmic | zenity, wl-clipboard | fzf, bat | | Wayland | wl-clipboard | zenity, fzf, bat | | X11 | xclip | zenity, fzf, bat | | Terminal/Tiling WM | fzf | bat, zenity, rofi, wofi |

Supported Editors (Auto-Detected)

  • VS Code (code), VS Codium (codium)
  • Kate (kate), KWrite (kwrite)
  • Geany (geany), Gedit (gedit)
  • Sublime Text (subl), Atom (atom)
  • Vim (vim), Neovim (nvim)
  • Emacs (emacs), Nano (nano)
  • Mousepad (mousepad), Pluma (pluma)
  • XED (xed), Notepadqq (notepadqq)
  • Custom - Any command

πŸ“š Creating Cheatsheets

[!TIP]
Want to add your own custom cheatsheets, create new categories, or change the default directory? Check out our dedicated guide: πŸ“‚ Managing Custom Cheatsheets.

File Structure

Cheatsheets are Markdown files organized in category subfolders under ~/cheats.d/.

Directory structure:

~/cheats.d/ β”œβ”€β”€ databases/ β”‚   β”œβ”€β”€ mysqlcheatsheet.md β”‚   β”œβ”€β”€ mongodbcheatsheet.md β”‚   β”œβ”€β”€ postgrescheatsheet.md β”‚   └── redisprodcheatsheet.md β”œβ”€β”€ kubernetes-containers/ β”‚   β”œβ”€β”€ docker-basics.md β”‚   β”œβ”€β”€ docker-compose.md β”‚   └── kubernetes-commands.md β”œβ”€β”€ network/ β”‚   β”œβ”€β”€ nginx-config.md β”‚   β”œβ”€β”€ ssh-tunneling.md β”‚   └── firewall-basics.md └── security-crypto/     β”œβ”€β”€ ssl-certificates.md     β”œβ”€β”€ gpg-basics.md     └── openssl-commands.md

Each Markdown file contains metadata in the first 80 lines:

Title: MySQL Queries
Group: Databases
Icon: πŸ—„οΈ
Order: 1

MySQL Commands

Basic Queries

bash

Show databases

mysql -u root -p -e "SHOW DATABASES;"

Create database

mysql -u root -p -e "CREATE DATABASE mydb;"
### Metadata Fields
  • Title: (Required) Display name for the cheat
  • Group: (Required) Category name (matches subfolder or custom)
  • Icon: (Optional) Emoji (🐳) or system icon name (docker)
  • Order: (Optional) Sort order within group (1-999)

Icon Options

Emoji:

markdown Icon: 🐳 Icon: πŸ”’ Icon: 🌐
System Icons:
markdown Icon: docker Icon: database-server Icon: network-server
### Result in Menu

Categories are auto-detected from subfolders:

  • πŸ—„οΈ Databases β†’ MySQL Queries, MongoDB Basics, PostgreSQL, Redis
  • 🐳 Kubernetes & Containers β†’ Docker Basics, Docker Compose, Kubernetes Commands
  • 🌐 Network β†’ Nginx Config, SSH Tunneling, Firewall Basics
  • πŸ”’ Security & Crypto β†’ SSL Certificates, GPG Basics, OpenSSL Commands

🎯 Usage

GNOME (Argos)

  • Click πŸ—’οΈ icon in top panel
  • Dropdown menu appears with:
- πŸ›  DevToolbox Functions (Submenu containing Search, Export, Settings, Layout Switcher, etc.) - Categories (auto-adaptive layout β€” see below)
  • Click cheat name to copy & view
  • Content copied to clipboard automatically
Argos Layout Options:

You can switch layouts directly from the Argos menu (πŸ›  DevToolbox Functions β†’ πŸ”„ Layout) without editing any files.

  • Standard (default): Categories expand inline as native Argos submenus. Fastest for quick browsing without extra windows.
  • Zenity (dialog cheat list): Categories are shown at the root level. Clicking a category opens a popup Zenity dialog listing all cheats for that category. Excellent for small screens or when you prefer isolated windows.
  • Drill-down (categoryβ†’cheats): Clicking a category replaces the entire Argos menu with that category's cheats inline. Click β—€ Back to return to the category list.
Auto-adaptive category layout (Standard Mode):

The menu dynamically calculates how many category groups can safely fit on screen.

  • If categories exceed the safe limit (e.g. 19 groups on 1080p), they are grouped under πŸ“‚ Browse by Category β–Ά to prevent submenus from being clipped off-screen.
  • On larger screens (β‰₯1440p with fewer categories) categories are listed directly at the top level.
  • On small screens (≀1368Γ—768) the compact flat menu is shown instead.

KDE Widget

  • Click widget in panel
  • Full window opens with:
- Search field at top - Category list with counts - Action buttons: Copy, Open, Export, FZF
  • Browse: Click category to expand
  • Search: Type in search field
  • Copy: Click cheat β†’ copied to clipboard
  • Open: Click cheat name β†’ opens in editor
  • Export: Button to save all as Markdown
  • FZF: Opens terminal fuzzy search

Other DEs (Dialog Menu)

  • Launch script (panel button, keybinding, or manually)
  • Dialog appears with options:
- πŸ”Ž Search cheats - πŸš€ FZF Search Commands - πŸ“š Browse all cheats - πŸ“₯ Export all (MD/PDF) - 🌐 Online Version - πŸ™ GitHub Repository - βš™οΈ Settings - ── Categories ── - πŸ“š Basics - πŸ“‘ Network - ... (all your categories listed directly)
  • Search: Type query β†’ select from results
  • Browse: Select a category directly from the list β†’ select cheat
  • FZF: Opens terminal with fuzzy search

Terminal / FZF Search

bash

Direct FZF search

devtoolbox-cheats-menu fzfSearch

Or from menu β†’ FZF Search Commands

- Start typing to filter
  • Preview shows file with syntax highlighting (bat)
  • Press Enter to open in editor at exact line
  • Esc to cancel

βš™οΈ Configuration

Environment Variables

bash

Override cheats directory (default: ~/cheats.d)

export CHEATS_DIR=~/my-cheats

Override cache file

export CHEATS_CACHE=~/.cache/my-cheats.cache

Force cache rebuild on every run (for debugging)

export CHEATS_REBUILD=1

Force specific desktop environment

export DEVTOOLBOX_DE=kde # kde, gnome, xfce, lxqt, budgie, terminal

Set preferred viewers (space-separated, tried in order)

export CHEAT_VIEWERS="code codium antigravity windsurf subl kate kwrite geany gedit mousepad pluma xed notepadqq zenity"
### GNOME Argos: Adaptive Menu Layout

The Argos menu automatically adapts to your screen resolution and number of cheatsheet categories:

| Screen | Categories ≀ threshold | Categories > threshold | |--------|------------------------|------------------------| | β‰₯1440p | Expanded (categories at top level) | Collapsed (πŸ“‚ Browse by Category) | | 1080p | Expanded | Collapsed (19 groups trigger this) | | ≀768p | Compact flat menu (no inline categories) | Same |

The threshold is calculated as: (screen_height βˆ’ 30px panel) / 28px per item Γ— 60%

KDE Widget Settings

Right-click widget β†’ Configure:

  • Cheats Directory - Where your .md files are stored
  • Cache File - JSON cache for fast loading
  • Preferred Editor - Dropdown with auto-detected editors (βœ“ mark)
  • Auto-Rebuild Cache - Force rebuild on widget load

Custom Integration

Add to i3/sway config:

bash bindsym $mod+c exec devtoolbox-cheats-menu menu
Add to polybar:
ini [module/devtoolbox] type = custom/script exec = echo "πŸ—’οΈ" click-left = devtoolbox-cheats-menu menu
Add to waybar:
json "custom/devtoolbox": { "format": "πŸ—’οΈ {}", "on-click": "devtoolbox-cheats-menu menu" }
---

πŸ”„ Auto-Updater

Keep your cheatsheets in sync with the latest upstream version using the built-in updater.

Commands

After installation, cheats-updater is available in your PATH (~/.local/bin/):

bash

Check what changed upstream

cheats-updater check

Download / update all official cheatsheets

cheats-updater update

List all available cheatsheets

cheats-updater list
Behavior:
  • Only changed files are overwritten (cmp diff check)
  • Custom cheatsheets you add to ~/cheats.d/ are never touched
  • Automatic backup is created before every update at ~/.local/share/devtoolbox-cheats/backups/

Automatic Daily Updates (systemd)

The installer sets up a systemd user timer that runs %h/.local/bin/cheats-updater update once per day.

bash

Check timer status

systemctl --user status devtoolbox-cheats-updater.timer

View update logs

journalctl --user -u devtoolbox-cheats-updater.service

Trigger a manual run via systemd

systemctl --user start devtoolbox-cheats-updater.service

Disable automatic updates

systemctl --user disable --now devtoolbox-cheats-updater.timer

Re-enable automatic updates

systemctl --user enable --now devtoolbox-cheats-updater.timer
### Manual Setup (if not using install.sh)
bash

Symlink the executable to PATH

mkdir -p ~/.local/bin ln -sf ~/devtoolbox-cheats/cheats-updater.sh ~/.local/bin/cheats-updater

Symlink units and enable timer

mkdir -p ~/.config/systemd/user ln -sf ~/devtoolbox-cheats/systemd/devtoolbox-cheats-updater.service ~/.config/systemd/user/ ln -sf ~/devtoolbox-cheats/systemd/devtoolbox-cheats-updater.timer ~/.config/systemd/user/ systemctl --user daemon-reload systemctl --user enable --now devtoolbox-cheats-updater.timer
### Environment Variables
bash

Override target directory (default: ~/cheats.d)

CHEATS_DIR=/custom/path ./cheats-updater.sh update
---

πŸ”§ Troubleshooting

GNOME: Icon Not Showing

Cause: Argos not detecting script

Solution:

bash

Check script name matches pattern

ls ~/.config/argos/*.sh

Should be: something.30s.sh (30 seconds refresh)

Restart Argos: disable/enable extension

### KDE: Widget Not Showing

Cause: QML cache not cleared

Solution:

bash

Clear QML cache

rm -rf ~/.cache/plasmashell/qmlcache rm -rf ~/.cache/plasma-plasmashell/qmlcache rm -rf ~/.cache/qt6/qmlcache

Restart Plasma Shell

systemctl --user restart plasma-plasmashell.service
### KDE: Config Page Not Showing

Solution: Reinstall with cache clearing

bash cd kde-widget-plasma6 ./install.sh

Choose option 2 for automatic restart

### KDE: Editor Not Found

Behavior: Widget auto-falls back to first available editor

Fix: Right-click β†’ Configure β†’ Select different editor from dropdown

Any DE: Copy Not Working

Cause: Missing clipboard tool

Solution:

bash

For Wayland (Cosmic, sway, hyprland, Plasma 6 Wayland)

sudo apt install wl-clipboard

For X11 (most traditional DEs)

sudo apt install xclip
### Dialog Menu Not Showing

Cause: Missing dialog tool

Solution:

bash

Install zenity (universal, works with all DEs)

sudo apt install zenity

Or kdialog (KDE only)

sudo apt install kdialog

Or yad (advanced dialogs, more features)

sudo apt install yad
### FZF Search Not Working

Cause: Missing fzf or terminal

Solution:

bash

Install fzf and bat

sudo apt install fzf bat

Ensure terminal is installed

sudo apt install konsole # KDE sudo apt install gnome-terminal # GNOME sudo apt install xfce4-terminal # XFCE sudo apt install lxterminal # LXDE/LXQt sudo apt install mate-terminal # MATE sudo apt install io.elementary.terminal # Pantheon/elementary sudo apt install deepin-terminal # Deepin sudo apt install alacritty # Cosmic/modern compositors
### Budgie/Pantheon/Deepin: Script Not Launching

Cause: Desktop file permissions or path issue

Solution:

bash

Verify the script is in your PATH and executable

devtoolbox-cheats-menu menu

Update desktop database

update-desktop-database ~/.local/share/applications
---

πŸš€ Performance

Benchmark Results

Test System: 133 cheatsheets, 15 categories

| Operation | Time | Platform | |-----------|------|----------| | First Load | ~1-2s | All (builds cache) | | Cached Load | <100ms | KDE Widget / Script | | Category Toggle | <10ms | KDE Widget (optimized) | | Search Filter | <50ms | KDE Widget | | FZF Search | Instant | Terminal (fzf) | | Copy to Clipboard | <200ms | All |

Cache System

  • Format: TSV index with metadata
  • Location: ~/.cache/devtoolbox-cheats.idx (script) or .json (widget)
  • Invalidation: Auto-detects file changes via mtime
  • Rebuild: Only when needed or forced

πŸ›  Development

Project Structure

devtoolbox-cheats/ β”œβ”€β”€ devtoolbox-cheats.30s.sh # Universal script (all DEs) β”œβ”€β”€ devtools.1m.sh # Argos additional tools menu β”œβ”€β”€ cheats-updater.sh # Cheats update manager β”œβ”€β”€ install.sh # Universal installer β”œβ”€β”€ bump-version.sh # Version bump utility β”œβ”€β”€ generate-tldr.sh # TLDR page generator β”œβ”€β”€ systemd/ # Systemd user units β”‚ β”œβ”€β”€ devtoolbox-cheats-updater.service β”‚ └── devtoolbox-cheats-updater.timer β”œβ”€β”€ kde-widget-plasma6/ # Plasma 6 widget β”‚ β”œβ”€β”€ install.sh β”‚ β”œβ”€β”€ uninstall.sh β”‚ └── DevToolboxPlasmoid/ β”‚ β”œβ”€β”€ contents/ui/ β”‚ β”‚ β”œβ”€β”€ FullRepresentation.qml # Main UI β”‚ β”‚ └── configGeneral.qml # Config page β”‚ └── contents/code/ β”‚ β”œβ”€β”€ indexer.sh # Cache builder β”‚ └── fzf-search.sh # FZF helper β”œβ”€β”€ kde-widget-plasma5/ # Plasma 5 widget (same structure) β”œβ”€β”€ Windows-beta/ # Windows AutoHotkey implementation β”‚ β”œβ”€β”€ cheats.ahk β”‚ β”œβ”€β”€ install-devtoolbox.ps1 β”‚ └── README-windows.md β”œβ”€β”€ cheats.d/ # Example cheatsheets (133+ files) β”‚ β”œβ”€β”€ databases/ # Category subfolder β”‚ β”œβ”€β”€ kubernetes-containers/ # Category subfolder β”‚ β”œβ”€β”€ network/ # Category subfolder β”‚ └── ... # More category subfolders β”œβ”€β”€ docs/ # Documentation assets β”‚ β”œβ”€β”€ img/ # Screenshots β”‚ └── cheats-readme.sh β”œβ”€β”€ version.txt # Current version number β”œβ”€β”€ CHANGELOG.md # Release history β”œβ”€β”€ README.md └── LICENSE
### Testing

Test Universal Script:

bash

Force specific DE

DEVTOOLBOX_DE=kde ./devtoolbox-cheats.30s.sh menu DEVTOOLBOX_DE=gnome ./devtoolbox-cheats.30s.sh DEVTOOLBOX_DE=lxqt ./devtoolbox-cheats.30s.sh menu DEVTOOLBOX_DE=terminal ./devtoolbox-cheats.30s.sh menu

Test FZF search

./devtoolbox-cheats.30s.sh fzfSearch
Test KDE Widget:
bash cd kde-widget-plasma6 ./install.sh

View logs

journalctl --user -f | grep DevToolbox ``

Contributing

Pull requests welcome! Please:

  • Fork the repository
  • Create feature branch: git checkout -b feature/amazing
  • Test on your DE
  • Commit changes: git commit -m 'Add amazing feature'
  • Push to branch: git push origin feature/amazing
  • Open Pull Request to main` branch

πŸ“ Changelog

Please see CHANGELOG.md for release history.


Included categories

  • πŸ“š Basics
  • πŸ“‘ Network
  • πŸ’Ώ Storage & FS
  • πŸ—„οΈ Backups & S3
  • πŸ“¦ Files & Archives
  • πŸ“ Text & Parsing
  • ☸️ Kubernetes & Containers
  • πŸ›  System & Logs
  • 🌐 Web Servers
  • πŸ—ƒοΈ Databases
  • πŸ“¦ Package Managers
  • πŸ” Security & Crypto
  • 🧬 Dev & Tools
  • 🧩 Misc
  • πŸ”Ž Diagnostics
  • ☁️ Cloud
  • πŸ“ˆ Monitoring
  • πŸ”§ Infrastructure Management
  • πŸͺͺ Identity Management
  • πŸ–₯️ Virtualization

Included cheats (full list)

This repository includes ready-to-use cheatsheets for popular tools, organized by category:

Backups & S3

Basics

Cloud

Databases

Dev & Tools

Diagnostics

Files & Archives

Kubernetes & Containers

Infrastructure Management

Identity Management

Monitoring

Network

Package Managers

Security & Crypto

Storage & FS

System & Logs

Text & Parsing

Web Servers

Virtualization


πŸ“„ License

MIT License - See LICENSE file


πŸ™ Credits

  • Developer: Sviatoslav (@dominatos)
  • Inspired by: DevHints, tldr, cheat.sh, Argos
  • Icons: Noto Color Emoji
  • Tested on: GNOME, KDE Plasma, XFCE, MATE, Cinnamon, LXQt, Budgie, Pantheon, i3, sway

πŸ”— Links

  • Repository: https://github.com/dominatos/devtoolbox-cheats
  • Issues: https://github.com/dominatos/devtoolbox-cheats/issues
  • Releases: https://github.com/dominatos/devtoolbox-cheats/releases
  • Argos Extension: https://github.com/p-e-w/argos

⭐ Support

If you find this useful:

  • ⭐ Star the repository
  • πŸ› Report bugs via Issues
  • πŸ’‘ Suggest features
  • 🍴 Fork and contribute
  • πŸ’¬ Share with the Linux community

If you like this project, consider supporting me on Buy Me a Coffee β˜•οΈ


Made with ❀️ for the Linux community

[oss icon]: https://img.shields.io/badge/Open--Source-Software-blue.svg

πŸ”— More in this category

Β© 2026 GitRepoTrend Β· dominatos/devtoolbox-cheats Β· Updated daily from GitHub