Skip to content
This repository has been archived by the owner. It is now read-only.
A modern cssh replacement
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
EntryDialog.py
LICENSE
README.md
crussh.py

README.md

crussh: a modern cssh replacement

What are this?

For anyone who needs to administrate clusters of many machines, clusterssh has long been a fallback for when the rest of your automation tools aren't working.

crussh aims to be a simple replacement for cssh with the following improvements:

  • Uses a single window to hold multiple terminals.
  • Intelligently tiles terminals to fit available window size.
  • Scrolls available terminals when they don't all fit in-window.
  • Never resizes a terminal smaller than 80x24 characters.
  • Uses GTK and the VTE widget to provide modern, anti-aliased terminals.

Install

The install process is very simple on most distros:

  • Install python3 and python3-gi.
  • Clone and symlink to your bin dir:
git clone https://github.com/nergdron/crussh.git
ln -s $(pwd)/crussh/crussh.py ~/bin/crussh

Run crussh HOST [HOST ...]

Examples

Basic usage is covered via the builtin help, which you can get by running crussh -h. This section covers some common use cases.

To connect to a list of hosts in a file:

crussh $(cat hostlist.txt)

To use a custom login name, public key, or other SSH client options:

crussh -l someuser -i ~/.ssh/myotherkey -- host [host ...]

To do something other than ssh, such as edit a bunch of files in parallel:

crussh -e nano *.txt

Usage Tips

Doing a clustered paste isn't completely obvious. The following methods will work, after making sure you're clicked into the text entry box at the bottom of the window:

  • middle click or shift-insert to paste the X11 selection buffer.
  • control-shift-v to paste the GTK/GNOME clipboard.

Bugs & To Do

To see current issues, report problems, and see plans for features, see the crussh GitHub issues page.

Copyright and License

crussh is copyright 2012-2019 by Tessa Nordgren tessa@sudo.ca.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see the GNU licenses page.

You can’t perform that action at this time.