#+TITLE: dmenu/rofi scripts — README #+AUTHOR: Tony * YouTube Video Showcasing: [[https://www.youtube.com/watch?v=1hPPTnYtAwU][YouTube Showcase]] * Table Of Contents :toc: - [[#youtube-video-showcasing][YouTube Video Showcasing:]] - [[#intro][Intro]] - [[#dependencies][Dependencies]] - [[#setup--conventions][Setup & Conventions]] - [[#find-repos][Find Repos]] - [[#dmenu-repossh][dmenu-repos.sh]] - [[#rofi-repossh][rofi-repos.sh]] - [[#tmux-sessions][TMUX Sessions]] - [[#dmenu-sessionssh][dmenu-sessions.sh]] - [[#rofi-sessionssh][rofi-sessions.sh]] - [[#bookmarks-workpersonal][Bookmarks (work/personal)]] - [[#dmenu-bookmarkssh][dmenu-bookmarks.sh]] - [[#rofi-bookmarkssh][rofi-bookmarks.sh]] - [[#where-to-bind-these-dwm--qtile][Where to bind these (DWM / Qtile)]] - [[#dwm][DWM]] - [[#qtile][Qtile]] - [[#tips--troubleshooting][Tips & Troubleshooting]] - [[#support][Support]] * Intro This repo contains 3 scripts (with 2 variants each): 1. ~repos~ — fuzzy-pick a repo and jump into a tmux session there 2. ~sessions~ — list existing tmux sessions and attach/create 3. ~bookmarks~ — pick from a *personal* or *work* bookmark list and open in the matching browser All scripts have both *dmenu* and *rofi* variants (6 scripts total). * Dependencies :PROPERTIES: :ID: deps :END: - ~tmux~ (for ~repos~ / ~sessions~) - One launcher: ~dmenu~ or ~rofi~ - A terminal (~st~ by default; configurable) - ~xdg-open~ (only if you later want to open URLs via system handler) * Setup & Conventions :PROPERTIES: :ID: setup :END: - Terminal is configurable via ~terminal="st"~ (or honor ~$TERMINAL~). - Default repos directory is ~$HOME/repos~; change with ~repos_dir="$HOME/dev"~ or set ~$REPOS_DIR~. - Bookmark files live at: - Personal: =~/.config/bookmarks/personal.txt= - Work: =~/.config/bookmarks/work.txt= Each file is one *URL per line*. (Optionally, lines may be ~labelurl~; the script will use the URL part.) - Scripts are POSIX ~sh~. Mark them executable and put on ~$PATH~. #+begin_src sh chmod +x dmenu-*.sh rofi-*.sh # or keep them in this repo and call with absolute paths #+end_src * Find Repos This reads your repos from ~/$REPOS_DIR~ (default ~$HOME/repos~), shows them in dmenu/rofi, and spawns a terminal that attaches to (or creates) a tmux session rooted at that repo. Below are the relevant sections of each script and where to change the variables according to your terminal, flags, repos directory, etc. ** dmenu-repos.sh :PROPERTIES: :ID: dmenu-repos :END: #+begin_src sh # --- config --- terminal="${TERMINAL:-st}" dmenu_flags='-i -c -bw 3 -W 600 -l 30 -h 40 -F -fn "JetBrainsMono Nerd Font:size=16" -p "Projects:"' repos_dir="${REPOS_DIR:-$HOME/repos}" #+end_src ** rofi-repos.sh #+begin_src sh # --- config --- terminal="${TERMINAL:-st}" rofi_flags='-dmenu -i -p "Projects:" -matching fuzzy -no-custom' repos_dir="${REPOS_DIR:-$HOME/repos}" #+end_src * TMUX Sessions List existing tmux sessions, attach to one, or create a new named session on the fly. ** dmenu-sessions.sh #+begin_src sh # --- config --- terminal="${TERMINAL:-st}" dmenu_flags='-i -c -l 15 -p "tmux:"' #+end_src ** rofi-sessions.sh #+begin_src sh # --- config --- terminal="${TERMINAL:-st}" rofi_flags='-dmenu -i -p "tmux:" -matching fuzzy -no-custom' #+end_src * Bookmarks (work/personal) Picks *which list* (Personal/Work), then shows bookmarks from the corresponding file and opens them in the matching browser. - Files: - Personal list: =~/.config/bookmarks/personal.txt= - Work list: =~/.config/bookmarks/work.txt= - Format: one *URL per line*. (Optional: ~labelurl~; the script will extract the URL.) ** dmenu-bookmarks.sh #+begin_src sh # --- config --- terminal="${TERMINAL:-st}" dmenu_flags='-i -c -l 20 -p "Bookmarks:"' # bookmark sources personal_file="${BOOKMARKS_PERSONAL_FILE:-$HOME/.config/bookmarks/personal.txt}" work_file="${BOOKMARKS_WORK_FILE:-$HOME/.config/bookmarks/work.txt}" # which browsers to use for each list personal_browser="${PERSONAL_BROWSER:-firefox}" work_browser="${WORK_BROWSER:-brave}" #+end_src ** rofi-bookmarks.sh #+begin_src sh # --- config --- terminal="${TERMINAL:-st}" rofi_flags='-dmenu -i -p "Bookmarks:" -matching fuzzy -no-custom' # bookmark sources personal_file="${BOOKMARKS_PERSONAL_FILE:-$HOME/.config/bookmarks/personal.txt}" work_file="${BOOKMARKS_WORK_FILE:-$HOME/.config/bookmarks/work.txt}" # which browsers to use for each list personal_browser="${PERSONAL_BROWSER:-firefox}" work_browser="${WORK_BROWSER:-chromium}" #+end_src * Where to bind these (DWM / Qtile) :PROPERTIES: :ID: binds :END: ** DWM #+begin_src c // With Keychord Patch: &((Keychord){2, {{MODKEY, XK_f}, {0, XK_f}}, spawn, SHCMD("$HOME/.local/bin/dmenu-repos.sh")}), &((Keychord){2, {{MODKEY, XK_f}, {0, XK_s}}, spawn, SHCMD("$HOME/.local/bin/dmenu-sessions.sh")}), &((Keychord){2, {{MODKEY, XK_f}, {0, XK_b}}, spawn, SHCMD("$HOME/.local/bin/dmenu-bookmarks.sh")}), // Without Keychord Patch: { MODKEY, XK_p, spawn, SHCMD("$HOME/.local/bin/dmenu-repos.sh") }, { MODKEY, XK_s, spawn, SHCMD("$HOME/.local/bin/dmenu-sessions.sh") }, { MODKEY, XK_b, spawn, SHCMD("$HOME/.local/bin/dmenu-bookmarks.sh") }, #+end_src ** Qtile #+begin_src python from libqtile.config import Key, KeyChord from libqtile.lazy import lazy mod = "mod4" keys = [ # Single keys Key([mod], "p", lazy.spawn("dmenu-repos.sh"), desc="Repos (dmenu)"), Key([mod], "s", lazy.spawn("dmenu-sessions.sh"), desc="Sessions (dmenu)"), Key([mod], "b", lazy.spawn("dmenu-bookmarks.sh"), desc="Bookmarks (dmenu)"), # KeyChord leader on Mod+f KeyChord([mod], "f", [ Key([], "f", lazy.spawn("dmenu-repos.sh"), desc="Repos"), Key([], "s", lazy.spawn("dmenu-sessions.sh"), desc="Sessions"), Key([], "b", lazy.spawn("dmenu-bookmarks.sh"), desc="Bookmarks"), ], mode="DMENU"), ] #+end_src * Tips & Troubleshooting - **Repos don’t show up:** check ~repos_dir~ and ensure directories exist one level deep. - **tmux attach fails:** make sure tmux is installed; scripts create the session if missing. - **Bookmarks open in wrong browser:** set ~PERSONAL_BROWSER~ / ~WORK_BROWSER~ or edit the variables at the top of the bookmarks scripts. - **Rofi/Dmenu theming:** append your theme flags to ~rofi_flags~ / ~dmenu_flags~. * Support If these scripts save you time, you can support my work on Ko-fi: [[https://ko-fi.com/tonybtw][ko-fi.com/tonybtw]] Or check out my website: [[https://www.tonybtw.com][tonybtw]]