/amh

Small lua module for the Awesome Window Manager providing multi-host functionnalties

Primary LanguageLuaGNU General Public License v2.0GPL-2.0

Awesome Multi Host

This is a small lua module for the Awesome Window Manager. It provides multi-host capabilities such as

  • spawning arbitrary programs on multiple hosts;

  • starting synergy (or barrier a synergy fork) on multiple hosts given all possible host combinations;

    Synergy menu

  • starting mpv on a remote host (passing the URL from the clipboard for e.g.).

    Mpv menu

See the wiki for concrete usage examples.

Contributions

All contributions are welcome! I'm sure there are multiple ideas of programs that could fit in.

Dependencies

  • lua-socket;
  • penlight;
  • openssh-client, openssh-server: commands are started on hosts through the SSH protocol. It's assumed that you have your SSH keys setup on each hosts you aim to use with amh.
  • avahi-utils: hosts IPv4 ip addresses are dynamically resolved using avahi tools such as avahi-resolve-host-name.
  • lain: provides many useful functionalities and is most likely to be used by Awesome users. We use it for its menu iterator functionality which enables the user to iterate over choices interactively.

Author

Simon DĂ©saulniers (sim.desaulniers@gmail.com)