viddy-go

viddy-go

An interactive watch command.

Viddy well, gopher. Viddy well.

Fork notice

This is a fork of the last Go commit of sachaos/viddy before it was ported to Rust. You should use the Rust version of Viddy by default. The Rust version is more stable and better maintained. Use viddy-go when you want to take advantage of the Go toolchain for cross-compilation or want a specific feature like --pty.

Features

• Basic features of the original watch command:
  • Execute a command periodically and display its result.
  • Colorized output.
  • Diff highlighting.
• Time machine mode:
  • Rewind like a video.
  • Go to the past and back to the future.
• View output in a pager.
• Vim-like keymaps.
• Search for text.
• Suspend and restart execution.
• Force commands to run at precise intervals.
• Shell alias support.
• Customizable key mappings.
• Customizable colors.

Requirements

• Go 1.24 or later

Install

Go

go install dbohdan.com/viddy-go@latest

Other

Download binaries from the release page.

Keymap

Note: these are the default key bindings. They can be customized via the configuration file.

Configuration

Create your config file at $XDG_CONFIG_HOME/viddy-go/config.toml. On macOS, the path is ~/Library/Application Support/viddy-go/config.toml. On Windows, the path is %APPDATA%\viddy-go\config.toml.

[general]
no_shell = false
shell = "zsh"
shell_options = ""
skip_empty_diffs = false

[keymap]
timemachine_go_to_past = "Down"
timemachine_go_to_more_past = "Shift-Down"
timemachine_go_to_future = "Up"
timemachine_go_to_more_future = "Shift-Up"
timemachine_go_to_now = "Ctrl-Shift-Up"
timemachine_go_to_oldest = "Ctrl-Shift-Down"

[color]
background = "white"  # Default value uses terminal color.

What is "viddy"?

"Viddy" is a nadsat word meaning "to see". Nadsat is the fictional argot of teenage gangs in the dystopian novel and movie A Clockwork Orange.

Credits

The gopher logo for Viddy is licensed under the Creative Commons 3.0 Attribution license.

The original Go gopher was designed by Renée French.