Awesome
Viddy
<p align="center"> <img src="images/logo.png" width="200" alt="viddy" title="viddy" /> </p>Modern watch command.
Viddy well, gopher. Viddy well.
Demo
<p align="center"> <img src="images/demo.gif" width="100%" alt="viddy" title="viddy" /> </p>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.
- Look back history.
- Save and load history.
- See output in pager.
- Vim like keymaps.
- Search text.
- Suspend and restart execution.
- Support shell alias
- Customize keymappings.
- Customize color.
Install
Cargo
cargo install viddy
Homebrew
brew install viddy
Linux
wget -O viddy.tar.gz https://github.com/sachaos/viddy/releases/download/v1.3.0/viddy-v1.3.0-linux-x86_64.tar.gz && tar xvf viddy.tar.gz && mv viddy /usr/local/bin
Other
Download from release page.
Install with Other Package Managers (Community-Maintained)
MacPorts
sudo port install viddy
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
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
Keymaps
| key | |
|---|---|
| SPACE | Toggle time machine mode |
| s | Toggle <ins>s</ins>uspend execution |
| b | Toggle ring terminal <ins>b</ins>ell |
| d | Toggle <ins>d</ins>iff |
| t | Toggle header/<ins>t</ins>itle display |
| ? | Toggle help view |
| / | Search text |
| j | Pager: next line |
| k | Pager: previous line |
| h | Pager: move left |
| l | Pager: move right |
| 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
Viddy can be used without any configuration. However, if you want to customize the keybindings or default behavior, you can do so.
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 = ""
skip_empty_diffs = false
disable_mouse = true
[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"
scroll_left = "h"
scroll_right = "l"
scroll_up = "k"
scroll_down = "j"
scroll_half_page_up = "Ctrl-u"
scroll_half_page_down = "Ctrl-d"
scroll_page_up = "Ctrl-b"
scroll_page_down = "Ctrl-f"
scroll_bottom_of_page = "Shift-g"
scroll_top_of_page = "g g"
[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.