The Wayback Machine - https://web.archive.org/web/20231104155106/https://github.com/sachaos/viddy
Skip to content

sachaos/viddy

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
October 15, 2023 10:53
September 19, 2021 15:34
October 15, 2023 10:53
August 15, 2021 22:00
October 15, 2023 16:35
October 15, 2023 16:23
June 25, 2022 11:04
June 25, 2022 11:04
October 15, 2023 16:23
October 15, 2023 16:23

Viddy

viddy

Modern watch command.

Viddy well, gopher. Viddy well.

Demo

viddy

Features

  • Basic features of original watch command.
    • Execute command periodically, and display the result.
    • color output.
    • diff highlight.
  • Time machine mode. 😎
    • Rewind like video.
    • Go to the past, and back to the future.
  • See output in pager.
  • Vim like keymaps.
  • Search text.
  • Suspend and restart execution.
  • Run command in precise intervals forcibly.
  • Support shell alias
  • Customize keymappings.
  • Customize color.

Install

Mac

Homebrew

brew install viddy

MacPorts

sudo port install viddy

Windows

Scoop

To install Viddy on Windows, first install the Scoop package manager, and then run the commands below.

NOTE: The git package is required in order to add additional Scoop "buckets".

scoop install git
scoop bucket add extras
scoop install extras/viddy

Linux

wget -O viddy.tar.gz https://github.com/sachaos/viddy/releases/download/v0.4.0/viddy_Linux_x86_64.tar.gz && tar xvf viddy.tar.gz && mv viddy /usr/local/bin

ArchLinux ( AUR )

yay -S viddy

Alternatively you can use the AUR Git repo directly

Alpine Linux

After enabling the community repository:

apk add viddy

asdf version manager

asdf plugin add viddy
asdf install viddy latest
asdf global viddy latest

Go

go install github.com/sachaos/viddy@latest

Other

Download from release page.

Keymaps

key
SPACE Toggle time machine mode
s Toggle suspend execution
b Toggle ring terminal bell
d Toggle diff
t Toggle header display
? Toggle help view
/ Search text
j Pager: next line
k Pager: previous line
Control-F Pager: page down
Control-B Pager: page up
g Pager: go to top of page
Shift-G Pager: go to bottom of page
Shift-J (Time machine mode) Go to the past
Shift-K (Time machine mode) Back to the future
Shift-F (Time machine mode) Go to more past
Shift-B (Time machine mode) Back to more future
Shift-O (Time machine mode) Go to oldest position
Shift-N (Time machine mode) Go to current position

Configuration

Install your config file on $XDG_CONFIG_HOME/viddy.toml On macOS, the path is ~/Library/Application\ Support/viddy.toml.

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

[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 is inherit from terminal color.

What is "viddy" ?

"viddy" is Nadsat word meaning to see. Nadsat is fictional argot of gangs in the violent book and movie "A Clockwork Orange".

Credits

The gopher's logo of viddy is licensed under the Creative Commons 3.0 Attributions license.

The original Go gopher was designed by Renee French.