Howe provides a replacement for MOTD. Its contents can be customised in order to provide relevant information about your system.
Use the releases to get the latest version for your platform. In case your platform isn't available, please open an issue or build from source.
After downloading:
- Place
howein your/binor/usr/local/bindirectory - Copy the default configuration to
/etc/howe/config.yml, editing it as you wish. - Backup your
/etc/update-motd.d - Backup your
/etc/update-motd.d - Backup your
/etc/update-motd.d - Remove all files from
/etc/update-motd.d - Create a new file,
/etc/update-motd.d/00-howe, with the following contents:
#!/bin/sh
/bin/howe # or /usr/local/bin/howe, or just howe, depending on how your system
# is configured- Ensure
/etc/update-motd.d/00-howeis executable
Howe contains several widgets that collects and processes system information
every time the utility is executed. Widgets can be configured through the
configuration file stored in /etc/howe/config.yml, which has the following
structure:
howe:
- type: widget-name-here
widget-options: here
- type: other-widget-name-here
more-options: here
[...]Banner displays an ASCII-Art (Figlet) using the output of a command or static text. Examples:
- type: banner
text: Howe
# Outputs a static text
# _ _
# | | | |
# | |__| | _____ _____
# | __ |/ _ \ \ /\ / / _ \
# | | | | (_) \ V V / __/
# |_| |_|\___/ \_/\_/ \___|
- type: banner
text: $(whoami)
# Outputs the output of the command:
# _
# | |
# _ __ ___ ___ | |_
# | '__/ _ \ / _ \| __|
# | | | (_) | (_) | |_
# |_| \___/ \___/ \__|banner also accepts custom colours and fonts through the font and color
parameters. Fonts passed without an extension will automatically receive a
.flf extension before lookup. Also, relative paths will be expanded using
/usr/share/howe as the base directory. Provide an absolute path if your fonts
are stored in another directory. When omitted, Howe will use a default, bundled
font.
Available colours are:
redgreenyellowbluemagentacyanwhiterainbow
- type: banner
text: Howe
font: bigmoney-ne
color: cyan
# /$$ /$$
# | $$ | $$
# | $$ | $$ /$$$$$$ /$$ /$$ /$$ /$$$$$$
# | $$$$$$$$ /$$__ $$| $$ | $$ | $$ /$$__ $$
# | $$__ $$| $$ \ $$| $$ | $$ | $$| $$$$$$$$
# | $$ | $$| $$ | $$| $$ | $$ | $$| $$_____/
# | $$ | $$| $$$$$$/| $$$$$/$$$$/| $$$$$$$
# |__/ |__/ \______/ \_____/\___/ \_______/Notice: Figlets will be wrapped at 80 columns.
Blank simply outputs a blank line. Example:
- type: print
text: Hello
- type: blank
- type: print
text: World
# Outputs:
# Hello
#
# WorldLists all or a range of disks. Example:
- type: disks
disks:
- '*'
# Placing a single disk named '*' will cause all mountpoints to be listed
# Filesystems Size Used Free Use%
# / 110G 9.9G 94G 10%
# [=================================================]
# /mnt/sdc 292G 64M 277G 1%
# [=================================================]
# /mnt/sdb 1.8T 373G 1.3T 22%
# [=================================================]
# /mnt/sdd 457G 33G 402G 8%
# [=================================================]
#Notice: The
'*'wildcard will cause all mountpoints to be listed, which, in a few cases, will show the same device more than once.
- type: disks
disks:
- '/dev/sda1'
- '/dev/sdb1'
- '/dev/sdc1'
# Providing paths for the devices makes Howe to list only provided devices:
# Filesystems Size Used Free Use%
# /dev/sda1 110G 8.2G 96G 8%
# [=================================]
# /dev/sdb1 1.8T 289G 1.4T 17%
# [=================================]
# /dev/sdc1 292G 16G 262G 6%
# [=================================]Protip: Mountpoints can also be used as disk names. Feel free to use
/,/boot, and any other mountpoint as the name of a disk, and Howe will automatically find and use information about the mapped disk, providing a better name.
Lists status of provided Docker containers. Examples:
- type: docker
containers:
- plex
# Outputs all listed containers:
# Docker:
# plex: Running, Up 2 hours (healthy)This widget also allows regexes to be used as the container name, through the
regexp: prefix:
- type: docker
containers:
- regexp:^pl.{2}$
# Outputs containers whose names matches the provided regexp:
# Docker:
# plex: Running, Up 2 hours (healthy)Load displays current system load. It takes no arguments.
- type: load
# Outputs system load average:
# load average: 0.01, 0.03, 0.00Much like banner, but more discreet.
- type: print
text: Howe
# Outputs a static text
# Howe
- type: print
text: $(whoami)
# Outputs the output of the command:
# root
# Command and variable expansions are available and can be mixed with text:
- type: print
text: Logged in as $(whoami) @ $(hostname), running $SHELL
# Prints the provided text, replacing commands wrapped in `$()` with their
# outputs, and environment variables prefixed with `$` with their value.
# Missing variables are replaced with an empty string, but an invalid command
# or a command that returns an error will cause Howe to halt processing the
# rest of your widgets.Displays status of provided systemd units.
- type: systemd-services
services:
- docker
- transmission-daemon
# Outputs the status of each provided unit:
# Services:
# docker: Running
# transmission-daemon: RunningOn Debian systems, attempts to provide the number of available updates. It takes no arguments.
- type: updates
# Outputs a brief description about available updates for your system.
# 9 updates availableDisplays the uptime of the system. Takes no arguments.
- type: uptime
# Outputs for how long the system is up:
# up 2 hours, 40 minutesIn order to not clobber the output, Howe may indicate problems such as "Could not read disk information" instead of showing a detailed error. In those cases, Howe will output the error to the system's syslog, when such feature is available. In case anything goes awry, do not panic and open an issue
Bug reports and pull requests are welcome on GitHub at https://github.com/victorgama/howe. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
Everyone interacting in the Howe project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.
Howe was a private project that after a update, inherited styles and ideas from panda-motd, a Ruby MOTD generator licensed under the MIT license.
Howe was built using the following awesome Open Source projects:
| Name | License |
|---|---|
| cloudfoundry/gosigar | Apache 2.0 |
| coreos/go-systemd | Apache 2.0 |
| fatih/color | MIT |
| fsouza/go-dockerclient | BSD-2-Clause |
| lukesampson/figlet | BSD-3-Clause |
| go-yaml/yaml | Apache 2.0 |
| hashicorp/go-syslog | MIT |
| arsham/rainbow | Apache 2.0 |
The MIT License (MIT)
Copyright (c) 2018 Victor Gama
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.