NAME

       xcwd - X current working directory

SYNOPSIS

       xcwd

DESCRIPTION

       xcwd  is  a  simple tool which prints the current working directory of the focused window.
       It's useful for launching applications directly into the same  directory  as  the  focused
       application—for instance, you might want to launch a new terminal in the same directory as
       your editor.  You can make this happen by binding something like

              urxvt -cd "$(xcwd)"

       to a keyboard shortcut within your window manager and then invoking that  shortcut  during
       editor usage.

EXIT STATUS

       xcwd  exits  with a nonzero status if it can't figure out the working directory associated
       with the currently focused window and $HOME is unset.  Otherwise, xcwd returns zero.

ENVIRONMENT

       If xcwd can't figure out the working  directory  associated  with  the  currently  focused
       window, it falls back on $HOME.

BUGS

       xcwd's  algorithm  fails  when  applied to most single-instance applications, applications
       with tabs, or terminal multiplexers.  lilyterm(1), screen(1), tmux(1), and  urxvtc(1)  are
       all known to fail.

SEE ALSO

       gnome-terminal(1), terminology(1), urxvt(1), xterm(1)

COPYRIGHT

       xcwd is copyright 2013 Adrien Schildknecht ⟨adrien+dev@schischi.me⟩.

       This  manual  page  is copyright 2013, 2015–2018 Benjamin Barenblat and licensed under the
       Apache License, Version 2.0.

                                            2018-03-06                                    XCWD(1)