by schischi

schischi / xcwd

A simple tool that prints the current working directory of the currently focused window

214 Stars 23 Forks Last release: 3 months ago (v1.0) Other 45 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

xcwd - X current working directory

xcwd is a simple tool that prints the current working directory of the currently focused window.

The main goal is to launch applications directly into the same directory as the focused applications. This is especially useful to open a new terminal or a file explorer.


This program is basically a hack, but it works well with my setup and I hope it will work for you as well :)

This script can't retrieve the working directory of a "single instance application" nor terminal multiplexer, e.g.: - tmux, screen - lilyterm - konsole - urxvtc with urxvtd - applications with tabs

The application works with the following terminals: - urxvt - xterm - gnome terminal - terminology

How it works

  • Get the handle of the focused window;
  • Try to get the PID of the program using the window's attributes:
    • If
      is set, xcwd just reads the value;
    • Otherwise it reads the
      and compares it to the name of all the running processes;
  • Find the deepest child process;
  • Print the working directory of this process to stdout.

If one of these steps fail, xcwd prints the content of the



  • Linux, FreeBSD or OpenBSD
  • libX11-dev


  • Clone this repository or download as ZIP
  • make
  • make install
    on OpenBSD.

Running xwcd

Simply invoke the 'xcwd' command.

Examples: *

urxvt -cd "`xcwd`"
xterm -e "cd `xcwd` && /bin/zsh"
gnome-terminal --working-directory="`xcwd`"
pcmanfm "`xcwd`"

i3 Configuration

  • bindsym $mod+Shift+Return exec
    urxvt -cd "`xcwd`"
  • bindsym $mod+Shift+Return exec
    cd "$(xcwd)" && exec xterm
  • bindsym $mod+Shift+Return exec
    gnome-terminal --working-directory="`xcwd`"
  • bindsym $mod+p exec
    pcmanfm "`xcwd`"

Awesome WM Configuration

awful.key({ modkey, "Shift" }, "Return", function () awful.util.spawn("sh -c 'termite -d \"$(xcwd)\"'") end,
          {description = "open a terminal on current path", group = "launcher"}),

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.